Codex
Claude와 Codex 같이 쓰기
Claude Code에 OpenAI 공식 Codex 플러그인을 설치하고, 채팅창에 「Codex에 맡겨 줘」라고 적어 작업을 넘긴 뒤 돌아온 변경을 같은 대화에서 검수할 수 있습니다
단계 1 / 5
아래 문장을 Claude Code 채팅창에 붙여넣어 OpenAI 공식 Codex 플러그인을 설치하고 준비 상태를 확인합니다
설치가 끝나면 채팅창에 /reload-plugins 를 입력해 새 명령을 불러옵니다.
Claude Code에서 Codex에 일을 맡기고 싶어. OpenAI 공식 Codex 플러그인을 설치해 줘. 터미널에서 `claude plugin marketplace add openai/codex-plugin-cc`와 `claude plugin install codex@openai-codex`를 차례로 실행하고, `codex --version`과 `codex login status`로 Codex 설치와 ChatGPT 로그인 상태를 확인해 줘. Codex가 없으면 설치 명령을 실행하기 전에 나에게 먼저 물어봐 줘. 로그인이 필요하면 `codex login`을 실행하고 브라우저 로그인 단계에서 멈춰 줘. 프로젝트 파일은 고치지 마.
플러그인 설치 결과와 Codex 버전, 로그인 상태가 나옵니다. /reload-plugins 를 입력한 뒤 /codex:setup 을 입력하면 준비가 끝났는지 한 번 더 표시됩니다. 프로젝트 파일은 바뀌지 않습니다.
명령어로 직접 하기
Claude Code 채팅창에 한 줄씩 입력합니다. 붙여넣기 요청문과 같은 결과를 냅니다. /codex:setup 은 Codex가 없을 때 설치를 제안하고, 로그인이 안 됐으면 !codex login 으로 로그인하라고 안내합니다.
/plugin marketplace add openai/codex-plugin-cc /plugin install codex@openai-codex /reload-plugins /codex:setup
단계 2 / 5
프로젝트 폴더에 규칙 파일이 하나만 있게 정리합니다
Codex는 AGENTS.md를 읽고 Claude Code는 CLAUDE.md를 읽으므로, 규칙 본문은 AGENTS.md에 두고 CLAUDE.md에서는 그 파일을 불러옵니다.
이 프로젝트에 AGENTS.md와 CLAUDE.md가 각각 있는지 확인해 줘. 규칙 본문은 AGENTS.md 한 곳에만 두고, CLAUDE.md에서는 @AGENTS.md 로 그 내용을 불러오도록 정리해 줘. 지금 두 파일에 내용이 겹쳐 있으면 어느 쪽을 남길지 먼저 물어봐 줘.
두 파일의 현재 상태가 정리돼 나오고, 규칙 본문이 AGENTS.md 한 곳으로 모이며 CLAUDE.md는 그것을 불러오는 형태로 바뀝니다. 내용이 겹치면 먼저 확인 질문이 나옵니다.
단계 3 / 5
대괄호 네 곳만 바꿔 Claude Code 채팅창에 붙여넣습니다
플러그인의 Codex 위임 도우미가 작업을 Codex에 넘기고, Codex가 프로젝트 폴더 안에서 파일을 고칩니다.
이 작업은 네가 직접 고치지 말고 Codex에 맡겨 줘. 오래 걸릴 것 같으면 백그라운드로 돌려 줘. 작업: [여기에 할 일] 바꿔도 되는 파일: [여기에 파일이나 폴더 경로] 지켜야 할 규칙: [여기에 프로젝트 규칙] 완료 조건: [여기에 확인할 결과]
Claude Code가 Codex 위임 도우미를 불러 작업을 넘기고, Codex의 답이 그대로 표시됩니다. 백그라운드로 넘겼다면 작업 번호가 나오고 Claude Code와 계속 대화할 수 있습니다.
명령어로 직접 하기
Claude Code 채팅창에 입력합니다. 모델을 적지 않으면 Codex 설정 파일(config.toml)의 기본 모델로 실행합니다. --background 를 붙이면 Claude Code와 계속 대화할 수 있고, 같은 저장소에서 다시 맡기면 이전 Codex 작업을 이어 갈지 묻습니다.
/codex:rescue --background [여기에 할 일과 바꿔도 되는 파일, 완료 조건] /codex:rescue --model gpt-6-astra [어려운 작업] /codex:rescue --model gpt-6-luna [반복이 많은 단순 작업]
단계 4 / 5
Codex 작업이 끝나면 결과를 확인하고 Claude Code가 실제 변경을 다시 판정하게 합니다
Codex의 완료 보고만 보고 끝내지 않습니다.
방금 Codex에 맡긴 작업이 끝났는지 확인해 줘. 끝났으면 실제 `git diff`와 테스트 출력을 읽고, 내가 적은 완료 조건마다 통과 또는 미달로 판정해 줘. 바꿔도 된다고 한 범위 밖의 파일이 바뀌었거나 테스트가 실패하면 완료로 보고하지 마.
바뀐 파일 목록, 테스트 결과와 완료 조건별 판정이 함께 나옵니다. 범위 밖 변경이나 실패가 있으면 그 항목이 미달로 표시됩니다.
명령어로 직접 하기
Claude Code 채팅창에 입력합니다. /codex:status 는 진행 중이거나 끝난 Codex 작업 목록을, /codex:result 는 마지막 작업의 최종 답과 Codex 세션 번호를 보여 줍니다. 멈추려면 /codex:cancel 을 입력합니다.
/codex:status /codex:result
단계 5 / 5
중요한 변경은 Codex에 검토만 따로 요청합니다
검토 명령은 읽기 전용이라 파일을 고치지 않고 지적만 돌려줍니다.
지금까지 바뀐 내용을 Codex에 읽기 전용으로 검토받고 싶어. 채팅창에 입력할 Codex 검토 명령을 알려 주고, 검토 결과가 나오면 지적마다 실제 파일에서 사실인지 확인해 사실인 항목만 고칠 목록으로 정리해 줘. 아직 파일은 고치지 마.
입력할 검토 명령이 안내되고, 검토 결과가 나오면 지적이 사실과 확인 불가로 나뉩니다. 파일은 바뀌지 않습니다.
명령어로 직접 하기
Claude Code 채팅창에 입력합니다. /codex:review 는 커밋하지 않은 변경이나 기준 브랜치 대비 변경을 봅니다. /codex:adversarial-review 는 뒤에 적은 관점으로 설계와 가정을 따져 묻습니다. 두 명령 모두 파일을 바꾸지 않습니다.
/codex:review --background /codex:review --base main /codex:adversarial-review --background [의심되는 설계나 위험 영역]