Codex — OpenAI 의 코딩 에이전트

무엇인가요

Codex 는 OpenAI 의 코딩 에이전트입니다. 터미널(Codex CLI), 코드 편집기 확장, ChatGPT 앱에서 작동합니다. codex cloud 로 클라우드 환경에 일을 맡기고 그 결과를 내 컴퓨터에 적용할 수도 있습니다.

프로젝트의 규칙은 AGENTS.md 에 적어 둡니다. AGENTS.md 는 여러 코딩 에이전트가 함께 읽는 열린 형식입니다. Codex 가 무엇을 해도 되는지는 /permissions 로 정합니다.

필요한 것

• 계정: ChatGPT 계정으로 로그인합니다(Plus·Pro·Business·Edu·Enterprise 요금제). API 키로도 로그인할 수 있지만 설정이 더 필요합니다.
• 컴퓨터: macOS·Linux(설치 스크립트) 또는 Windows(PowerShell 설치 스크립트). npm 이나 Homebrew 로도 설치합니다.
• 일할 프로젝트 폴더 — 바뀐 것을 모두 보고 되돌릴 수 있도록 Git 저장소면 좋습니다.

설치

macOS·Linux 는 첫 줄, Windows 는 PowerShell 줄을 실행하세요. 설치 스크립트로 설치했다면 같은 명령을 다시 실행해 업데이트합니다.

macOS · Linux

curl -fsSL https://chatgpt.com/codex/install.sh | sh 복사

Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" 복사

npm

npm install -g @openai/codex 복사

Homebrew

brew install --cask codex 복사

설치 확인

새 터미널 창을 여세요. codex --version 이 버전 번호를 보여 주면 됩니다. "command not found" 가 나오면 터미널을 다시 열고 PATH 를 확인하세요.

첫 실행 — 다섯 걸음

1. 프로젝트 폴더로 가서 codex 를 실행하고 "Sign in with ChatGPT" 로 로그인합니다.
2. "이 프로젝트에 대해 알려 줘" 하고 물어 프로젝트를 읽게 합니다.
3. /init 으로 AGENTS.md 를 만들고, 테스트 명령과 지킬 규칙을 적습니다.
4. /permissions 로 Codex 가 묻지 않고 해도 되는 일을 정합니다.
5. 파일·동작·확인 방법을 밝혀 일을 맡기고, diff 를 읽고 테스트를 직접 돌려 본 뒤 커밋합니다.

SONUB 에서 더 배우기

• Codex: OpenAI 의 코딩 에이전트
• 에이전트와 서브 에이전트: AI 가 한 단계씩 일하는 방법
• Goal 과 Ralph Loop: 정말 끝날 때까지 에이전트가 계속 일하게 하기
• 에이전트 스킬 — Codex 도 같은 SKILL.md 폴더를 씁니다

공식 문서

• OpenAI — Codex
• Codex CLI — GitHub
• AGENTS.md

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

AGENTS.md 제대로 쓰기

Codex 는 일을 시작할 때 AGENTS.md 를 읽습니다. 먼저 내 전역 파일(~/.codex/AGENTS.md)을 읽고, 프로젝트 맨 위(보통 Git 저장소 맨 위)부터 지금 폴더까지 내려오며 폴더마다 하나씩 찾아 차례로 이어 붙입니다. 지금 폴더에 가까운 파일이 뒤에 오므로 더 힘이 셉니다.

• ~/.codex/AGENTS.md — 내 모든 프로젝트에 쓰는 개인 지시
• 프로젝트 맨 위의 AGENTS.md — 팀이 함께 쓰는 지시(커밋)
• 하위 폴더의 AGENTS.md — 그 폴더에서 일할 때만 더해지는 지시
• AGENTS.override.md — 같은 폴더에 있으면 AGENTS.md 대신 이 파일을 읽습니다(잠깐 바꿔 볼 때).
• 합친 크기는 기본 32KiB(project_doc_max_bytes)까지만 읽습니다. 다른 이름의 파일을 쓰려면 project_doc_fallback_filenames 에 적습니다.

# AGENTS.md

## Setup
- Install: pnpm install
- Test: pnpm test
- Lint: pnpm lint

## Code style
- TypeScript strict mode, single quotes.
- Keep functions small. Add a test for every bug fix.

## Don't
- Don't edit generated files in dist/.
- Don't commit .env files.

~/.codex/AGENTS.md          ← you, every project (read first)
my-project/AGENTS.md        ← team rules (commit it)
my-project/web/AGENTS.md    ← only for web/ (read last, so it wins)

/init 은 프로젝트를 읽고 첫 AGENTS.md 를 만들어 줍니다. AGENTS.md 는 실행할 때 한 번 읽으므로, 고친 뒤에는 Codex 를 다시 시작하세요.

Claude Code 와 함께 쓰기 — 지시는 AGENTS.md 한 곳에

한 프로젝트에서 Codex 와 함께 Claude Code·Cursor·Gemini 같은 다른 AI 도 쓴다면, 도구마다 지시 파일을 따로 두면 금방 서로 달라집니다. AGENTS.md 는 여러 코딩 에이전트가 함께 읽는 열린 형식이라, 규칙을 AGENTS.md 한 곳에 적어 두면 모든 AI 가 같은 지시로 일합니다.

Claude Code 와 함께 쓸 때 가장 좋은 방법은 프로젝트에 CLAUDE.md 를 두지 않고 AGENTS.md 만 쓰는 것입니다. Claude Code 는 CLAUDE.md 가 없으면 AGENTS.md 를 읽고, 내 전역 ~/.claude/CLAUDE.md 도 그대로 읽습니다. 자세한 이유와 순서는 Claude Code 중급에 적었습니다.

1. 공통 규칙은 AGENTS.md 에만 씁니다.
2. 프로젝트 안에는 CLAUDE.md 를 두지 않습니다. 어느 한 폴더에서라도 CLAUDE.md 를 쓴다면 모든 폴더에 CLAUDE.md 를 두고, 각각 @AGENTS.md 한 줄만 적습니다.
3. 규칙을 바꿀 때는 AGENTS.md 만 고칩니다. 두 AI 가 함께 바뀐 규칙을 따릅니다.

~/.claude/CLAUDE.md   ← personal rules for Claude Code (still loaded)
~/.codex/AGENTS.md    ← personal rules for Codex

my-project/
└── AGENTS.md         ← the rules — Codex and Claude Code both read this
                        (no CLAUDE.md in the project)

• AGENTS.md 만 쓰는 법 — Claude Code 중급에서 자세히

승인과 샌드박스 — 어디까지 맡길지

Codex 는 두 가지로 안전을 지킵니다. 샌드박스는 기술적으로 할 수 있는 범위(파일 쓰기·네트워크)를, 승인 정책은 언제 나에게 물을지를 정합니다. 둘을 함께 정해야 합니다.

• read-only — 읽기만 하고 아무것도 바꾸지 않습니다. 처음 보는 프로젝트를 살펴볼 때 씁니다.
• workspace-write — 작업 폴더 안에서만 고치고 명령을 실행합니다. Git 저장소에서는 이것과 on-request 를 묶은 "Auto" 가 기본입니다. 네트워크는 기본으로 꺼져 있고 .git·.codex·.agents 는 쓰지 못합니다.
• danger-full-access — 샌드박스 없이 무엇이든 합니다. 격리된 컨테이너에서만 씁니다.
• 승인 정책(-a): on-request 는 샌드박스 밖이 필요할 때 묻고, never 는 묻지 않습니다(샌드박스 안에서만 일함).
• /permissions 로 대화 중에 모드를 바꾸고, /status 로 지금 설정을 봅니다.

codex --sandbox read-only                      # look only, change nothing
codex --sandbox workspace-write                # edit inside this folder ("Auto" in a Git repo)
codex -a never --sandbox workspace-write       # never ask, but stay inside the sandbox

approval_policy = "on-request"
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = false

예전 글의 --full-auto 는 이제 없습니다. 같은 뜻으로 --sandbox workspace-write 를 쓰세요. --yolo(--dangerously-bypass-approvals-and-sandbox)는 샌드박스와 승인을 모두 끄므로 격리된 곳에서만 씁니다.

대화 화면의 명령

Codex 대화 화면에서 / 를 입력하면 명령 목록이 뜹니다. 매일 쓰는 것부터 익히세요.

• /model — 모델과 생각하는 정도(reasoning effort)를 고릅니다.
• /diff — 이번 세션에서 바뀐 파일을 봅니다. /review — 바뀐 코드를 검토하게 합니다.
• /compact — 대화를 요약해 자리를 비웁니다. /new — 새 대화를 시작합니다.
• /resume — 지난 대화를 골라 이어 갑니다. 터미널에서는 codex resume, codex resume --last.
• /status — 모델·권한·작업 폴더 같은 지금 설정을 봅니다. /mcp — 연결된 MCP 서버를 봅니다.
• @ — 파일을 찾아 부탁에 붙입니다. $ — 스킬을 부릅니다. ! — 쉘 명령을 바로 실행합니다(!git status).
• -i 그림.png — 스크린샷을 붙여 시작합니다(대화 중에는 붙여 넣기). --search — 실시간 웹 검색을 켭니다.
• /init — AGENTS.md 를 만듭니다. /plan — 먼저 계획을 세우게 합니다.

Claude Code 를 쓰다 왔다면 /import 로 Claude Code 의 설정과 최근 대화를 가져올 수 있습니다.

잘 맡기는 법 — 어디·무엇·어떻게 확인

좋은 부탁에는 세 가지가 들어 있습니다: 어디(파일·폴더), 무엇(바라는 동작), 어떻게 확인할지(테스트·명령·화면). 셋이 분명할수록 Codex 가 덜 헤매고 결과를 스스로 확인합니다.

• 막연한 부탁: "장바구니 고쳐 줘"
• 또렷한 부탁: "@src/cart.ts 에서 수량이 0 이면 합계가 NaN 이 돼. 0 이면 그 상품을 빼게 고치고, tests/cart.test.ts 에 테스트를 더해 pnpm test 가 통과하는 것까지 확인해 줘."

• 큰 일은 "먼저 계획만 보여 줘"로 시작해, 계획을 고친 뒤 진행하게 합니다.
• 부탁보다 많이 바꾸면 멈추게 하고 git restore 로 되돌린 뒤, 파일 이름을 밝혀 다시 부탁합니다.
• 오류는 전체 출력을 붙여 넣습니다 — 요약보다 원문이 정확합니다.
• 끝나면 /diff 로 바뀐 것을 읽고, 테스트를 직접 돌려 본 뒤 커밋합니다.

중급 연습 — 내 프로젝트에서 해 보기

1. /init 으로 AGENTS.md 를 만들고 테스트 명령과 규칙 세 가지를 다듬습니다.
2. Claude Code 도 쓴다면 프로젝트에 CLAUDE.md 가 없는지 확인해, 두 AI 가 같은 AGENTS.md 를 읽게 합니다.
3. codex --sandbox read-only 로 프로젝트를 살펴보게 하고, 그다음 workspace-write 로 작은 수정을 맡깁니다.
4. /diff 와 /review 로 바뀐 것을 검토합니다.
5. /status 로 지금 설정을 보고, codex resume --last 로 대화를 이어 봅니다.

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

공식 문서

• Codex — AGENTS.md
• Codex — Approvals & security
• AGENTS.md

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

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

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

• model · model_reasoning_effort — 쓸 모델과 생각하는 정도
• approval_policy · sandbox_mode — 승인 정책과 샌드박스(중급에서 배운 값)
• 프로필은 ~/.codex/<이름>.config.toml 파일입니다. codex -p <이름> 으로 고르면 그 파일의 값이 기본 설정 위에 얹힙니다(예전의 [profiles.x] 표는 이제 읽지 않습니다).
• -c 키=값 으로 이번 실행에서만 바꿉니다(예: -c sandbox_workspace_write.network_access=true).

model_reasoning_effort = "high"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "cached"

# 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 — 대화 화면 없이 자동화

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

• 기본은 읽기 전용입니다. 파일을 고치게 하려면 --sandbox workspace-write 를 붙입니다.
• --json 은 진행을 JSON 줄(JSONL)로, -o <파일> 은 마지막 답을 파일로, --output-schema <파일> 은 JSON Schema 에 맞는 답을 받습니다.
• 프롬프트 없이 실행하면 표준 입력이 프롬프트가 되고, 프롬프트와 함께 파이프로 넘기면 입력이 덧붙습니다.
• Git 저장소 밖에서는 --skip-git-repo-check 가 필요합니다. codex exec resume --last 로 앞 실행을 이어 갑니다.

# 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 — 바깥 도구와 잇기

MCP(Model Context Protocol)는 AI 도구가 바깥 서비스(이슈 관리·데이터베이스·브라우저·문서 도구)를 쓰게 하는 열린 표준입니다. Codex 에 MCP 서버를 더하면 그 서버의 도구를 쓸 수 있고, Claude Code 와 같은 서버를 그대로 쓸 수 있습니다.

• codex mcp add <이름> -- <명령> — 내 컴퓨터에서 실행하는 서버(stdio)를 더합니다.
• codex mcp add <이름> --url <주소> — 원격 서버(streamable HTTP)를 더합니다.
• 더한 서버는 config.toml 의 [mcp_servers.<이름>] 표에 저장됩니다. 대화 중에는 /mcp 로 상태를 봅니다.

# 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

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
tool_timeout_sec = 60

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

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

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

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

---
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.

• 에이전트 스킬 알아보기 — 만들기·설치·SONUB 스킬

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

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

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

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

고급 연습

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

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

공식 문서

• Codex — Config reference
• Codex — Non-interactive mode
• Codex — MCP
• Codex — Skills
• Codex — Hooks

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

서브 에이전트 — 일을 나눠 맡기기

Codex 에게 서브 에이전트를 띄워 달라고 하면 조사·구현·검토를 나눠 동시에 진행합니다. 각자 자기 대화를 가지므로 메인 대화가 깨끗하게 유지됩니다.

• 처음부터 들어 있는 default·worker·explorer 가 있고, /subagents 로 서브 에이전트 사이를 오갑니다.
• 내 서브 에이전트는 .codex/agents/(프로젝트)나 ~/.codex/agents/(나)에 TOML 파일로 만듭니다 — name·description·developer_instructions.
• 서브 에이전트는 부모의 샌드박스와 승인 설정을 그대로 물려받습니다.
• "reviewer 로 지금 diff 를 검토하고, 그동안 worker 는 테스트를 써 줘" 처럼 역할을 나눠 부탁합니다.

name = "reviewer"
description = "Reviews diffs for bugs and missing tests. Read-only."
developer_instructions = """
Run git diff. List bugs with file and line, then missing tests.
Never edit files.
"""
model_reasoning_effort = "high"

Codex cloud — 클라우드에 일을 맡기기

codex cloud 는 OpenAI 의 클라우드 환경에서 일을 돌립니다. 내 컴퓨터를 쓰지 않으므로 여러 일을 동시에 맡기고, 끝난 결과만 골라 내 파일에 적용합니다.

• 먼저 ChatGPT 의 Codex 설정에서 환경(저장소·설치 스크립트·비밀값·인터넷 허용)을 만듭니다.
• codex cloud 로 일 목록을 보고 새 일을 시작합니다. codex cloud exec --env <환경 ID> "…" 로 바로 맡길 수도 있습니다.
• codex apply <일 ID> 는 클라우드에서 만든 변경을 내 저장소에 적용합니다(git apply).
• 같은 일을 여러 번 시도하게 해(--attempts) 가장 나은 결과를 고를 수 있습니다.

codex cloud                                   # see and start cloud tasks
codex cloud exec --env <ENV_ID> "Add input checks to the signup form"
codex cloud list
codex apply <TASK_ID>                         # apply the result to your files

GitHub — PR 에서 @codex review

GitHub 저장소를 Codex 에 연결하면 PR 댓글에 @codex review 라고 쓰는 것만으로 리뷰를 받습니다. GitHub Action(openai/codex-action)으로 PR 마다 자동으로 돌릴 수도 있습니다.

• @codex review — 그 PR 을 검토해 중요한 문제(P0·P1)만 남깁니다. Codex 설정에서 모든 PR 의 자동 리뷰를 켤 수 있습니다.
• 그 밖의 @codex … 댓글은 그 내용으로 클라우드 일을 시작합니다.
• openai/codex-action@v1 은 prompt 와 sandbox 를 받아 Codex 를 돌리고 마지막 답을 final-message 로 내놓습니다 — 다음 단계에서 댓글로 올리면 됩니다.
• 키는 저장소 비밀값(OPENAI_API_KEY)으로 넘기고, 읽기만 하는 리뷰는 sandbox 를 read-only 로 둡니다.

name: Codex review
on:
  pull_request:
jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
    steps:
      - uses: actions/checkout@v4
      - uses: openai/codex-action@v1
        id: codex
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          prompt: "Review this pull request. List bugs and missing tests."
          sandbox: read-only
      # the answer is in steps.codex.outputs.final-message

AGENTS.md 에 ## Code Review Rules 단락을 두면 Codex 의 PR 리뷰가 그 규칙을 따릅니다.

여러 AI 함께 쓰기 — 서로 검토하기

한 AI 가 쓴 코드를 다른 AI 가 검토하면 혼자서는 놓치는 문제가 잘 보입니다. AGENTS.md 로 같은 지시를 나눠 두었다면 Codex 와 Claude Code 를 한 프로젝트에서 번갈아 쓰기 쉽습니다.

역할을 나누는 것도 방법입니다. 한 AI 는 계획과 구현, 다른 AI 는 검토와 테스트를 맡고, 사람은 마지막 diff 를 읽고 합칠지 정합니다.

• codex review --uncommitted — 커밋하지 않은 변경을 Codex 가 검토합니다. --base <브랜치> 로 브랜치 전체도 됩니다.
• git diff | claude -p "…" — Codex 가 만든 변경을 Claude Code 가 검토합니다.
• 다른 AI 의 세션 안에서 codex exec 로 일 하나를 Codex 에게 넘길 수 있습니다(예: 테스트 쓰기, 그림 만들기).
• 두 AI 의 의견이 다르면 둘 다 근거(파일·줄·테스트 결과)를 대게 하고, 사람이 확인해 고릅니다.

# Claude Code wrote the change — Codex reviews it
codex review --uncommitted

# Codex wrote the change — Claude Code reviews it
git diff | claude -p "Review this diff. List bugs and missing tests."

# From inside another AI's session, hand one job to Codex
codex exec --sandbox workspace-write "Write unit tests for src/price.ts"

• AGENTS.md 만 쓰는 법 — Claude Code 중급에서 자세히

팀 설정 운영 — 같은 설정으로 함께

여러 사람과 여러 AI 가 같은 저장소에서 일하면 설정이 금방 쌓입니다. 무엇을 함께 쓰고 무엇을 나만 쓸지, 무엇을 부탁하고 무엇을 강제할지 나눠 둡니다.

• 함께 씀(커밋): AGENTS.md·.codex/config.toml·.codex/hooks.json·.codex/agents/·.agents/skills/
• 나만 씀(커밋 안 함): ~/.codex/config.toml·프로필 파일·~/.codex/AGENTS.md
• AGENTS.md 는 짧게 유지합니다. 같은 실수가 되풀이될 때만 규칙을 더하고, 틀린 규칙은 지웁니다.
• 꼭 지켜야 하는 것은 지시가 아니라 샌드박스·승인과 훅으로 강제합니다.
• CI 의 키는 Codex 를 실행하는 단계에만 넘기고, 리뷰는 read-only 로 돌립니다.

마스터 체크리스트

• AGENTS.md 에 공통 규칙 — Claude Code 같은 다른 AI 도 같은 지시로 일한다
• 샌드박스와 승인을 일에 맞게 고르고, 기본값은 config.toml 과 프로필에 적었다
• 반복하는 일은 스킬, 꼭 지킬 것은 훅, 바깥 도구는 MCP 로 잇는다
• codex exec 와 GitHub Action 으로 반복 작업을 자동화했다
• 큰 일은 서브 에이전트와 codex cloud 에 나눠 맡기고 결과만 골라 적용한다
• 다른 AI 와 서로 검토하고, 마지막 diff 와 테스트는 사람이 직접 확인한다

도구는 자주 바뀝니다. 명령이 안 되면 codex --help 와 공식 문서를 먼저 보세요. 예전 글의 옵션(--full-auto·[profiles.x])은 이미 바뀌었을 수 있습니다.

공식 문서

• Codex — Subagents
• Codex — Cloud
• Codex — GitHub
• Codex — GitHub Action

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