Claude Code와 Codex CLI: 채널, 모델, 워크플로
AI in IDE가 지원하는 명령줄 코딩 에이전트 중 Claude Code와 Codex CLI를 채널, 설정 파일, 모델, 엔드포인트, 쿼터 소모 방식으로 비교합니다.
둘 다 공식 벤더 CLI이며 베이스 URL과 대시보드 키로 AI in IDE에 연결합니다. 서로 호환되지 않습니다. 키는 하나의 채널에 속하고, 각 CLI는 다른 설정 파일과 다른 엔드포인트 계열을 사용합니다. 자세한 설정은 설정과 Codex 설정에 있습니다.
한눈에 보기
| Claude Code | Codex CLI | |
|---|---|---|
| 채널 | AWSQ 또는 CCMAX | Codex |
| 설정 | ~/.claude/settings.json | ~/.codex/config.toml과 auth.json |
| 엔드포인트 계열 | Anthropic Messages(/v1/messages) | Responses(/responses), Chat Completions도 지원 |
| 모델 계열 | Claude | GPT/Codex |
| 쿼터 배율 | AWSQ 0.8배, CCMAX 2배 | 0.8배 |
| npm 설치 Node.js | 22 이상, 네이티브 CLI는 Node.js 불필요 | 18 이상 |
| IDE 표면 | VS Code/Cursor 확장, JetBrains 플러그인 | 공식 VS Code Codex 확장이 같은 파일 사용 |
설정 차이
Claude Code는 ~/.claude/settings.json의 env에서 연결 값을 읽습니다. ANTHROPIC_BASE_URL은 호스트 이름, ANTHROPIC_AUTH_TOKEN은 대시보드 키로 두고, 긴 에이전트 턴을 위해 API_TIMEOUT_MS와 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC을 추가합니다. VS Code와 Cursor 확장은 CLI를 내장하고, JetBrains 통합은 CLI를 따로 설치해 beta 플러그인에서 가리킵니다. 확장은 claude.ai 계정을 전제로 하므로 편집기 설정에 claudeCode.disableLoginPrompt를 넣습니다.
Codex CLI는 ~/.codex/config.toml과 ~/.codex/auth.json을 읽습니다. 문서 설정은 model_provider = "aiinide", model = "gpt-6.1-sol", wire_api = "responses", requires_openai_auth = true를 지정하고, 키는 auth.json의 OPENAI_API_KEY에 넣습니다. CLI가 베이스 URL 뒤에 /responses를 붙입니다. gpt-5.5는 폐기되었습니다.
지원 모델
Claude Code(AWSQ와 CCMAX):
| 모델 | 적합한 용도 |
|---|---|
claude-opus-5-5(별칭 claude-opus-5.5) | 어려운 리팩터링, 긴 자율 실행 |
claude-sonnet-5-5(별칭 claude-sonnet-5.5) | 일상 코딩, 기본 선택 |
claude-haiku-4-5-20251001 | 빠른 수정, 저렴한 확인 호출 |
Codex CLI(Codex 채널), 문서 예시:
| 모델 | 입력 | 캐시 | 출력 |
|---|---|---|---|
gpt-6-astra | 8.00 | 0.80 | 40.00 |
gpt-6-sol | 1.60 | 0.16 | 8.00 |
gpt-6.1-sol | 1.60 | 0.08 | 8.00 |
gpt-6.1-terra | 0.80 | 0.04 | 4.00 |
codex-auto-review | 4.00 | 0.40 | 24.00 |
gpt-5.6-sol | 3.20 | 0.32 | 16.00 |
gpt-5.6-terra | 1.60 | 0.16 | 9.60 |
gpt-5.6-luna | 0.16 | 0.016 | 0.96 |
표는 Codex 채널의 100만 토큰당 실효 USD 요율로, 업스트림 요율에 채널의 0.8배를 곱한 값입니다. 272K 입력 토큰 초과 요율, 캐시 쓰기 규칙, 서비스 계층은 Codex 설정 가이드에 자세히 나옵니다.
각 클라이언트의 차이
- Claude Code는 Anthropic 클라이언트 경험을 유지합니다. 편집기 패널,
/status,/model,claude mcp add로 추가하는 MCP 서버, hooks, 권한 규칙, 서브에이전트 워크플로입니다. AWSQ와 CCMAX는 OpenAI Chat Completions와 Responses 요청도 받지만, Claude 전용 기능은 Anthropic Messages를 씁니다. - Codex CLI는 Responses API 중심입니다. 내장 웹 검색을 지원하지만(채널 배율 후 검색당 과금), 파일 검색은 비활성화되어 있고 호스팅 Code Interpreter, 호스팅 shell, 이미지 생성은 요금을 계산할 수 없어 사용할 수 없습니다. 저장 컨텍스트 참조, 과거 오디오 ID, 원격 파일·이미지 참조는 거부됩니다. 위 표의 GPT-5.6 및 GPT-6 계열 모델은
max_output_tokens의 기본값이 32,768이며 최대 128,000까지 지정할 수 있습니다.codex-auto-review의 기본값은 4,096입니다. - 둘 다 채널당 대시보드 키 하나를 쓰고 구매한 잔액을 공유하며 대시보드에 사용량을 표시합니다. Anthropic, OpenAI, Google 계정은 필요 없습니다.
무엇을 고를까
Claude 네이티브 에이전트, MCP, hooks, 권한 규칙, JetBrains/VS Code 통합이 필요하면 Claude Code를 고릅니다. GPT 중심 작업, Responses API, OpenAI 호환 클라이언트가 필요하면 Codex CLI를 고릅니다. 둘을 함께 쓸 수도 있습니다. 채널마다 키를 만들고 설정 파일을 분리하세요.
자주 묻는 질문
키 하나로 두 클라이언트를 호출할 수 있나요?
아닙니다. 키는 하나의 채널에만 속합니다. AWSQ와 CCMAX 키는 Claude 모델, Codex 키는 GPT/Codex 모델을 담당합니다.
Codex 키를 /v1/messages에 쓸 수 있나요?
아닙니다. Codex 키는 /responses 또는 /chat/completions에서 인증하며, Anthropic 엔드포인트로 보내면 400이 납니다.
Claude Code가 OpenAI 호환 경로를 쓸 수 있나요?
AWSQ와 CCMAX는 /v1/chat/completions와 /v1/responses를 받지만, Claude 전용 기능은 Anthropic Messages를 씁니다. OpenAI 호환 턴에서는 매번 전체 대화를 보내야 하며 저장 컨텍스트는 쓰이지 않습니다.
Codex에는 어떤 모델을 쓰나요?
문서 설정은 gpt-6.1-sol을 씁니다. gpt-5.5는 폐기되었고, 키에서 쓸 수 있는 정확한 목록은 GET /v1/models로 확인합니다.