Claude Code와 Codex에서 조립하는 법

Q: Claude Code에서 루프의 자동화는 무엇으로 구현하나요?

세션 안에서는 /loop (7일 만료, 세션당 50개), 응답 종료 시점의 검증은 Stop 훅(exit code 2로 계속), 세션 밖에서는 claude -p를 launchd나 크론, GitHub Actions가 부르는 방식입니다. 컴퓨터가 꺼져 있어도 돌아야 하면 Anthropic 관리 인프라의 Routines가 있습니다.

Q: 서브에이전트 정의 파일은 두 환경에서 어떻게 다른가요?

Claude Code는 .claude/agents/ .md 또는 ~/.claude/agents/ .md에 frontmatter(name, description 필수, tools, model, maxTurns, isolation, memory 선택)와 시스템 프롬프트 본문을 둡니다. Codex는 전문화된 에이전트에 위임하는 기능을 공식 문서에 명시하지만 정의 형식이 다르므로 Codex 문서에서 확인해야 합니다.

Q: 이 대응표는 언제 기준인가요?

2026년 8월 말, Claude Code 한국어 공식 문서와 우리 환경의 codex-cli 0.145.0 --help 출력 기준입니다. 최근 바뀐 항목이 여럿이므로 몇 달 뒤에는 다시 확인해야 합니다.

앞의 두 편에서 다룬 부품 여섯 가지를 두 도구의 실제 기능에 대응시킵니다. 우리는 Claude Code를 주 작업 도구로, Codex를 채점자와 교차 리뷰어로 쓰므로, 대응표는 "둘 중 하나를 고르라"가 아니라 "둘을 어느 자리에 놓느냐"의 표입니다. 다음 편은 안쪽 루프와 바깥쪽 루프입니다.

핵심 요약

여섯 요소 전부 두 도구에 대응물이 있지만 위치와 이름이 다르므로, 표를 외우기보다 문서를 여는 습관이 먼저입니다.
우리 구성은 제작·편집은 Claude Code, 채점·교차 리뷰는 codex exec이며 -o, --skip-git-repo-check, < /dev/null이 고정 형태입니다.
Windows는 네이티브 설치가 되지만 Bash 도구에는 Git for Windows가 권장되고 샌드박싱은 WSL 2에서만 됩니다.
사내 프록시는 HTTPS_PROXY와 NODE_EXTRA_CA_CERTS로, 폐쇄망은 허용 도메인 목록으로 대응합니다. 인터넷이 완전히 끊긴 환경에서는 두 도구 모두 동작하지 않습니다.

Claude Code와 Codex에서 조립하는 법

개념을 실제 도구로 떨어뜨린다

2026년 8월 말 공식 문서와 우리 환경(codex-cli 0.145.0)에서 확인한 것만 적었습니다.

요소	Claude Code	Codex
자동화	`/loop <간격> <프롬프트>`(7일 만료), `Stop` 훅(exit 2로 계속), `claude -p`(비대화형)	`codex exec '<프롬프트>'`, `codex exec resume`, `--ephemeral`
워크트리	`claude --worktree <이름>` → `.claude/worktrees/<이름>/`, 서브에이전트 `isolation: worktree`	`-C <디렉토리>`로 작업 루트 지정, 워크트리는 Git으로 직접 생성
스킬	`.claude/skills/<이름>/SKILL.md`, `/이름`으로 호출	AGENTS.md(`/init`으로 생성), `~/.codex/config.toml`
커넥터	MCP(`.mcp.json`), 내장 Bash·WebFetch	`-i <이미지>` 첨부, `-s read-only
서브에이전트	`.claude/agents/*.md`(`tools`, `model`, `maxTurns`)	조사 작업을 전문화된 에이전트에 위임(공식 문서 명시)
기억	CLAUDE.md, `.claude/rules/`, 자동 메모리 `~/.claude/projects/<project>/memory/`	AGENTS.md, `~/.codex/` 세션 파일

우리 자리 배치는 이렇습니다. launchd가 시각에 맞춰 claude -p나 스크립트를 부르고, 병렬 세션은 Claude 워크트리로 나누고, 절차는 Claude 스킬(codex-score-loop, deploy-mini)에 두며, 두 도구 공용 지침은 AGENTS.md에 쓰고 CLAUDE.md에서 @AGENTS.md로 가져옵니다. 채점 명령의 실제 형태는 스킬에 "반드시 이 형태로"라고 적혀 있습니다.

codex exec --skip-git-repo-check -o "$S/r7.md" \
  "<채점 프롬프트> @$S/shots/ref-s.png @$S/shots/mine-s.png" \
  < /dev/null >/dev/null 2>&1; cat "$S/r7.md"

--skip-git-repo-check는 스크래치 폴더처럼 Git 저장소가 아닌 곳에서도 실행하게 하고, -o는 마지막 메시지를 파일로 남겨 라운드 표를 만들게 합니다. < /dev/null은 문서에 없는 우리 실측 규칙입니다. Codex는 프롬프트 인자가 없거나 -이면 stdin에서 지시를 읽으므로, 백그라운드에서 stdin을 닫아 주지 않으면 대기 상태가 되어 세션이 멈춥니다. 이미지 첨부의 공식 옵션은 -i이고, 프롬프트 안 @경로 형태는 우리 환경에서 실측으로 검증한 것입니다.

Claude Code 쪽 비대화형 루프의 기본 형태는 claude -p "Run the test suite and fix any failures" --allowedTools "Bash,Read,Edit"입니다. CI에서 --bare를 붙이면 훅·스킬·MCP·CLAUDE.md 자동 검색을 건너뛰지만 OAuth를 읽지 않으므로 ANTHROPIC_API_KEY가 필요합니다. 우리는 로컬 개발을 MAX 구독으로 돌리므로 --bare 없이 --allowedTools로 범위만 좁힙니다.

사양은 바뀌니 최신 문서를 보자

위 표의 절반은 최근 몇 달 사이에 바뀐 것들입니다. /agents는 v2.1.198부터 대화형 마법사 대신 파일을 직접 편집하라는 안내만 출력하고, /loop의 예약 실행은 v2.1.196부터 disable-model-invocation: true가 붙은 스킬을 실행하지 않습니다. Codex는 우리 환경에서 8월 초 0.142.5였던 것이 지금 0.145.0입니다.

그래서 표를 외우라고 하지 않습니다. 명령이 예상과 다르게 동작하면 추측하지 말고 그 자리에서 문서를 엽니다. Claude Code는 https://code.claude.com/docs/ko/ 아래에 한국어 문서가 있고, Codex는 codex exec --help가 설치된 버전의 정확한 옵션을 보여 줍니다. 우리 전역 규칙의 최우선 항목 "지원 여부·요금·폐기 상태는 공식 소스를 먼저 확인한 뒤 말한다"는 CLI 폐기 여부를 추측으로 끌다 사용자가 직접 공식 블로그를 찾아온 사고가 계기였습니다.

국내 기업 환경에서 자주 걸리는 지점 세 가지입니다.

Windows. Claude Code는 Windows 10 1809 이상에서 네이티브로 설치됩니다(irm https://claude.ai/install.ps1 | iex). Git for Windows가 있으면 Bash 도구를, 없으면 PowerShell 도구를 씁니다. 샌드박싱은 WSL 2에서만 지원됩니다. 심볼릭 링크 생성에 관리자 권한이 필요하므로 AGENTS.md 연결은 링크 대신 @AGENTS.md 가져오기를 씁니다. Codex는 Windows용 바이너리와 WSL 문서를 제공합니다.
사내 프록시. HTTPS_PROXY=https://proxy.example.com:8080, 우회는 NO_PROXY, 사내 CA는 NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem입니다. SOCKS 프록시는 지원하지 않고, NTLM이나 Kerberos 인증 프록시는 LLM 게이트웨이를 앞에 두라는 것이 문서의 권고입니다.
폐쇄망. 시스템 요구사항에 "인터넷 연결 필수"가 명시되어 있어 완전 폐쇄망에서는 두 도구 모두 동작하지 않습니다. 부분 허용이 가능하면 api.anthropic.com, claude.ai, platform.claude.com, downloads.claude.ai 등 문서의 허용 목록을 방화벽에 등록하고, 모델 트래픽을 Bedrock, Vertex(Agent Platform), Foundry 같은 승인 게이트웨이로 보내는 구성이 대안입니다.

정리

여섯 요소는 두 도구 모두에 있습니다. Claude Code는 .claude/ 아래 파일 위치로, Codex는 명령 옵션과 AGENTS.md로 드러납니다.
채점·교차 리뷰는 codex exec이며 -o, --skip-git-repo-check, < /dev/null이 고정 형태입니다.
사양은 몇 달 단위로 바뀝니다. --help와 공식 문서를 그 자리에서 엽니다.
Windows는 네이티브 가능하되 샌드박싱은 WSL 2, 프록시는 환경 변수, 폐쇄망은 허용 목록 또는 게이트웨이입니다.

자주 묻는 질문

Claude Code에서 루프의 자동화는 무엇으로 구현하나요?

세션 안에서는 /loop <간격> <프롬프트>(7일 만료, 세션당 50개), 응답 종료 시점의 검증은 Stop 훅(exit code 2로 계속), 세션 밖에서는 claude -p를 launchd나 크론, GitHub Actions가 부르는 방식입니다. 컴퓨터가 꺼져 있어도 돌아야 하면 Anthropic 관리 인프라의 Routines가 있습니다.

서브에이전트 정의 파일은 두 환경에서 어떻게 다른가요?

Claude Code는 .claude/agents/<이름>.md 또는 ~/.claude/agents/<이름>.md에 frontmatter(name, description 필수, tools, model, maxTurns, isolation, memory 선택)와 시스템 프롬프트 본문을 둡니다. Codex는 전문화된 에이전트에 위임하는 기능을 공식 문서에 명시하지만 정의 형식이 다르므로 Codex 문서에서 확인해야 합니다.

이 대응표는 언제 기준인가요?

2026년 8월 말, Claude Code 한국어 공식 문서와 우리 환경의 codex-cli 0.145.0 --help 출력 기준입니다. 최근 바뀐 항목이 여럿이므로 몇 달 뒤에는 다시 확인해야 합니다.

Windows에서 병렬 루프를 돌릴 때 주의할 점은요?

Git for Windows를 설치해 Bash 도구를 쓰고, 샌드박싱이 필요하면 WSL 2를 씁니다. 심볼릭 링크에 관리자 권한이 필요하므로 AGENTS.md 연결은 @AGENTS.md 가져오기를 씁니다.

폐쇄망에서는 루프를 어떻게 구성하나요?

완전 폐쇄망에서는 구성할 수 없습니다. 공식 요구사항에 인터넷 연결이 필수로 적혀 있습니다. 부분 허용이 가능하면 문서의 허용 도메인 목록을 방화벽에 등록하고 HTTPS_PROXY와 NODE_EXTRA_CA_CERTS를 설정하며, 모델 트래픽은 Bedrock이나 Vertex, Foundry 같은 승인된 게이트웨이로 보냅니다.