OkayTeacher
KO English 한국어 日本語 中文 हिन्दी বাংলা اردو Español Português Français Deutsch Русский العربية Bahasa Indonesia Tiếng Việt ไทย Türkçe

알림을 켜는 방법

이 브라우저 또는 주소에서는 알림을 사용할 수 없습니다. 지원되는 브라우저로 보안 연결된 SONUB 사이트에 접속해 주세요.

알림이 차단되어 있으면 브라우저 설정에서 허용해 주세요.

  1. 주소 표시줄 옆의 사이트 설정 또는 브라우저의 사이트 설정을 열고, 이 사이트의 알림을 허용으로 바꾸세요.
  2. 기기 설정에서 브라우저 알림을 허용하고 방해 금지 또는 집중 모드를 확인하세요.
  3. SONUB으로 돌아와 페이지를 새로고침한 뒤 벨을 눌러 알림을 켜세요.

iPhone 또는 iPad에서는 SONUB을 홈 화면에 추가하고 거기에서 연 뒤 알림을 허용하세요.
OpenAI

Codex — OpenAI 의 코딩 에이전트

Codex 를 설치해 프로젝트 폴더에서 첫 작업을 해 보고 네 단계 탭으로 실력을 올립니다. 먼저 필요한 것을 확인하고 내 컴퓨터에 맞는 설치 명령을 복사하세요.

고급 — 넓히기: config.toml·codex exec·MCP·스킬·훅

설정 파일과 프로필로 Codex 를 내 방식에 맞추고, codex exec 로 스크립트에 넣고, MCP 로 바깥 도구를 잇고, 반복하는 일은 스킬로 가르치고, 꼭 지킬 것은 훅으로 강제합니다.

config.toml 과 프로필 — 내 방식에 맞추기

의 설정은 ~/.codex/ 에 둡니다. 매번 붙이던 옵션을 여기에 적어 두면 기본값이 됩니다. 일마다 다른 설정은 파일로 나눕니다.

  • · model_reasoning_effort — 쓸 모델과 생각하는 정도
  • · sandbox_mode — 과 (중급에서 배운 값)
  • 프로필은 ~/.codex/<이름>.config.toml 파일입니다. codex -p <이름> 으로 고르면 그 파일의 값이 기본 설정 위에 얹힙니다(예전의 [profiles.x] 표는 이제 읽지 않습니다).
  • -c 키=값 으로 이번 실행에서만 바꿉니다(예: -c sandbox_workspace_write.network_access=true).
~/.codex/config.toml
model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "cached"
~/.codex/review.config.toml
# a profile: codex -p review
model_reasoning_effort = "xhigh"
sandbox_mode = "read-only"

codex -p review
codex -c sandbox_workspace_write.network_access=true

프로젝트에 .codex/config.toml 을 두면 그 프로젝트에서만 쓰는 설정이 됩니다 — 로 표시한 곳에서만 읽습니다.

codex exec — 대화 화면 없이 자동화

"…" 는 대화 화면 없이 일을 한 번 하고 끝납니다. 진행은 로, 마지막 답은 stdout 으로 나오므로 ·· 에 넣기 좋습니다.

  • 기본은 입니다. 파일을 고치게 하려면 --sandbox workspace-write 를 붙입니다.
  • --json 은 진행을 (JSONL)로, -o <파일> 은 마지막 답을 파일로, --output-schema <파일> 은 에 맞는 답을 받습니다.
  • 없이 실행하면 표준 입력이 프롬프트가 되고, 프롬프트와 함께 파이프로 넘기면 입력이 덧붙습니다.
  • 밖에서는 --skip-git-repo-check 가 필요합니다. codex exec resume --last 로 앞 실행을 이어 갑니다.
Terminal
# Ask once, print the answer (read-only by default)
codex exec "Summarize what changed in the last 5 commits"

# Allow edits inside this folder
codex exec --sandbox workspace-write "Fix the failing test in tests/cart.test.ts"

# Pipe input in
cat error.log | codex exec "Find the cause"

# For scripts: JSON events, the final answer in a file, a JSON Schema answer
codex exec --json "List the TODOs in src/" > events.jsonl
codex exec -o notes.md "Write release notes for this week"
codex exec --output-schema schema.json "Rate the test coverage of each file"

# Continue the last run
codex exec resume --last "Now add tests for it"

CI 에서는 CODEX_API_KEY 를 Codex 를 실행하는 단계에만 넘기세요. 다른 단계의 스크립트가 키를 보지 못하게 합니다.

MCP — 바깥 도구와 잇기

(Model Context Protocol)는 도구가 바깥 서비스( 관리···문서 도구)를 쓰게 하는 입니다. Codex 에 MCP 를 더하면 그 서버의 도구를 쓸 수 있고, 와 같은 서버를 그대로 쓸 수 있습니다.

  • codex mcp add <이름> -- <> — 에서 실행하는 서버(stdio)를 더합니다.
  • codex mcp add <이름> --url <주소> — 원격 서버()를 더합니다.
  • 더한 서버는 config.toml 의 [mcp_servers.<이름>] 표에 저장됩니다. 대화 중에는 /mcp 로 상태를 봅니다.
Terminal
# A server that runs on your computer (stdio)
codex mcp add playwright -- npx @playwright/mcp@latest

# A remote server (streamable HTTP)
codex mcp add notion --url https://mcp.notion.com/mcp

codex mcp list
~/.codex/config.toml
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
tool_timeout_sec = 60

믿을 수 있는 MCP 서버만 더하세요. 바깥 글을 읽어 오는 서버는 그 글에 숨은 지시()를 함께 들여올 수 있습니다.

에이전트 스킬 — 반복하는 일을 가르치기

은 가 든 폴더로, 클로드 코드와 같은 열린 형식입니다. Codex 는 평소에는 스킬의 이름과 설명만 알고 있다가, 일이 설명에 맞으면 본문을 읽어 따릅니다. 예전의 사용자 프롬프트(~/.codex/prompts)는 스킬로 바꾸라고 안내합니다.

  • .agents/skills/<이름>/SKILL.md 는 이 저장소, ~/.agents/skills/ 는 내 모든 프로젝트에서 씁니다.
  • $<스킬 이름> 으로 직접 부르거나 /skills 로 목록에서 고릅니다. 설명이 맞으면 알아서도 씁니다.
  • name 과 description 을 적고, 스크립트·참고 문서는 scripts/·references/ 에 둡니다.
  • 처음부터 들어 있는 에게 부탁하면 새 스킬을 함께 만들어 줍니다.
.agents/skills/release-notes/SKILL.md
---
name: release-notes
description: Write release notes from the git log. Use when the user asks for release notes or a changelog.
---

1. Find the last tag: `git describe --tags --abbrev=0`
2. Read the commits since then: `git log <tag>..HEAD --oneline`
3. Group them under Added / Fixed / Changed, in plain sentences.

훅 — 정해진 때 반드시 실행되는 명령

은 Codex 가 정해진 순간마다 반드시 실행하는 명령입니다. 의 부탁은 잊힐 수 있지만 훅은 매번 돕니다. 돌리기, 위험한 명령 막기, 끝나면 알림 받기에 씁니다.

  • ~/.codex/hooks.json(나) 또는 저장소의 .codex/hooks.json(프로젝트)에 둡니다.
  • ·PostToolUse(도구 앞뒤), UserPromptSubmit(부탁을 보낼 때), Stop(답을 마칠 때), SessionStart(세션을 시작할 때) 같은 때에 겁니다.
  • 로 걸 도구를 고르고, 명령이 2 로 끝나면 그 동작을 막습니다.
  • 알림만 필요하면 config.toml 의 notify 에 을 적습니다 — 차례가 끝날 때마다 을 받아 실행됩니다.

새 훅은 /hooks 에서 믿는다고 표시해야 돕니다. 남이 준 훅은 명령을 읽고 이해한 뒤에만 믿으세요.

고급 연습

  1. ~/.codex/config.toml 에 기본 승인·샌드박스를 적고, 읽기 전용 리뷰 프로필(review.config.toml)을 만들어 codex -p review 로 써 봅니다.
  2. codex exec -o 로 이번 주 을 요약해 파일로 받는 스크립트를 만듭니다.
  3. MCP 서버 하나를 더하고 /mcp 로 확인합니다.
  4. 자주 하는 일 하나를 .agents/skills/ 에 스킬로 만들고 $이름 으로 불러 봅니다.
  5. PostToolUse 훅으로 파일을 고칠 때마다 포매터가 돌게 하고, /hooks 에서 믿음을 표시합니다.

다섯 가지를 모두 해 봤다면 [마스터] 탭으로 넘어가세요.

공식 문서

2026-10-19 에 공식 문서로 확인했어요. 도구가 자주 바뀌니 명령이 안 되면 공식 문서를 보세요.

다음 걸음