01실습CodexClaude와 Codex 같이 쓰기Claude Code에서 Codex CLI를 확인하고, 두 도구가 같은 프로젝트 규칙을 읽는 상태에서 실행을 넘길 수 있습니다내용 열기내용 접기
가운데 규칙 파일 하나에 두 도구가 연결돼 같은 기준을 읽고 작업합니다
규칙 공유 · 실행 위임 · 교차 검토 순서로 진행합니다
두 도구가 같은 프로젝트에서 서로 다른 기준으로 파일을 고치면 정리할 것이 늘어납니다. 규칙을 맞추는 작업을 먼저 진행합니다.
규칙 공유 — 두 도구가 같은 문서를 읽게 맞춥니다.
실행 위임 — 판단은 한쪽에 두고 손이 많이 가는 일만 넘깁니다.
교차 검토 — 중요한 변경은 반대쪽에도 보여 검토받습니다.
규칙 본문은 한 곳에만 둡니다
Codex는 작업을 시작하기 전에 AGENTS.md를 읽습니다. 프로젝트 폴더의 루트부터 지금 작업하는 폴더까지 규칙을 모으고, 현재 폴더에 가까운 파일을 나중에 적용합니다. Claude Code는 CLAUDE.md를 읽습니다.
읽는 파일 이름이 다르더라도 규칙을 두 번 적지 않습니다. 저장소에 이미 AGENTS.md가 있으면 CLAUDE.md에서 그 파일을 불러오게 해 두 도구가 같은 지침을 읽도록 합니다.
CLAUDE.md 첫 줄에 @AGENTS.md를 넣습니다. Claude Code는 세션을 시작할 때 그 파일을 먼저 불러오고, 그 아래에 적은 Claude 전용 내용을 이어 붙입니다. 공통 규칙은 한 곳에서 고칩니다.
넘길 때는 판단이 아니라 실행을 넘깁니다
넘길 일과 직접 판단할 일을 나눕니다.
넘기기 좋은 일 — 정해진 형식으로 파일을 여러 개 만들기, 같은 수정을 반복 적용하기, 테스트 작성하기처럼 답이 정해진 작업입니다.
직접 판단할 일 — 무엇을 만들지 정하기, 어긋난 요구를 좁히기, 돌아온 결과가 기준에 맞는지 판정하기입니다.
넘길 때는 지시문에 바꿀 파일 범위, 지켜야 할 규칙, 완료 조건을 넣습니다. 이 셋이 없으면 돌아온 결과를 판정할 수 없습니다.
사용량이 두 계정으로 나뉩니다
Codex는 ChatGPT 계정, Claude Code는 Claude 계정의 사용량을 씁니다. 두 도구를 함께 쓰면 사용량과 구독도 각각 관리해야 합니다.
교차 검토는 서로의 답을 가린 채로 진행합니다
한쪽이 만든 결과를 다른 쪽에 검토시키면 놓친 항목을 찾을 수 있습니다. Codex 대화창에 /review를 입력하면 지적만 하고 파일은 건드리지 않습니다.
같은 문제에 대해 두 개의 독립된 의견이 필요할 때는 한쪽 답을 다른 쪽에 보여 주지 않습니다. 각자에게 따로 요청하고, 두 답을 받은 뒤 합칩니다.
검토 결과도 그대로 받아들이지 않습니다. 지적이 여러 건 나오면 각각 사실인지 직접 확인한 뒤 고칩니다. 위 화면에서는 두 번째 지적이 틀렸고 첫 번째 지적만 실제 문제였습니다. 검토 결과의 사실 여부는 사람이 판정합니다.
아래 문장을 Claude Code 채팅창에 붙여넣어 Codex 설치와 로그인 상태만 확인합니다. 이 단계에서는 파일을 고치거나 이미지를 만들지 않습니다.
이 컴퓨터에서 Codex CLI를 Claude Code의 두 번째 실행 도구로 쓰고 싶어. `codex --version`과 `codex login status`로 설치와 ChatGPT 로그인 상태를 확인해 줘. 설치되지 않았다면 OpenAI 공식 Codex 설치 문서를 먼저 확인한 뒤 설치해 줘. 로그인이 필요하면 `codex login`을 실행하고 브라우저 로그인 단계에서 멈춰 줘. 설치와 로그인 확인만 하고 프로젝트 파일은 고치지 마.
확인Codex 버전과 로그인 상태가 나오고, 설치나 로그인이 필요하면 다음 한 단계가 안내됩니다. 프로젝트 파일은 바뀌지 않습니다.
프로젝트 폴더에 규칙 파일이 하나만 있게 정리합니다. 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 양쪽에 같은 질문을 보내 답이 맞는지 확인합니다.
이 프로젝트의 규칙 파일에 적힌 내용 중, 네가 코드를 고칠 때 반드시 지켜야 하는 항목 세 가지를 그대로 인용해서 알려 줘.
확인규칙 파일에 실제로 적힌 문장 세 개가 인용됩니다. 두 도구에 같은 질문을 보냈을 때 같은 항목이 나오면 규칙이 공유된 것입니다.
판단은 Claude Code에 두고 실행을 Codex에 넘깁니다. 무엇을 어떻게 고칠지 계획을 먼저 세운 다음, 손이 많이 가는 부분만 넘깁니다.
지금 하려는 작업의 계획을 먼저 세워 줘. 그다음 그 계획을 다른 도구에게 그대로 전달할 수 있는 지시문 하나로 정리해 줘. 지시문에는 바꿀 파일 범위, 지켜야 할 규칙, 완료 조건을 넣어 줘. 지시문만 만들고 파일은 아직 고치지 마.
확인작업 계획과 함께, 파일 범위·규칙·완료 조건이 들어간 위임 지시문 한 덩어리가 나옵니다. 이 시점에는 파일이 바뀌지 않습니다.
정리한 지시문을 Codex에 넘겨 실행합니다. 대화창을 열지 않고 명령 한 줄로 맡기는 방식입니다.
명령어로 직접 하기
Claude Code가 프로젝트 폴더 안에서 이 명령을 실행할 수 있습니다. codex exec는 기본이 읽기 전용이라 파일을 고치게 하려면 --sandbox workspace-write를 붙입니다. 마지막의 `< /dev/null`은 입력 대기를 끝내 실행이 멈춰 있는 일을 막습니다.
Codex가 바꾼 내용을 Claude Code로 돌아와 검수합니다. 넘길 때 정한 완료 조건에 맞는지 확인합니다.
방금 다른 도구가 이 폴더의 파일을 고쳤어. 무엇이 바뀌었는지 diff로 확인하고, 내가 처음에 정한 완료 조건에 맞는지 항목별로 통과·미달로 판정해 줘. 미달이면 어디를 어떻게 고쳐야 하는지도 알려 줘.
확인바뀐 파일의 diff 요약과 함께, 완료 조건 항목마다 통과·미달 판정이 나옵니다.
이 단계의 실제 화면
화면에서 확인할 것실행을 넘긴 뒤 Claude Code에서 변경 내용과 완료 조건을 다시 확인합니다. Codex CLI · 2026-07-27
중요한 변경은 반대쪽에도 검토를 요청합니다. Codex의 리뷰 기능은 작업 트리를 건드리지 않고 지적만 합니다.
명령어로 직접 하기
일반 터미널에서 프로젝트 폴더 안으로 이동해 실행하면 대화창이 열립니다. 그곳에서 /review를 입력합니다. 어느 범위를 볼지 고르는 목록에서 커밋하지 않은 변경, 특정 커밋, 기준 브랜치 대비 가운데 하나를 고릅니다. 검토 결과만 나오고 파일은 바뀌지 않습니다.
codex
연습
손이 많이 가는 작업의 계획은 Claude Code에서 세우고 실행만 Codex에 넘깁니다. 돌아와서 diff로 검수하는 단계까지 진행합니다.
두 도구가 같은 규칙 파일을 읽는 상태를 만들고, 한 작업을 계획·실행·검수로 나눠 두 도구에 배분하면 통과합니다.
알아두면 좋습니다
규칙을 두 파일에 각각 복사해 두면 한쪽만 고쳐진 채로 두 도구가 다른 기준으로 작업합니다. 본문은 한 곳에만 두고 다른 쪽은 불러옵니다. 위임할 때 완료 조건을 빼면 돌아온 결과를 판정할 기준이 없으므로, 지시문에 파일 범위와 완료 조건을 넣습니다. 독립된 의견이 필요하면 한쪽 답을 다른 쪽에 보여 주지 않고 각자에게 따로 요청한 뒤 합칩니다.
예시 화면 Codex에 교차 검토를 요청한 화면입니다. 지적만 나오고 파일은 바뀌지 않습니다.
02실습CodexCodex에서 Claude 불러오기Codex에서 Claude Code를 읽기 전용으로 호출한 뒤 받은 세션 번호로 같은 대화를 이어서 검토를 맡길 수 있습니다내용 열기내용 접기
Codex가 Claude Code 명령을 실행합니다
Codex가 현재 컴퓨터의 Claude Code CLI를 실행해 Claude가 보낸 답과 세션 번호를 다시 가져옵니다. Claude 대화창은 별도로 열리지 않습니다.
방향
실행하는 곳
이어지는 기록
Claude에서 Codex 부르기
Claude Code가 codex exec를 실행합니다
Codex가 새로 만든 작업 기록
Codex에서 Claude 부르기
Codex가 claude --print를 실행합니다
Claude가 만든 session_id의 대화 기록
첫 검토는 읽기 전용으로 시작합니다
처음 연결을 확인할 때는 --restricted와 --permission-mode plan을 사용합니다. Claude는 파일을 읽고 의견을 낼 수 있지만 내용을 고치지 않습니다. 검토 결과가 필요한 작업에 수정 권한을 섞지 않으면 연결 확인과 실제 변경을 구분할 수 있습니다.
세션 번호가 있어야 같은 대화를 이어 갑니다
Claude Code는 --output-format json으로 실행하면 답과 함께 session_id를 돌려줍니다. 다음 호출에서 claude --resume 뒤에 이 번호를 넣으면 같은 Claude 대화를 이어서 질문할 수 있습니다.
Codex의 대화 내용이 자동으로 Claude에 들어가지는 않습니다. 첫 요청에 검토할 파일, 기준, 답의 형식을 적고 필요한 자료가 현재 폴더에 있는지 확인합니다.
Codex 채팅창에 아래 문장을 붙여넣어 Claude Code 설치와 로그인 상태를 확인합니다. 로그인 화면이 열리면 비밀번호와 인증은 직접 완료합니다.
이 컴퓨터에서 Claude Code를 사용할 수 있는지 `claude --version`으로 확인해 줘. 설치되지 않았다면 Claude Code 공식 설치 문서를 열어 이 운영체제에 맞는 설치 방법만 안내해 줘. 로그인이 필요하면 로그인 화면을 열고 멈춰 줘. 비밀번호나 인증 코드는 받지 말고, 파일도 고치지 마.
확인Claude Code 버전이 나오거나, 설치 또는 로그인을 마치기 위한 한 단계가 안내됩니다.
Codex가 Claude Code에 짧은 확인 질문을 보냅니다. 읽기 전용 옵션을 사용하고 결과와 세션 번호만 받게 합니다.
Claude Code에 읽기 전용 연결 확인을 맡겨 줘. 질문은 `Return exactly CLAUDE_FROM_CODEX_OK.`로 하고, `claude --print --output-format json --restricted --strict-mcp-config --permission-mode plan`을 사용해 표준 입력으로 전달해 줘. 파일은 고치지 말고, 실행 뒤 Claude가 보낸 result와 session_id만 알려 줘.
확인결과에 `CLAUDE_FROM_CODEX_OK`가 보이고 세션 번호가 함께 나옵니다. 둘 중 하나라도 없으면 연결 완료로 표시하지 않습니다.
방금 받은 세션 번호로 같은 Claude 대화를 한 번 더 이어 갑니다. Codex 대화와 Claude 대화가 각각 따로 저장된다는 점을 함께 확인합니다.
방금 Claude Code 실행에서 받은 session_id로 같은 대화를 이어 줘. `claude --resume`과 읽기 전용 옵션을 사용하고 `Return exactly CLAUDE_RESUME_OK.`를 보내 줘. 파일은 고치지 말고 결과만 알려 줘.
확인`CLAUDE_RESUME_OK`가 나오면 Claude 쪽 대화가 이어진 것입니다. Codex의 이전 대화 전체가 Claude로 옮겨진 것은 아닙니다.
실제 검토를 맡길 때는 질문만 보내지 않고 대상, 확인할 기준, 원하는 답의 형태를 함께 적습니다.
Claude Code에 읽기 전용 검토를 맡겨 줘. 대상은 [파일 또는 폴더]이고, [확인할 기준]을 기준으로 빠진 내용과 틀린 주장만 찾아 달라고 해 줘. 답은 `판정 / 근거 / 고칠 항목` 순서로 받으며 파일은 고치지 마. 받은 result와 session_id를 함께 알려 줘.
확인Claude의 판정과 근거가 나오고, 이어서 물을 수 있는 세션 번호가 남습니다.
Claude의 의견을 Codex가 직접 확인합니다. 파일과 공식 문서에서 다시 찾을 수 있는 근거만 남깁니다.
방금 Claude가 준 검토 결과를 항목별로 다시 확인해 줘. 현재 파일이나 공식 문서에서 근거를 찾을 수 있으면 통과, 찾지 못하면 확인 불가로 표시해 줘. 아직 파일은 고치지 마.
확인Claude의 의견이 통과와 확인 불가로 나뉘고, 근거가 있는 항목만 다음 수정 후보로 남습니다.
연습
작은 문서 한 개를 Claude에 읽기 전용으로 검토시킨 뒤, 같은 세션을 한 번 이어서 근거를 보강합니다.
첫 응답과 이어진 응답이 모두 나오고, 두 실행에서 같은 session_id를 사용했으며 파일 변경이 없으면 통과합니다.
알아두면 좋습니다
Claude와 Codex의 대화 기록은 자동으로 합쳐지지 않습니다. 첫 요청에 검토 대상과 기준을 함께 적습니다. 읽기 전용 검토에 파일 수정 권한을 주지 않으며, Claude의 답도 현재 파일과 공식 문서에서 다시 확인합니다.
03실습CodexCodex로 이미지 만들어 가져오기Codex에서 이미지를 만들어 내 프로젝트 폴더의 정해진 위치로 가져올 수 있습니다내용 열기내용 접기
만든 이미지를 프로젝트 폴더의 정해진 자리로 바로 옮깁니다
도구를 따로 열지 않고 폴더 안으로 바로 받습니다
자료에 삽화 한 장을 넣으려면 보통 이미지 도구를 열고, 만들고, 내려받고, 프로젝트 폴더로 옮기는 네 단계를 거칩니다. Codex에는 이미지 생성이 들어 있어서 이 과정을 요청 한 번으로 줄일 수 있습니다. 작업하던 폴더 안에서 요청하면 결과 파일이 그 폴더로 들어옵니다.
이미지 생성은 Codex를 사용할 수 있는 구독과 작업 공간에서 제공되며 일반 Codex 사용 한도에 포함됩니다. 품질과 크기에 따라 사용량이 더 빨리 줄 수 있으니, 여러 장이 필요할 때도 한 장으로 결을 먼저 확정합니다.
요청 문장에 세 가지를 넣습니다
같은 자료에 들어갈 그림들이 제각각으로 나오는 이유는 대개 요청 조건이 느슨하기 때문입니다. 세 가지를 문장에 넣습니다.
무엇이 보이는가 — 화면에 등장하는 대상과 배치입니다.
어떤 조건인가 — 배경색, 선의 굵기와 색, 채색 여부처럼 시각 방향을 정하는 항목입니다.
무엇을 넣지 않는가 — 글자, 색, 추가 소품처럼 들어오면 곤란한 항목입니다.
제외 조건을 빼면 요청하지 않은 요소가 들어올 수 있습니다.
저장 위치는 문장으로 지정하고 눈으로 확인합니다
요청할 때 저장할 폴더와 파일 이름을 함께 적습니다. 생성이 끝나면 그 경로에 파일이 실제로 있는지 확인합니다. 생성한 원본이 작업 폴더가 아닌 다른 위치에 먼저 저장되고 복사될 수 있으므로, 완료 메시지만으로 저장 위치를 판단하지 않습니다.
받은 파일은 해상도도 함께 확인합니다. 비율을 문장으로 지정해도 정확히 그 값으로 나오지 않을 수 있기 때문입니다. 슬라이드처럼 크기가 정해진 자리에 넣을 때는 받은 해상도를 보고, 어긋나면 다시 요청합니다.
참고할 그림을 함께 넘겨 시각 기준을 고정합니다
이미 만들어 둔 삽화가 있으면 그 파일을 함께 넘깁니다. 문장으로 시각 방향을 설명하는 것보다 예시 한 장을 보여 주는 편이 정확합니다. 여러 장으로 이루어진 자료를 만들 때는 첫 장을 기준으로 삼고, 나머지를 만들 때 그 파일을 계속 참고로 붙입니다.
결과는 사람이 판단합니다
만들어진 그림이 조건에 맞는지는 사람이 눈으로 확인합니다. 어긋난 부분이 있으면 처음부터 다시 만들기보다, 어느 항목이 어떻게 어긋났는지 짚어 그 부분만 고치도록 요청합니다. 조건을 하나씩 좁히면 같은 문장을 반복하는 횟수를 줄일 수 있습니다.
이미지를 넣을 자리부터 프로젝트 안 어느 폴더에 어떤 파일 이름으로 둘지 정하고 시작합니다. 저장 위치를 정하지 않으면 만든 파일을 다시 찾아야 합니다.
이 프로젝트에서 이미지 파일을 두는 폴더가 어디인지 찾아 줘. 기존 이미지들의 파일 이름 규칙도 함께 알려 줘.
확인이미지가 모여 있는 폴더 경로와, 기존 파일들이 따르는 이름 규칙이 나옵니다.
어떤 그림이 필요한지 문장으로 정리합니다. 무엇이 보이는지, 배경과 선은 어떤지, 넣지 말아야 할 것은 무엇인지까지 적습니다. 조건이 느슨하면 매번 다른 결과가 나옵니다.
이 자료에 넣을 삽화를 Codex에 요청하려고 해. 아래 내용을 설명하는 그림이 필요한데, 무엇이 보여야 하는지·배경과 선 조건·넣지 말아야 할 요소를 포함한 요청 문장을 만들어 줘. 우리 자료의 기존 삽화 결과에 맞춰 줘.
---
설명할 내용: [여기에 한 줄로]
확인보여야 할 대상, 배경·선 조건, 제외할 요소가 모두 들어간 요청 문장 하나가 나옵니다.
정리한 문장으로 Codex의 이미지 생성 스킬을 명시해서 요청합니다. 저장할 폴더와 파일 이름을 문장 안에 함께 적습니다.
명령어로 직접 하기
Claude Code가 프로젝트 폴더 안에서 이 명령을 실행할 수 있습니다. `$imagegen`은 Codex의 이미지 생성 기능을 분명히 부르는 이름입니다. 작은따옴표로 감싸면 셸이 `$imagegen`을 다른 값으로 바꾸지 않습니다.
codex exec --sandbox workspace-write '$imagegen 여기에 그림 설명을 적고, 결과를 ./_assets/generated/images/codex/approved-frame.png로 저장해 줘. 저장이 끝나면 파일 경로와 해상도를 알려 줘.' < /dev/null
참고할 그림이 있으면 함께 넘깁니다. 기존 삽화 한 장을 붙이면 시각 기준이 덜 흔들립니다.
명령어로 직접 하기
`--image` 뒤에 참고 이미지 경로를 적습니다. 여러 장을 넘길 때는 쉼표로 이어 붙이거나 `--image`를 반복합니다. 결과 파일이 지정한 위치에 생기면 성공입니다.
codex exec --sandbox workspace-write --image 참고이미지.png '$imagegen 이 그림과 같은 결로 [설명]을 만들고 ./_assets/generated/images/codex/approved-frame.png로 저장해 줘.' < /dev/null
파일이 지정한 위치에 생겼는지 확인합니다. 생성 완료 메시지와 실제 파일은 다를 수 있기 때문입니다.
방금 만든 이미지 파일이 [경로]에 실제로 있는지 확인해 줘. 있으면 해상도와 파일 크기를 알려 주고, 이 자료에 쓰기에 적절한지 판단해 줘.
확인파일 존재 여부와 함께 해상도·용량이 나오고, 자료에 쓰기 적절한지에 대한 판단이 붙습니다.
이 단계의 실제 화면
화면에서 확인할 것생성 메시지 뒤에 실제 파일을 열어 조건과 해상도를 확인합니다. Codex image generation · 2026-08-03
결과를 눈으로 보고 결정합니다. 조건에 어긋난 부분이 있으면 그 부분만 짚어 다시 요청합니다.
방금 받은 이미지를 열어서 확인해 줘. 처음에 정한 조건 중 지켜지지 않은 항목이 있으면 짚어 주고, 그 부분만 고치도록 다시 요청할 문장을 만들어 줘.
확인조건 대비 어긋난 항목이 짚이고, 그 부분만 수정하도록 요청하는 문장이 나옵니다.
연습
자료에 넣을 삽화 한 장을 실제로 만들어 프로젝트 폴더에 저장합니다. 생성 완료 메시지만 믿지 말고 파일이 그 자리에 있는지 확인합니다.
조건을 적은 문장으로 이미지를 만들고, 프로젝트 안 정해진 위치에 그 파일이 있는 것을 눈으로 확인했으면 통과입니다.
알아두면 좋습니다
만들었다는 답만 보고 넘어가면 파일이 작업 폴더가 아닌 다른 위치에 남아 있을 수 있습니다. 요청에 저장 경로와 파일 이름을 적고 실제 파일을 확인합니다. `$imagegen`을 큰따옴표 안에 넣으면 셸이 변수처럼 읽을 수 있으므로 전체 요청은 작은따옴표로 감쌉니다. 이미지 생성은 Codex의 일반 사용량을 텍스트 작업보다 빠르게 쓰므로 여러 장을 한꺼번에 만들지 않습니다.
