메인 콘텐츠로 건너뛰기
OpenAI Codex는 Responses API를 통해 Tokios와 통신합니다. ~/.codex/config.toml에 Tokios를 모델 프로바이더로 추가하고, https://api.tokios.com/v1를 지정하면, Codex는 사용자 자신의 로컬 모델 — Ollama, LM Studio 또는 OpenAI 호환 백엔드 — 을(를) 대상으로 실행되며, 어디서든 프라이빗 터널을 통해 도달합니다.

전제 조건

  • 로컬 모델과 페어링된 실행 중인 Tokios 커넥터 — 참고: Connector install
  • 등록된 모델 배포 이름 — 참고: Register a model
  • Tokios API 키 — 참고: API Keys
  • OpenAI Codex 설치 완료

Codex 설정

환경에 Tokios 키를 설정한 다음, ~/.codex/config.toml에 Tokios 프로바이더와 프로필을 추가합니다:
~/.codex/config.toml
wire_api = "responses" 및 disable_response_storage = true — 이 두 값은 필수입니다.
그런 다음 Tokios 프로필로 Codex를 실행합니다:
배포 이름 gemma-tunnel을 콘솔에서 등록한 공개 모델 이름으로 교체하세요.

OpenAI Python SDK 사용

OpenAI SDK로 로컬 모델을 프로그래밍 방식으로 호출하려면, 클라이언트를 Tokios Base URL로 지정하세요:
openai_tokios.py
OpenAI SDK의 Base URL은 /v1로 끝나야 합니다. Tokios 엔드포인트는 https://api.tokios.com/v1입니다.

문제 해결

입력한 sk-tok-… 키가 없거나 잘못되었습니다. 환경에 OPENAI_API_KEY가 설정되어 있고 env_key = "OPENAI_API_KEY"가 config.toml에서 일치하는지 확인하세요. Keys 탭에서 키를 확인하세요 — 생성 시 한 번만 표시됩니다.
프로필의 model 값이 config.toml에서 어떤 배포 이름과도 일치하지 않습니다. Models 탭에서 등록한 정확한 이름을 확인하세요 — 대소문자를 구분합니다.
해당 배포의 커넥터가 오프라인이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인하세요 — 커넥터가 Online으로 표시되어야 하며, 실행 중인 머신이 여전히 켜져 있어야 합니다.
명령줄에서 --profile tokios를 전달하고 있는지 확인하세요. 플래그 없이는 Codex가 OpenAI의 호스팅 API를 가리키는 기본 프로필을 사용합니다. default_profile = "tokios"를 [general] 섹션의 config.toml에 설정하여 기본값으로 만들 수도 있습니다.

다음 단계

Compatible clients

다른 OpenAI 및 Anthropic 호환 클라이언트의 Base URL 및 키 설정을 확인하세요.

API keys

팀원과 에이전트를 위한 sk-tok-… 키를 생성, 범위 지정, 로테이션하세요.