Codex CLI

기존 에이전트에 설정 맡기기Copy Anchor Link

컴퓨터에서 이미 사용할 수 있는 에이전트에 다음 작업을 복사해 전달하세요.

이 가이드를 읽고 Codex CLI의 TokenLab 연결을 도와주세요:
https://tokenlab.sh/docs/ko/integrations/codex-cli
설치된 버전과 현재 적용된 설정을 먼저 확인하세요.
기존 계정, 제공자, 권한 및 기타 설정을 보존하세요.
로컬 파일을 백업하고 변경할 내용을 보여 주세요.
필요한 API 키는 제가 로컬로 입력하겠습니다. 채팅에서 키를 요구하거나 출력하거나 붙여 넣지 마세요.
먼저 설정이 정상적으로 로드되는지 확인하세요.
유료 요청 테스트는 실행 전에 비용을 별도로 설명하세요.

개요Copy Anchor Link

Codex CLI는 /v1/responses로 TokenLab에 연결합니다. 선택한 모델의 tokenlab.accepted_request_formats에 openai_responses가 포함되어야 하며 기능은 모델마다 다를 수 있습니다.

Codex CLI 원격 압축은 POST /v1/responses/compact에서 지원됩니다. Codex는 /compact 및 자동 압축 시 현재 세션의 model을 body.model로 보내므로, 압축에 사용할 모델이 Responses 경로에서 사용 가능해야 합니다. /v1/compact는 설정하지 마세요.

시스템 요구사항Copy Anchor Link

macOS, Linux, Windows는 공식 CLI 설치 안내를 따르세요. 네이티브 Windows와 WSL은 별도 환경입니다. Windows 안내를 확인하세요. npm은 설치 방법 중 하나이며 네이티브 실행 파일의 필수 조건이 아닙니다.

설치Copy Anchor Link

npm install -g @openai/codex@0.149.0

설치 확인:

codex --version

구성Copy Anchor Link

1단계: API 키 설정Copy Anchor Link

빠른 시작의 macOS, Linux, WSL 또는 Windows PowerShell 절차로 키를 명령 기록에 남기지 않고 TOKENLAB_API_KEY를 설정한 뒤 같은 터미널에서 Codex를 실행하세요. 계속 사용하려면 로컬 비밀 관리 도구를 이용하고 셸 프로필에 평문 키를 추가하지 마세요.

2단계: tokenlab.config.toml 구성Copy Anchor Link

Codex 0.149.0에서는 활성 CODEX_HOME(보통 ~/.codex)에 별도 tokenlab.config.toml을 사용하세요. 이름이 비어 있을 때만 만들고, 기존 TokenLab 프로필을 편집한다면 먼저 백업하세요. codex --profile tokenlab로 명시적으로 로드하므로 config.toml, auth.json, 계정과 권한 정책을 변경하지 않습니다. 예전 [profiles.tokenlab] 테이블은 사용하지 마세요. 이 프로필 없이 시작하면 원래 구성으로 돌아갑니다. 공식 프로필 구성을 참고하세요.

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

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

이 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는 허용하지 않습니다.

현재 Codex는 wire_api = "responses"를 사용합니다. chat/completions를 설정하지 마세요. env_key가 사용되도록 이 제공자의 requires_openai_auth는 생략하거나 false로 둡니다.

기본 사용법Copy Anchor Link

대화형 모드 시작:

codex --profile tokenlab

직접 명령:

codex --profile tokenlab "Fix the bug in main.py line 42"

모델 지정:

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

모델 선택Copy Anchor Link

현재 tokenlab.accepted_request_formats에 openai_responses가 포함된 모델을 선택하세요. 자신의 코딩 작업으로 비교하고 모델 페이지에서 현재 가격을 확인하세요.

대화형 명령Copy Anchor Link

구성 확인Copy Anchor Link

값을 출력하지 않고 환경 변수가 설정되어 있는지만 확인합니다. 이 확인으로 키의 유효성을 검증할 수는 없습니다:

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Codex를 시작한 뒤 /status를 실행하여 현재 모델과 권한을 확인하세요. 프로필을 사용한다면 동일한 프로필로 시작하세요. 공식 상태 명령 안내를 참고하세요.

실제 요청을 보낼 준비가 되면 아래 명령을 실행하세요. TokenLab 잔액을 사용합니다. 응답과 요청 기록의 해당 항목을 확인하세요. 환경 변수 확인이나 클라이언트 시작 성공만으로 요청 성공을 확인할 수는 없습니다.

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

일반 사용 사례Copy Anchor Link

코드 리뷰:

git diff | codex --profile tokenlab "Review these code changes"

커밋 메시지 생성:

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

오류 수정:

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

코드 설명:

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

문제 해결Copy Anchor Link