에이전트로 설정하기
컴퓨터에서 이미 실행 중인 에이전트에 다음 작업을 복사하세요:연결 작동 방식
OpenCodex는 Codex와 모델 API 사이의 로컬 프록시입니다. 이 가이드에서는 OpenCodex 2.73.0 및 Codex CLI 0.149.0을 사용합니다. TokenLab 프리셋의 Chat Completions 연동은 2.72.0에서 릴리스되고 엔드투엔드 검증을 거쳤습니다. 버전 2.73.0은 해당 연동을 유지하면서 모델별 Responses 및 Anthropic Messages 라우팅을 추가합니다. 아래 나열된 라우트는 스트리밍 텍스트와 function-call/result 왕복 테스트를 통해 TokenLab과의 호환성이 확인되었습니다. Codex는 로컬 OpenCodex 프록시로 Responses 요청을 보냅니다. 그런 다음 OpenCodex는 선택한 모델의 요청을 TokenLab으로 전송합니다. 로컬 연결에서 Responses 요청을 사용한다고 해서 해당 모델이 TokenLab의 Responses API를 통해 호출된다는 의미는 아닙니다.
프리셋의 Base URL은
https://api.tokenlab.sh/v1입니다. 이 값을 변경하지 마세요. OpenCodex가 일치하는 Messages 또는 Responses URL을 직접 구성합니다. 나열된 Responses 기본값 및 Claude 라우팅에 해당하지 않는 모델은 프리셋의 Chat 어댑터를 사용합니다.
TokenLab은 이를 선언한 모델에 대해 Gemini의 네이티브 API를 지원하지만, OpenCodex 2.73.0 TokenLab 프리셋은 Chat Completions를 통해 Gemini를 호출합니다. 프로바이더 전체를 Responses나 Gemini로 변경하지 마세요. 그렇게 하면 해당 포맷을 지원하지 않는 모델의 요청까지 변경됩니다.
설치 또는 업데이트
npm 설치에는 Node.js 18 이상을 사용하세요:TokenLab 추가하기
TokenLab API Keys에서 키를 생성하세요. 터미널 설정의 경우 빠른 시작을 참고하여 키 값이 명령 히스토리에 남지 않도록TOKENLAB_API_KEY를 설정하세요. 해당 터미널에서 OpenCodex를 시작해야 합니다. 백그라운드 서비스는 자체 실행 환경에 해당 환경 변수가 필요합니다.
OpenCodex를 새로 설치하는 경우, ocx init을 실행하고 TokenLab을 선택한 다음 키를 로컬에서 입력하거나 리터럴 환경 변수 참조인 ${TOKENLAB_API_KEY}를 사용하세요. 마법사의 Codex 연결 및 자동 시작 선택 항목을 적용하기 전에 검토하세요.
기존 설치 환경의 경우, 다른 프로바이더를 교체하지 않고 프리셋을 추가하세요:
tokenlab이 이미 존재하는 경우, --force로 덮어쓰지 말고 대시보드에서 해당 프로바이더를 편집하세요.
대시보드의 Add provider 목록에서 TokenLab을 선택하고 키를 입력할 수도 있습니다. OpenCodex는 설정을 $OPENCODEX_HOME/config.json(일반적으로 ~/.opencodex/config.json)에 저장합니다.
프록시가 아직 실행 중이지 않다면 시작한 다음 대시보드를 여세요:
GET /v1/models?category=chat을 탐색하고 tool-use 기능이 있는 모델만 유지합니다. 이미지, 비디오, 오디오, 임베딩 및 디시전 모델은 제외됩니다. 키를 사용한 모델 검색에는 해당 키의 모델 권한 및 전송 정책이 반영됩니다.
ocx sync를 실행하여 Codex를 연결하고 모델 카탈로그를 새로고침한 뒤, 새 Codex 세션을 시작하세요. 이 작업은 Codex의 프록시 연결 및 카탈로그를 변경합니다. 동기화하기 전에 기존 커스텀 프로바이더 설정을 검토하고 백업을 유지하세요. 계정이나 권한 정책을 교체할 필요는 없습니다.
모델 선택 및 요청 확인
Codex의 모델 선택기에서tokenlab/<model-id> 항목을 선택하거나, CLI 1회 실행 시 다음과 같이 지정하세요:
tokenlab/을 사용하여 프로바이더를 선택하며, TokenLab으로 전송되는 모델 ID는 gpt-6.1-sol입니다. Models에서 현재 사용 가능한 정확한 ID를 선택하세요.
간단한 연결 확인을 위해 다음을 전송하세요:
Responses 모델을 Chat Completions로 유지하기
나열된 Responses 모델 중 하나에 Chat 경로를 사용하려면, OpenCodex 설정의 기존providers.tokenlab 객체에 modelAdapters 항목을 병합하세요. 다음 예시는 Codex용 gpt-6-astra를 Chat으로 유지합니다:
전송 정책 및 기타 TokenLab 도구
이 프리셋은X-TokenLab-Delivery-Policy 헤더를 강제하지 않습니다. TokenLab은 API 키의 기본 전송 정책을 사용합니다. Chat, Responses 또는 Messages 선택은 전송 정책 선택과 별개입니다. 자세한 내용은 TokenLab 프로바이더 설정을 참조하세요.
기타 API 도구의 경우 TokenLab MCP 서버를 추가하거나, 연동 안내는 TokenLab Skills를 참조하세요. 이들은 메인 모델의 프로바이더나 API 포맷을 변경하지 않습니다.
OpenCodex 2.73.0의 JEV Auto는 TypeSafe의 디시전 백엔드를 사용합니다. 해당 백엔드로 TokenLab을 제공하지 않습니다. MCP를 통해 TokenLab의 System One API를 호출하는 것은 별개의 작업입니다. TypeSafe 자격 증명 필드에 TokenLab 키를 입력하지 마세요.
문제 해결 및 설정 복원
- 선택기에 TokenLab이 표시되지 않는 경우:
ocx --version을 확인하세요. 이 가이드는 2.73.0 버전을 기준으로 합니다.ocx sync로 카탈로그를 새로고침하고 새 Codex 세션을 시작하세요. - 401 오류 또는 자격 증명 누락: 키가 활성화되어 있고 OpenCodex를 실행 중인 프로세스에서 접근 가능한지 확인하세요. 다른 터미널의 환경 변수는 이미 실행 중인 서비스를 업데이트하지 않습니다.
- 모델이 누락된 경우: 정확한 ID, 키의 권한 및 현재 가용성을 확인하세요. Chat 모델이 아니거나
tool-use가 없는 Chat 모델은 이 프리셋에 포함되지 않습니다. - 지원되지 않는 요청 또는 잘못된 엔드포인트: 선택한 모델을 라우팅 표와 비교하고 저장된 어댑터 재정의 설정을 검토하세요. 요구되는 포맷은 모델 상세 정보의
tokenlab.accepted_request_formats입니다. 모델 목록이 이 세부 필드를 대체하지는 않습니다. Codex가 로컬에서 Responses를 사용한다는 이유만으로 Claude와 Gemini를 Responses로 전송해서는 안 됩니다. - 도구 또는 이미지 입력 실패: 원래 오류와 Request ID를 보관하세요. 설정을 변경하기 전에 모델의 기능과 활성화된 OpenCodex 라우트를 확인하세요. 오류를 숨기기 위해 대화 기록이나 도구 결과를 삭제하지 마세요.
ocx stop을 사용하세요. OpenCodex가 프록시를 중지하고 네이티브 Codex 연결을 복원합니다. ocx restore는 프록시를 다른 클라이언트를 위해 실행 상태로 유지하면서 네이티브 연결을 복원합니다. 다른 클라이언트와 공유되는 설치 환경을 변경하기 전에 OpenCodex CLI 레퍼런스를 검토하세요.