코딩 도구
Codex CLI
OpenAI Codex CLI가 TokenLab API를 사용하도록 구성
에이전트가 이를 설정하도록 하기
컴퓨터에서 이미 실행 중인 에이전트에 이 작업을 복사하세요:
Read this guide and help me connect Codex CLI to TokenLab:
https://tokenlab.sh/docs/ko/integrations/codex-cli
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.개요
Codex CLI는 /v1/responses를 통해 TokenLab에 연결할 수 있습니다. 선택한 모델은 tokenlab.accepted_request_formats에 openai_responses가 포함되어 있어야 하며, 지원 기능은 모델에 따라 다를 수 있습니다.
원격 압축은 POST /v1/responses/compact를 사용합니다. Codex는 현재 세션 모델을 body.model에 담아 전송하므로 해당 모델 역시 Responses를 지원해야 합니다. /v1/compact는 구성하지 마세요.
시스템 요구 사항
macOS, Linux 또는 Windows의 경우 공식 CLI 설치 가이드를 참고하세요. 네이티브 Windows와 WSL은 서로 다른 환경이므로 Windows 가이드를 따르세요. 아래의 npm 명령어는 설치 방법 중 하나일 뿐이며, 네이티브 바이너리 설치의 필수 요건은 아닙니다.
설치
npm install -g @openai/codex@0.163.0설치 확인:
codex --version구성
1단계: API 키 설정
macOS, Linux, WSL 또는 Windows PowerShell용 빠른 시작 터미널 지침을 사용하여 명령어 히스토리에 키를 남기지 않고 TOKENLAB_API_KEY를 설정하세요. 해당 터미널에서 Codex를 실행합니다. 지속적으로 사용하려면 로컬 비밀 키 관리 도구를 사용하세요. 셸 프로필에 일반 텍스트 형태로 키를 추가하지 마세요.
2단계: tokenlab.config.toml 구성
Codex 0.163.0(2026-10-18 테스트 완료) 환경의 활성 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은 암시적으로 적용되고, 이 전송 방식에서는 background 및 response.cancel을 사용할 수 없습니다. 이는 OpenAI Realtime API가 아니며 session.update, conversation.item.*, input_audio_buffer.*, 바이너리 오디오 또는 중첩된 Realtime response.create.response 봉투를 허용하지 않습니다.
선택한 구성 파일이 존재하지 않는 경우 생성하세요. 파일을 편집한 후 아래의 해당 명령어로 새 세션을 시작하세요.
현재 Codex는 wire_api = "responses"를 사용합니다. chat/completions는 구성하지 마세요. 이 커스텀 공급자에 대해 env_key가 사용되도록 requires_openai_auth를 설정하지 않거나 false로 유지하세요.
Responses 요청은 Chat Completions로 변환되지 않습니다. 선택적 필드 및 향후 지원 필드는 선택한 모델에 따라 달라집니다.
기본 사용법
대화형 모드 시작:
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"모델 선택
현재 tokenlab.accepted_request_formats에 openai_responses가 포함된 모델을 사용하세요. 실제 코딩 작업에서 후보 모델들을 비교해 보고 모델 페이지에서 최신 가격을 확인하세요.
대화형 명령어
| 명령어 | 설명 |
|---|---|
/help | 도움말 표시 |
/exit 또는 Ctrl+C | 종료 |
/clear | 대화 지우기 |
/status | 활성 모델, 권한 및 토큰 사용량 표시 |
/model <name> | 모델 전환 |
구성 확인
값을 출력하지 않고 환경 변수가 설정되어 있는지 확인합니다. 이 확인 과정에서 키의 유효성을 검증하지는 않습니다:
if [ -n "${TOKENLAB_API_KEY:-}" ]; then
printf '%s\n' 'TOKENLAB_API_KEY is set'
else
printf '%s\n' 'TOKENLAB_API_KEY is not set'
fiCodex를 시작하고 /status를 실행하여 활성 모델과 권한을 확인하세요. 프로필을 사용하는 경우 동일한 프로필로 시작하세요. 공식 status 명령 가이드를 참조하세요.
실제 요청을 보낼 준비가 되면 아래 명령어를 실행하세요. 이 작업은 TokenLab 잔액을 사용합니다. 응답 및 요청 내역의 일치하는 기록을 확인하세요. 환경 변수 확인이나 성공적인 실행만으로는 실제 요청 성공 여부를 보장할 수 없습니다.
codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."일반적인 사용 사례
코드 리뷰:
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"동일한 에이전트에서 이미지 및 비디오 생성
Codex는 TokenLab MCP 서버를 사용하여 이미지 및 짧은 비디오를 생성할 수도 있습니다. 각 생성 비용은 동일한 TokenLab 잔액에서 차감됩니다. TOKENLAB_API_KEY가 설정된 터미널에서 다음 명령을 실행하세요:
codex mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env TOKENLAB_API_KEY="$TOKENLAB_API_KEY" \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48이 명령어는 기본 config.toml에 서버를 추가합니다. Codex는 tokenlab.config.toml 프로필에서도 해당 파일을 로드하므로 --profile tokenlab 옵션 사용 여부와 관계없이 도구가 작동합니다. codex mcp list를 실행하여 tokenlab이 표시되는지 확인한 다음, 아래와 같이 시도해 보세요:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video는 작업 ID를 반환합니다. 에이전트는 비디오가 준비될 때까지 get_task_status를 호출합니다.