2026-10-01 공식 문서 기준으로 Claude Code와 Codex는 둘 다 터미널·IDE·웹에서 동작하는 에이전틱 코딩 도구입니다. 두 도구 모두 지침 파일, 스킬, 서브에이전트, 훅, MCP 연결을 공식 문서로 지원하므로 한쪽에 기능이 없어서 고르는 문제가 아닙니다. 선택 기준은 팀이 주로 일하는 자리, 이미 쓰고 있는 구독, 그리고 지침 파일 이름·위치와 승인 방식 같은 설정 스타일 중 무엇이 팀에 맞느냐입니다. LeanX는 두 도구를 모두 가르칩니다.
이런 상황에 맞아요
Claude Code와 Codex 중 무엇을 팀 표준으로 삼을지 정해야 하는 개발팀 구성원마다 다른 AI 코딩 에이전트를 써서 저장소 규칙과 검수 기준이 흩어진 팀 에이전트에게 맡길 권한 범위와 사람이 승인할 지점을 아직 정하지 못한 팀
다루는 범위
실행 환경, 지침 파일, 확장 체계, 권한·샌드박스, 병렬 작업, 요금 포함 형태 비교 공식 문서에 적힌 설정 방식과 운영 형태의 차이를 기준으로 한 도구 선택 규칙 두 도구를 함께 쓸 때의 저장소 규칙 파일과 승인 기준 설계 최근 변경 이력 중 팀 운영에 영향을 주는 변화
팀 상황 확인
이미 쓰는 구독, 저장소 구조, 팀이 주로 일하는 자리를 확인합니다.
규칙 파일 정리
AGENTS.md와 CLAUDE.md에 들어갈 공통 규칙과 도구별 규칙을 나누고, Claude Code의 AGENTS.md 읽기 설정을 확인합니다.
승인 기준 맞추기
권한 모드, 승인 정책, 샌드박스 설정을 팀의 검수 기준에 맞춥니다.
실제 과제 실습
팀 저장소의 실제 과제로 두 도구를 써 보고 검수 루틴을 정착시킵니다.
이런 팀이면 Claude Code
두 도구 모두 스킬·서브에이전트·훅·MCP를 지원하므로, 공식 문서에 적힌 설정 방식과 운영 형태의 차이를 기준으로 한 선택 규칙입니다. 성능 비교가 아닙니다. 서브에이전트를 .claude/agents/ 안의 마크다운 파일로 정의해, 역할 설명과 도구 권한을 문서처럼 읽고 고치고 싶은 팀 · 승인 단계를 권한 모드 전환으로 다루고 싶은 팀: plan으로 계획을 먼저 검토하고, 익숙해지면 acceptEdits나 auto mode로 바꾸는 방식 · auto mode처럼 별도 분류기 모델이 동작을 검토하는 승인 방식을 시작점으로 쓰고 싶은 팀 · 브라우저(claude.ai/code)에서 여러 세션을 병렬로 조율하고, 터미널·IDE·데스크톱 앱과 같은 엔진으로 오가고 싶은 팀 · 이미 Claude 유료 플랜을 쓰고 있는 팀 출처: Claude Code 개요, 서브에이전트, 권한 모드 문서 · Claude 요금 안내
이런 팀이면 Codex
공식 문서에 적힌 설정 방식과 운영 형태의 차이를 기준으로 한 선택 규칙입니다. Claude Code도 설정하거나 CLAUDE.md가 없으면 AGENTS.md를 읽으므로 AGENTS.md만으로 어느 한쪽이 정해지지는 않습니다. 별도 설정 없이 AGENTS.md를 기본 지침 파일로 쓰고, 전역 지침과 프로젝트 지침을 계층으로 합쳐 쓰고 싶은 팀 · 서브에이전트는 .codex/agents/의 TOML 파일로, 훅은 hooks.json이나 config.toml로 관리하는 설정 파일 중심 방식이 맞는 팀 · 스킬을 CLI에서 $로 명시 호출하거나 작업 설명에 맞춰 자동으로 고르게 하고 싶은 팀 · approval_policy와 sandbox_mode를 설정 값으로 고정하고, 네트워크가 꺼진 기본 상태에서 시작하고 싶은 팀 · 작업을 Codex Cloud 태스크로 넘겨 태스크마다 독립 워크스페이스에서, 컴퓨터가 잠자기 상태여도 진행시키고 싶은 팀 · 이미 ChatGPT 플랜을 쓰고 있거나 Free 플랜에서 먼저 시작하고 싶은 팀 출처: Codex 문서, AGENTS.md, 스킬, 훅, 서브에이전트, 승인·보안, Codex Cloud, 요금 문서 / Claude Code 메모리 문서
둘 다 쓰는 운영 방식 (LeanX 제안)
공식 문서의 기능 설명이 아니라 LeanX가 팀 교육·코칭에서 쓰는 운영 제안입니다. 한 사람이 두 도구를 모두 깊게 익히기보다 팀의 저장소 규칙 파일을 먼저 정합니다. 공통 규칙은 AGENTS.md에 두고, Claude Code에만 필요한 지침은 CLAUDE.md에 둡니다. · 이 구성은 Claude Code 설정이 함께 있어야 성립합니다. Claude Code는 기본값에서 CLAUDE.md가 있으면 AGENTS.md를 읽지 않으므로, /config의 Project instructions를 claude-md-and-agents-md로 바꾸거나 CLAUDE.md 안에서 @AGENTS.md를 임포트합니다. 둘 다 하지 않으면 CLAUDE.md만 읽습니다. · 승인·검수 지점을 같은 기준으로 맞춥니다. 어떤 변경은 사람이 승인한 뒤 진행하는지, 네트워크와 외부 쓰기는 언제 허용하는지, 병합 전에 어떤 테스트와 리뷰를 통과해야 하는지를 도구와 무관하게 한 문서로 정합니다. · 병렬 작업은 작업 단위마다 브랜치나 git 워크트리를 나눠 두 에이전트가 같은 파일을 동시에 고치지 않게 합니다. · 한 도구가 만든 변경은 다른 도구나 사람이 검토하도록 만드는 쪽과 검토하는 쪽을 분리합니다. 출처: Claude Code 메모리 문서, Codex AGENTS.md 문서(지침 파일 부분)
최근 90일 변화 요약
2026-10-01 기준 두 도구의 변경 이력에서 팀 운영에 영향을 주는 변화만 요약했습니다. 세부 버전과 날짜는 각 변경 이력에서 확인하세요. Claude Code: 긴 컨텍스트를 기본으로 지원하는 모델이 추가되었습니다. · Claude Code: auto mode가 터미널·VS Code 대화형 세션의 기본 시작 모드가 되었습니다. 기존 승인 기준을 다시 확인하세요. · Claude Code: 데스크톱 앱과 연결되는 claude --desktop 명령이 추가되었습니다. · Codex: 기본 모델이 바뀌고 새 모델 라인업이 추가되었습니다. · Codex: MCP 서버 연결의 OAuth·WebSocket 인증이 강화되었습니다. 출처: Claude Code 변경 이력, 모델 설정, 권한 모드 문서 / Codex 변경 이력 문서
현재 문서 기준 주의사항
2026-10-01 공식 문서에 적혀 있지만 변경 시점이 명시되지 않아 최근 변화 요약과 분리한 내용입니다. Codex: 승인 정책에서 untrusted 값을 더 이상 지원하지 않습니다. 변경 시점은 문서에 명시되어 있지 않으니 기존 설정 파일의 approval_policy 값을 점검하세요. 출처: Codex 승인·보안 문서
출처
Claude Code 개요 — https://code.claude.com/docs/en/overview (접속 2026-10-01); Claude Code 메모리(CLAUDE.md) 문서 — https://code.claude.com/docs/en/memory (접속 2026-10-01); Claude Code 서브에이전트 문서 — https://code.claude.com/docs/en/sub-agents (접속 2026-10-01); Claude Code 스킬 문서 — https://code.claude.com/docs/en/skills (접속 2026-10-01); Claude Code 훅 문서 — https://code.claude.com/docs/en/hooks (접속 2026-10-01); Claude Code MCP 문서 — https://code.claude.com/docs/en/mcp (접속 2026-10-01); Claude Code 권한 모드 문서 — https://code.claude.com/docs/en/permission-modes (접속 2026-10-01); Claude Code 비용 문서 — https://code.claude.com/docs/en/costs (접속 2026-10-01); Claude Code 변경 이력 — https://code.claude.com/docs/en/changelog (접속 2026-10-01); Claude Code Code Review 문서 — https://code.claude.com/docs/en/code-review (접속 2026-10-01); Claude Code 모델 설정 문서 — https://code.claude.com/docs/en/model-config (접속 2026-10-01); Claude Code 보안 문서 — https://code.claude.com/docs/en/security (접속 2026-10-01); Claude 요금 안내 — https://claude.com/pricing (접속 2026-10-01); Codex GitHub README — https://github.com/openai/codex (접속 2026-10-01); Codex 문서 — https://learn.chatgpt.com/docs (접속 2026-10-01); Codex 스킬 문서 — https://learn.chatgpt.com/docs/build-skills (접속 2026-10-01); Codex 훅 문서 — https://learn.chatgpt.com/docs/hooks (접속 2026-10-01); Codex 서브에이전트 문서 — https://learn.chatgpt.com/docs/agent-configuration/subagents (접속 2026-10-01); Codex MCP 문서 — https://learn.chatgpt.com/docs/extend/mcp (접속 2026-10-01); Codex 요금 문서 — https://learn.chatgpt.com/docs/pricing (접속 2026-10-01); Codex 변경 이력 — https://learn.chatgpt.com/docs/changelog (접속 2026-10-01); Codex AGENTS.md 문서 — https://learn.chatgpt.com/docs/agent-configuration/agents-md (접속 2026-10-01); Codex 승인·보안 문서 — https://learn.chatgpt.com/docs/agent-approvals-security (접속 2026-10-01); Codex Cloud 문서 — https://learn.chatgpt.com/docs/cloud (접속 2026-10-01)
자주 묻는 질문
Claude Code와 Codex는 구독에 포함되나요?
2026-10-01 공식 문서 기준으로 Claude Code는 Claude 유료 플랜에 포함되고 Free 플랜에는 포함되지 않습니다. Codex는 Free를 포함한 ChatGPT 플랜에 포함됩니다. API로 쓰면 Claude Code는 토큰 사용량 기준으로 과금되고, Codex는 API 키에 표준 API 요금이 적용됩니다. LeanX 경험상 포함되는 플랜 범위와 사용 한도는 자주 바뀌므로 도입 전에 각 요금 문서를 확인하세요.
CLAUDE.md와 AGENTS.md는 어떻게 다르고, 둘 다 써야 하나요?
Claude Code는 CLAUDE.md를 읽고, 기본값에서는 작업 디렉터리나 상위에 CLAUDE.md가 없을 때만 AGENTS.md를 읽습니다. 둘 다 읽게 하려면 /config에서 Project instructions를 claude-md-and-agents-md로 바꾸거나 CLAUDE.md 안에서 @AGENTS.md를 임포트합니다. Codex는 작업 전에 AGENTS.md를 읽고 전역 지침과 프로젝트 지침을 합칩니다. 두 도구를 함께 쓰는 팀이라면 공통 규칙은 AGENTS.md에, Claude Code에만 필요한 지침은 CLAUDE.md에 두고 위 설정 중 하나를 켜는 구성을 LeanX는 제안합니다.
승인 모드는 어떻게 다른가요?
Claude Code는 Manual 모드(설정값 default), acceptEdits, plan, auto 등 권한 모드로 승인 단계를 고르고, auto mode에서는 별도 분류기 모델이 동작을 검토합니다. 최근 버전에서는 터미널·VS Code 대화형 세션이 auto mode로 시작합니다. Codex는 approval_policy로 승인 시점을, sandbox_mode로 쓰기 범위를 정하며 네트워크는 기본으로 꺼져 있습니다. LeanX는 어느 쪽이든 사람이 승인할 작업을 팀이 먼저 정한 뒤 설정에 옮기는 순서를 제안합니다.
여러 작업을 동시에 맡길 수 있나요?
Claude Code는 서브에이전트가 각자 컨텍스트 창과 도구 권한을 갖고 작업을 나눠 맡고, 웹에서는 여러 세션을 병렬로 조율할 수 있습니다. Codex는 서브에이전트를 병렬로 실행해 결과를 모으고, Codex Cloud에서는 태스크마다 독립 워크스페이스를 만들어 컴퓨터가 잠자기 상태여도 작업을 이어 갑니다. LeanX 경험상 병렬 작업이 늘수록 결과를 검수하는 사람의 시간이 병목이 되므로 검수 기준을 함께 정하세요.
어느 쪽부터 배우는 게 좋나요?
두 도구 모두 지침 파일, 스킬, 서브에이전트, 훅, MCP를 지원하므로 LeanX는 기능 유무보다 이미 쓰는 구독과 팀이 일하는 방식을 기준으로 고르기를 제안합니다. Claude 유료 플랜을 쓰고 있거나 마크다운 정의와 권한 모드 전환이 편한 팀은 AX Study의 Claude Code 강의, ChatGPT 플랜(Free 포함)을 쓰고 있거나 설정 파일 중심 관리와 Codex Cloud 태스크가 맞는 팀은 Codex 강의부터 보면 됩니다. 두 강의 모두 AX Study에 있습니다.
한눈에 비교
출처: Claude Code 개요, 메모리, 스킬, 서브에이전트, 훅, MCP, 권한 모드, 보안, 비용 문서 · Claude 요금 안내 / Codex GitHub README, Codex 문서, AGENTS.md, 스킬, 훅, 서브에이전트, MCP, 승인·보안, Codex Cloud, 요금 문서