Codex CLI

개요

유형: 코딩 도구Primary Path: OpenAI Responses (고급 선택 경로)Support Confidence: 모델/경로 제한이 있는 지원

OpenAI Codex는 터미널에서 코드를 읽고 수정하며 실행할 수 있는 경량의 코딩 에이전트인 오픈 소스 커맨드라인 도구(CLI)입니다. 이는 GPT 모델 기반으로 구축되었으며 코드 생성에 최적화되어 있습니다. TokenLab의 경우 Codex CLI는 /v1/responses를 사용할 수 있지만, 이를 고급 호환성 경로로 취급해야 합니다. 일부 Responses 전용 기능은 모든 모델 및 라우트에서 보장되지 않습니다. Codex CLI 원격 압축은 POST /v1/responses/compact에서 지원됩니다. Codex는 /compact 및 자동 압축 시 현재 세션의 model을 body.model로 보내므로, 압축에 사용할 모델이 Responses 경로에서 사용 가능해야 합니다. /v1/compact는 설정하지 마세요.

시스템 요구사항

OS: macOS, Linux (공식 지원), Windows는 WSL을 통해 지원
Node.js: 버전 18+
npm: 버전 10.x.x 이상

설치

npm install -g @openai/codex

설치 확인:

codex --version

구성

1단계: API 키 설정

임시(현재 세션):

export OPENAI_API_KEY="sk-your-tokenlab-key"

영구 구성: ~/.bashrc, ~/.zshrc, 또는 ~/.bash_profile에 추가:

export OPENAI_API_KEY="sk-your-tokenlab-key"

그런 다음 다시 로드:

source ~/.zshrc  # or source ~/.bashrc

2단계: config.toml 구성

~/.codex/config.toml을 편집:

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
plan_mode_reasoning_effort = "xhigh"
model_context_window = 258000
model_auto_compact_token_limit = 232200
sandbox_mode = "danger-full-access"
approval_policy = "never"

personality = "friendly"
service_tier = "fast"

[model_providers.tokenlab]
env_key = "OPENAI_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

[features]
fast_mode = true

이 WebSocket 모드는 Codex 클라이언트를 위한 Responses-over-WebSocket 브리지입니다. 공식 response.create 이벤트만 허용하며 stream은 암시적입니다. 이 transport에서는 background와 response.cancel을 사용할 수 없습니다. OpenAI Realtime API가 아니며 session.update, conversation.item.*, input_audio_buffer.*, 바이너리 오디오 또는 중첩된 Realtime response.create.response envelope는 허용하지 않습니다.

config 파일이 존재하지 않는 경우, 한 번 codex를 실행하여 파일을 생성한 후 편집하세요. config.toml을 변경한 후에는 새로운 제공자 설정이 다시 로드되도록 Codex를 완전히 재시작하십시오.

Codex는 커스텀 제공자에 대한 chat/completions 지원을 단계적으로 중단하고 있습니다. 의도적으로 오래된 호환성 경로를 사용하지 않는 한 TokenLab에는 wire_api = "responses"를 유지하세요.

TokenLab는 알 수 없는 Responses 필드를 best-effort로 전달하며 요청을 Chat Completions로 조용히 다운그레이드하지 않습니다. 필드나 조합의 지원 여부는 선택된 upstream이 결정합니다.

기본 사용법

대화형 모드 시작:

codex

직접 명령:

codex "Fix the bug in main.py line 42"

모델 지정:

codex -m gpt-5.6-sol "Build a REST API server"

권장 모델

모델	용도
`gpt-5.6-sol`	코딩 및 추론에 가장 적합한 기본 선택
`gpt-5-mini`	코딩 워크플로우를 위한 더 빠르고 저렴한 대체
`claude-sonnet-4-6`	코드 리뷰, 문서화
`deepseek-r1`	알고리즘 설계, 추론

대화형 명령

명령	설명
`/help`	도움말 표시
`/exit` 또는 `Ctrl+C`	종료
`/clear`	대화 지우기
`/config`	구성 보기
`/model <name>`	모델 전환
`/tokens`	토큰 사용량 보기

구성 확인

# 환경 변수 확인
echo $OPENAI_API_KEY

# API 연결 테스트
codex "Hello, Codex!"

# 구성 보기
cat ~/.codex/config.toml

일반 사용 사례

코드 리뷰:

git diff | codex "Review these code changes"

커밋 메시지 생성:

git diff --staged | codex "Generate a commit message for these changes"

오류 수정:

codex "Fix the TypeScript errors in src/components/"

코드 설명:

cat main.py | codex "Explain what this code does"

문제 해결

연결 오류

config.toml의 base_url이 정확히 https://api.tokenlab.sh/v1인지 확인하세요
네트워크 연결 상태를 확인하세요
프록시 간섭이 없는지 확인하세요

인증 실패

~/.codex/config.toml에 env_key = "OPENAI_API_KEY"가 있는지 확인하세요
OPENAI_API_KEY 환경 변수가 설정되어 있는지 확인하세요
키가 sk-로 시작하는지 확인하세요
TokenLab 대시보드에서 키가 활성화되어 있는지 확인하세요

모델을 찾을 수 없음

모델 이름이 정확히 일치하는지 확인하세요
tokenlab.sh/en/models에서 모델 가용성을 확인하세요

Responses-native 필드 거부됨

일부 필드는 선택한 모델 및 라우트에 대해 TokenLab가 해당 동작을 보장할 수 있을 때만 /v1/responses에서 사용할 수 있습니다
unsupported_request_field가 표시되면 해당 필드를 제거하거나 해당 필드에 의존하지 않는 워크플로로 전환하세요

/compact 또는 자동 압축 실패

Codex CLI는 /v1/compact가 아니라 POST /v1/responses/compact를 호출합니다
압축 요청은 현재 세션의 model을 사용하므로 해당 모델이 Responses 경로에서 사용 가능해야 합니다
wire_api = "responses" 및 base_url = "https://api.tokenlab.sh/v1"를 유지하세요

호환성 매트릭스

코딩 도구

네이티브 SDK

프레임워크 및 플랫폼

채팅 앱

개요

시스템 요구사항

설치

구성

1단계: API 키 설정

2단계: config.toml 구성

기본 사용법

권장 모델

대화형 명령

구성 확인

일반 사용 사례

문제 해결

​개요

​시스템 요구사항

​설치

​구성

​1단계: API 키 설정

​2단계: config.toml 구성

​기본 사용법

​권장 모델

​대화형 명령

​구성 확인

​일반 사용 사례

​문제 해결

개요

시스템 요구사항

설치

구성

1단계: API 키 설정

2단계: config.toml 구성

기본 사용법

권장 모델

대화형 명령

구성 확인

일반 사용 사례

문제 해결