박구조 · AI 실전 키트
박구조 키트 캐릭터가 인사하는 그림

Claude Code와 Codex를
한 팀으로 쓰는 세팅 5가지

글을 복사해서 붙여 넣으면 AI가 알아서 세팅합니다.

이 세팅, 혼자 말고 같이 해요오픈채팅방에서 같이 따라 하고 해 본 결과를 서로 보여 줍니다
오픈채팅방에서 같이 하기
C
Claude Code가 일합니다보조 AI 여러 개가 동시에
X
Codex가 검사합니다같은 규칙 파일을 읽고
→
다른 창이 이어받습니다"넘겨 줘" 한마디로
✓
나는 결과만 확인합니다위험한 지우기는 막아 둔 채로
  1. 1끝내기 전에 Codex가 한 번 검사합니다✓
  2. 2규칙 파일 하나를 두 AI가 같이 읽습니다✓
  3. 3여러 일을 동시에 맡깁니다✓
  4. 4Claude Code 창끼리 일을 넘겨받습니다✓
  5. 5자리를 비워도 자주 쓰는 지우기 명령은 막아 둡니다✓
준비물Claude Code, 그리고 Codex CLI(1번과 2번 세팅). Codex CLI는 OpenAI 공식 안내대로 설치하고, 터미널에서 codex login 으로 ChatGPT 계정에 로그인합니다.

세팅 1 / 5

1/5+1 팀원

끝내기 전에 Codex가 한 번 검사합니다

Claude Code가 파일을 고치고 "다 했어요"라고 하기 직전에, Codex가 먼저 훑어보고 틀린 곳을 짚어 줍니다.

전"다 했어요"를 듣고, 내가 열어서 틀린 곳을 찾습니다.

후Codex가 먼저 짚고, Claude Code가 고친 뒤 끝냅니다.

실제 화면입니다. 파일을 고치고 끝내려 하자 검사 장치가 막고, Codex가 검토한 뒤에 끝냅니다. 2배속이고, 촬영용 창이라 명령에 옵션이 하나(--ignore-user-config) 더 붙어 있습니다.
1

Codex가 준비됐는지 봅니다

터미널에 입력합니다. 로그인되어 있다는 글이 나오면 됩니다.

터미널에 입력
codex login status
2

Claude Code에 이 글을 붙여 넣습니다

AI가 작은 검사 장치(훅)를 만들어 내 설정에 넣습니다.

Claude Code에 붙여 넣기
# 출처: 박구조 parkgujo.com/kit/ai-team
Claude Code가 답을 끝내기 전에 Codex가 먼저 검사하게 만들어 줘.

1. 터미널에서 codex login status 로 Codex 가 설치되고 로그인되어 있는지 확인해 줘. 안 되어 있으면 "Codex 설치와 로그인이 필요하다"고 알려 주고 멈춰.
2. 이 컴퓨터에서 쓸 수 있는 언어(node 또는 python)로 작은 스크립트를 ~/.claude/hooks/ 폴더에 만들어 줘. 하는 일:
   - Stop 훅으로 실행된다. 입력 JSON 의 stop_hook_active 가 true 면 아무것도 하지 않고 끝낸다(무한 반복 방지).
   - 입력의 transcript_path 파일을 읽고, 마지막 사용자 메시지 이후에 Write·Edit 도구로 파일을 실제로 고쳤는지 본다.
   - 고쳤는데 그 뒤로 Bash 나 PowerShell 에서 codex exec 를 실행한 적이 없으면 아래 JSON 을 출력한다. reason 안의 (고친 파일)에는 고친 파일 경로를 넣는다.
     {"decision":"block","reason":"끝내기 전에 Codex 검토를 돌려라. 고친 파일 내용을 Codex 에 넘겨서 검토한다: Bash 는 cat (고친 파일) | codex exec --sandbox read-only --skip-git-repo-check \"넘겨준 파일 내용을 적대적으로 검토해. 틀린 점·빠진 것·위험만 근거와 함께 말해.\" / PowerShell 은 cat 대신 Get-Content -Raw (고친 파일). 답은 그대로 믿지 말고 맞는 지적만 고친 뒤 끝내라."}
   - 스크립트에 오류가 나면 아무것도 출력하지 않고 통과한다(일이 멈추지 않게).
3. 등록하기 전에 가짜 입력으로 스크립트를 한 번 실행해서 위 동작이 맞는지 확인해 줘.
4. 내 사용자 설정 파일(~/.claude/settings.json, 환경변수 CLAUDE_CONFIG_DIR 을 쓰면 그 폴더의 settings.json)의 hooks 에 이 스크립트를 Stop 훅으로 등록해 줘. 고치기 전에 날짜와 시각이 붙은 백업을 만들고, 다른 내용은 건드리지 마.
5. 저장한 뒤 JSON 문법이 맞는지 확인하고, 바꾼 부분만 보여 줘. 비밀번호·키는 화면에 출력하지 마.

설정 폴더를 고칠 때는 허용 창이 뜹니다. 내용을 보고 Yes 를 누르세요.

3

작동하는지 봅니다

창에 /hooks 를 치면 Stop 칸에 방금 만든 훅이 보입니다. 파일을 하나 고치는 일을 시켜 보고, 끝나기 직전에 Codex 검토가 돌면 성공입니다.

끝내려 하자 검사 장치가 막은 화면
끝내려는 순간 검사 장치가 막고 "Codex 검토를 돌려라"를 돌려준 화면입니다.
알아 둘 것
  • 검사 결과도 마지막에는 내가 한 번 봅니다. Codex의 지적이 다 맞지는 않습니다.
  • 검사를 한 번 돌리게 하는 장치입니다. 검사 결과까지 보증하지는 않습니다.
  • Write·Edit 도구로 고친 파일만 알아챕니다. 명령어나 보조 AI가 고친 파일은 놓칠 수 있습니다.
  • 파일 내용을 Codex에 직접 넘깁니다. 윈도우에서는 Codex 읽기 전용 모드가 기본 설정으로는 파일을 여는 명령을 막는 것을 제가 확인했습니다. 내용을 넘기면 이 설정과 상관없이 검토합니다.
  • 검사할 때마다 Codex 사용량이 조금씩 줄어듭니다.
  • 끄려면 설정 파일 hooks 의 Stop 칸에서 그 줄을 빼거나, 2단계 백업으로 되돌립니다.
다음: 2 규칙 하나 →

세팅 2 / 5

2/5+1 팀원

규칙 파일 하나를 두 AI가 같이 읽습니다

Claude Code는 CLAUDE.md 를, Codex는 AGENTS.md 를 읽습니다. 규칙은 AGENTS.md 한 곳에 두고, CLAUDE.md 에는 그 파일을 불러오는 한 줄만 남깁니다.

전두 파일을 따로 고치다 한쪽을 빠뜨립니다.

후AGENTS.md 한 곳만 고치면 둘 다 바뀝니다.

Claude Code에게 물었을 때Claude Code가 답한 규칙 제목
Codex에게 같은 걸 물었을 때Codex가 답한 규칙 제목
실제 화면입니다. 규칙은 AGENTS.md 한 파일에만 있는데, 두 AI가 같은 제목을 답합니다.
1

규칙을 한 파일로 합칩니다

규칙을 합칠 폴더에서 Claude Code를 켜고 붙여 넣습니다.

Claude Code에 붙여 넣기
# 출처: 박구조 parkgujo.com/kit/ai-team
이 폴더의 규칙 파일을 Claude Code와 Codex가 같이 읽게 하나로 합쳐 줘.

1. 이 폴더에 CLAUDE.md, .claude/CLAUDE.md, AGENTS.md, AGENTS.override.md 가 있는지 보고, 있는 파일은 고치기 전에 날짜와 시각이 붙은 백업을 각각 만들어 줘.
2. CLAUDE.md(와 .claude/CLAUDE.md)의 내용을 AGENTS.md 로 옮겨 줘. AGENTS.md 가 이미 있으면 겹치는 줄은 한 번만 남기고 합쳐 줘. 내용을 줄이거나 바꾸지 마. 서로 반대되는 규칙이 있으면 합치지 말고 나에게 물어.
   AGENTS.override.md 가 있으면 Codex 는 그 파일을 먼저 읽으니, 지우지 말고 있다는 것만 알려 줘.
3. CLAUDE.md 에는 @AGENTS.md 한 줄만 남겨 줘. Claude Code 가 이 줄로 AGENTS.md 를 불러와.
4. 위쪽 폴더의 AGENTS.md 까지 합친 크기가 32KB 를 넘으면 알려 줘. Codex 는 프로젝트의 AGENTS.md 를 다 합쳐 기본 32KB 까지만 읽어.
5. 끝나면 두 파일의 처음 다섯 줄만 보여 줘.
2

두 AI가 같은 규칙을 읽는지 봅니다

Claude Code에서는 /memory 를 치면 불러온 규칙 파일이 보입니다. Codex는 같은 폴더에서 켜고 물어봅니다.

Codex에 입력
지금 읽은 AGENTS.md 의 맨 위 제목 한 줄만 알려 줘.
알아 둘 것
  • 최신 Claude Code는 CLAUDE.md 가 없을 때 AGENTS.md 를 바로 읽기도 합니다. 버전과 상관없이 되게 @AGENTS.md 한 줄 방식을 씁니다.
  • Codex는 프로젝트 맨 위 폴더(보통 Git 저장소 맨 위)부터 지금 폴더까지 AGENTS.md 를 차례로 읽습니다.
  • 모든 폴더에 쓸 Codex 규칙은 ~/.codex/AGENTS.md 에 둡니다.
다음: 3 동시에 →

세팅 3 / 5

3/5+1 팀원

여러 일을 동시에 맡깁니다

서로 기다릴 필요가 없는 일은 한 번에 맡깁니다. 창 안에서 보조 AI를 여러 개 돌리고, 창도 여러 개 띄웁니다.

전하나 시키고, 끝날 때까지 기다립니다.

후여러 개를 한 번에 맡기고, 결과만 받습니다.

실제 화면입니다. 한 번 말하자 보조 AI 3개가 동시에 일하고, 결과가 한꺼번에 돌아옵니다.
1

창 하나에서 보조 AI를 여러 개 돌립니다

괄호 안을 내 일로 바꿔서 붙여 넣습니다. 결과는 요약만 돌아옵니다.

Claude Code에 붙여 넣기
# 출처: 박구조 parkgujo.com/kit/ai-team
아래 일들을 보조 에이전트로 나눠서 동시에 돌려 줘. 서로 기다리지 말고, 끝나면 각자 다섯 줄 요약으로만 가져와.
1. (첫 번째 조사)
2. (두 번째 조사)
3. (세 번째 조사)
같은 파일을 고치는 일은 동시에 하지 말고 하나씩 해 줘.

이미 돌고 있는 일은 Ctrl+B 를 눌러 뒤로 보내고, 그동안 다른 일을 시킵니다.

2

창을 여러 개 띄웁니다

터미널 창을 여러 개 열고 창마다 Claude Code를 켭니다. 창마다 다른 폴더나 다른 파일을 맡깁니다.

두 창이 같은 파일을 동시에 고치면 한쪽이 덮어씁니다. 창마다 맡을 파일을 나눕니다.

알아 둘 것
  • 보조 AI도 각자 사용량을 씁니다. 많이 띄울수록 한도가 빨리 줄어듭니다.
  • 창 하나에서 동시에 띄울 수 있는 보조 AI는 기본 20개입니다.
  • 너무 많이 띄우면 컴퓨터가 느려집니다. 저도 느려진 적이 있어서 필요한 만큼만 띄웁니다.
다음: 4 창 이어받기 →

세팅 4 / 5

4/5+1 팀원

Claude Code 창끼리 일을 넘겨받습니다

한 창에 "넘겨 줘"라고 말하면, 다른 창이 메시지를 받아 이어서 일합니다.

전결과를 복사해서 다른 창에 다시 설명합니다.

후한마디로 넘기고, 다른 창이 바로 이어 합니다.

실제 화면입니다. 한 창에 한 번 말하면, 다른 창이 받아서 이어서 일합니다.

이 기능은 Claude Code 창끼리만 됩니다. Codex 창으로는 메시지가 가지 않습니다.

  1. 0한 번만: /config 에서 "Messages from your other sessions" 를 accept 로 바꿉니다.
  2. 1두 창에 /rename 으로 이름을 붙입니다. 공백과 괄호는 넣지 않습니다.
  3. 2보내는 창에 "제작창에게 방금 정리한 내용을 알려 줘"처럼 말합니다.
  4. 3긴 내용은 파일로 저장하고, 파일 위치만 보냅니다.
복사할 글과 실제 화면 보기 (창끼리 인수인계 키트) 다음: 5 안전 →

세팅 5 / 5

5/5+1 팀원

자리를 비워도, 자주 쓰는 지우기 명령은 막아 둡니다

AI가 묻지 않고 끝까지 일하게 하고, 자주 쓰는 지우기 명령은 막아 둡니다.

전허용 창이 뜰 때마다 자리를 못 비웁니다.

후묻지 않고 끝까지 하고, 자주 쓰는 지우기 명령은 막힙니다.

실제 화면입니다. 같은 부탁인데, 세팅 전에는 허용 창에서 멈추고 세팅 후에는 끝까지 합니다.
  1. 1규칙 문서에 "묻지 말 것"을 넣습니다. 돈·되돌리기 어려운 데이터·바깥 연락만 묻게 합니다.
  2. 2Shift+Tab 으로 권한 모드를 고릅니다.
  3. 3금지 목록에 지우기 명령(rm 등)을 넣습니다.
  4. 4지우라고 해도 _archive 폴더로 옮기게 합니다.
  5. 5실수하면 Esc 두 번으로 되돌립니다. 명령어로 지운 파일은 이걸로 돌아오지 않습니다.
  6. 6지우기 명령을 실행 직전에 막는 훅을 겁니다.
지우기 명령이 막힌 화면
"has been denied" 가 보이면 금지 목록이 지우기 명령을 막은 것입니다.
복사할 글과 실제 화면 보기 (안전 세팅 키트)
엄지를 든 캐릭터

세팅 5가지를 다 봤어요

같이 해요

혼자 세팅하면 막힌 곳에서 멈추기 쉽습니다.
오픈채팅방에서 같이 따라 하고
해 본 결과를 서로 보여 줍니다.
우리 같이 해 볼까요?

새 키트는 오픈채팅방에 먼저 올립니다.

오픈채팅방에서 같이 하기
더 바라는 것, 더 궁금한 것이 있으세요?만족도 조사에 적어 주시면 다음 키트에 반영합니다. 1분이면 끝납니다만족도 조사 하기
박구조 · 공식 문서로 2026년 10월 11일에 확인했습니다.
Claude Code 훅 · CLAUDE.md 와 AGENTS.md · 보조 에이전트 · 창끼리 메시지 · 권한 · Codex AGENTS.md · Codex CLI