아래 문장을 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`을 실행하고 브라우저 로그인 단계에서 멈춰 줘. 프로젝트 파일은 고치지 마.
명령어로 직접 하기
Claude Code 채팅창에 한 줄씩 입력합니다. 붙여넣기 요청문과 같은 결과를 냅니다. /codex:setup 은 Codex가 없을 때 설치를 제안하고, 로그인이 안 됐으면 !codex login 으로 로그인하라고 안내합니다.
확인플러그인 설치 결과와 Codex 버전, 로그인 상태가 나옵니다. /reload-plugins 를 입력한 뒤 /codex:setup 을 입력하면 준비가 끝났는지 한 번 더 표시됩니다. 프로젝트 파일은 바뀌지 않습니다.
프로젝트 폴더에 규칙 파일이 하나만 있게 정리합니다. 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는 그것을 불러오는 형태로 바뀝니다. 내용이 겹치면 먼저 확인 질문이 나옵니다.
대괄호 네 곳만 바꿔 Claude Code 채팅창에 붙여넣습니다. 플러그인의 Codex 위임 도우미가 작업을 Codex에 넘기고, Codex가 프로젝트 폴더 안에서 파일을 고칩니다.
이 작업은 네가 직접 고치지 말고 Codex에 맡겨 줘. 오래 걸릴 것 같으면 백그라운드로 돌려 줘.
작업: [여기에 할 일]
바꿔도 되는 파일: [여기에 파일이나 폴더 경로]
지켜야 할 규칙: [여기에 프로젝트 규칙]
완료 조건: [여기에 확인할 결과]
명령어로 직접 하기
Claude Code 채팅창에 입력합니다. 모델을 적지 않으면 Codex 설정 파일(config.toml)의 기본 모델로 실행합니다. --background 를 붙이면 Claude Code와 계속 대화할 수 있고, 같은 저장소에서 다시 맡기면 이전 Codex 작업을 이어 갈지 묻습니다.
/codex:rescue --background [여기에 할 일과 바꿔도 되는 파일, 완료 조건]
/codex:rescue --model gpt-6-astra [어려운 작업]
/codex:rescue --model gpt-6-luna [반복이 많은 단순 작업]
확인Claude Code가 Codex 위임 도우미를 불러 작업을 넘기고, Codex의 답이 그대로 표시됩니다. 백그라운드로 넘겼다면 작업 번호가 나오고 Claude Code와 계속 대화할 수 있습니다.
Codex 작업이 끝나면 결과를 확인하고 Claude Code가 실제 변경을 다시 판정하게 합니다. Codex의 완료 보고만 보고 끝내지 않습니다.
방금 Codex에 맡긴 작업이 끝났는지 확인해 줘. 끝났으면 실제 `git diff`와 테스트 출력을 읽고, 내가 적은 완료 조건마다 통과 또는 미달로 판정해 줘. 바꿔도 된다고 한 범위 밖의 파일이 바뀌었거나 테스트가 실패하면 완료로 보고하지 마.
명령어로 직접 하기
Claude Code 채팅창에 입력합니다. /codex:status 는 진행 중이거나 끝난 Codex 작업 목록을, /codex:result 는 마지막 작업의 최종 답과 Codex 세션 번호를 보여 줍니다. 멈추려면 /codex:cancel 을 입력합니다.
/codex:status
/codex:result
확인바뀐 파일 목록, 테스트 결과와 완료 조건별 판정이 함께 나옵니다. 범위 밖 변경이나 실패가 있으면 그 항목이 미달로 표시됩니다.
중요한 변경은 Codex에 검토만 따로 요청합니다. 검토 명령은 읽기 전용이라 파일을 고치지 않고 지적만 돌려줍니다.
지금까지 바뀐 내용을 Codex에 읽기 전용으로 검토받고 싶어. 채팅창에 입력할 Codex 검토 명령을 알려 주고, 검토 결과가 나오면 지적마다 실제 파일에서 사실인지 확인해 사실인 항목만 고칠 목록으로 정리해 줘. 아직 파일은 고치지 마.
명령어로 직접 하기
Claude Code 채팅창에 입력합니다. /codex:review 는 커밋하지 않은 변경이나 기준 브랜치 대비 변경을 봅니다. /codex:adversarial-review 는 뒤에 적은 관점으로 설계와 가정을 따져 묻습니다. 두 명령 모두 파일을 바꾸지 않습니다.
/codex:review --background
/codex:review --base main
/codex:adversarial-review --background [의심되는 설계나 위험 영역]
확인입력할 검토 명령이 안내되고, 검토 결과가 나오면 지적이 사실과 확인 불가로 나뉩니다. 파일은 바뀌지 않습니다.
이 단계의 실제 화면
화면에서 확인할 것터미널에서 codex exec review로 받은 검토 화면입니다. 플러그인의 /codex:review 도 같은 Codex 검토를 돌려 지적만 돌려줍니다. Codex CLI · 2026-07-27
직접 해보기
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
내 상황에 맞춰
이 프로젝트의 [파일이나 폴더]에서 [할 일]을 Codex에 맡겨 줘. 바꿀 수 있는 범위는 [경로]이고, [지켜야 할 규칙]을 따라야 하며, [확인할 결과]가 모두 통과해야 완료야. Codex 작업이 끝나면 실제 diff와 테스트 출력으로 완료 조건을 하나씩 판정해 줘.
한 단계 더
같은 문제를 너와 Codex에 따로 풀게 하고 싶어. 먼저 Codex에 읽기 전용으로 [문제]의 해결안을 받아 오되, 네 의견은 Codex에 보여 주지 마. 그다음 네 해결안을 따로 만든 뒤 두 안을 비교해서 이 프로젝트 규칙에 더 맞는 쪽을 근거와 함께 판정하고, 좋은 부분만 합친 안을 제안해 줘. 파일은 고치지 마.
파일 한 개를 고치는 작은 작업을 대괄호 네 곳에 적고, Codex에 맡긴 뒤 Claude Code가 diff와 테스트 출력으로 완료 조건을 판정하게 합니다.
헷갈리기 쉬운 것
위임 도우미는 기본으로 파일을 고칠 수 있는 권한으로 Codex를 실행합니다. 고치지 않고 조사만 원하면 요청문에 「읽기 전용으로」라고 적습니다. /codex:setup --enable-review-gate 는 Claude가 답할 때마다 Codex 검토를 돌려 사용량을 빠르게 쓰므로, 지켜볼 수 있을 때만 켭니다. GPT-5.5는 2026-10-14에 종료되므로 config.toml이나 요청문에 gpt-5.5가 남아 있으면 바꿉니다. 모델 선택 가능 여부는 요금제와 로그인 방식에 따라 다르며, 오류가 나면 다른 모델로 몰래 바꾸지 않고 오류를 확인합니다.
왜 이렇게 작동하나요
한 사람이 작업하고 다른 사람이 검수할 때처럼, 계획·실행·검수를 서로 다른 단계로 나눕니다.
같은 폴더와 같은 규칙을 읽게 하면 도구마다 기준이 갈리는 일을 줄일 수 있습니다. 완료 조건을 넘기기 전에 적어야 돌아온 변경을 항목별로 판정할 수 있습니다.
더 알고 싶다면
왜 두 도구의 규칙 파일을 복사하지 않습니까?
복사본은 만든 날에만 같습니다. 이후 한쪽만 고쳐지는 순간 두 도구가 서로 다른 규칙으로 작업하고, 어느 쪽 결과가 맞는지 대조하는 일이 새로 생깁니다.
본문을 AGENTS.md 한 곳에 두고 CLAUDE.md 첫 줄에서 @AGENTS.md로 불러오면, 규칙 수정이 한 파일로 끝나고 두 도구가 항상 같은 판을 읽습니다.
공유가 실제로 되는지는 두 도구에 같은 질문을 보내 확인합니다. 규칙에서 지킬 항목 세 가지를 인용해 달라고 했을 때 같은 문장이 나오면 연결이 맞습니다.
왜 판단보다 실행을 넘깁니까?
반복 수정처럼 답이 정해진 일은 파일 범위와 완료 조건만 적으면 돌아온 결과를 항목별로 검수할 수 있습니다. 넘겨도 품질을 판정할 수단이 남습니다.
방향을 정하는 판단은 검수 기준 자체를 만드는 일이라, 넘기면 결과가 틀렸는지조차 알 수 없게 됩니다. 무엇을 만들지와 어긋난 요구를 좁히는 일은 결과를 책임지는 사람이 유지합니다.
안내문 40개의 날짜 표기를 한 형식으로 통일하는 일은 넘기기 좋은 일이고, 그 안내문의 톤을 어느 쪽으로 갈지 정하는 일은 직접 할 일입니다.
플러그인을 쓸 수 없을 때는 어떻게 넘깁니까?
플러그인은 이 컴퓨터에 설치된 Codex CLI와 로그인 상태를 그대로 씁니다. 회사 정책으로 플러그인 설치가 막혀 있으면 Claude Code에 `codex exec` 명령을 직접 실행하게 합니다.
이때는 요청문에 `codex exec --sandbox workspace-write "지시문" < /dev/null`을 적어 달라고 합니다. 끝의 `< /dev/null`이 없으면 Codex가 입력을 기다리며 멈출 수 있습니다.
플러그인과 달리 작업 목록, 결과 다시 보기, 이전 작업 이어 가기가 없으므로 결과는 그 자리에서 diff로 확인합니다.
새 상황에 적용
작은 수정 한 건 넘기기
파일 한 개의 반복 수정을 계획·실행·검수로 나누고 Codex에는 실행만 맡깁니다.
확인할 결과
지정한 파일만 바뀌고 Claude Code의 검수에서 완료 조건이 모두 통과합니다.
막혔을 때 확인할 순서
범위 밖 파일이 바뀌면 /codex:cancel 로 실행을 멈추고 diff에서 해당 변경을 분리합니다.
