~/.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 — 이 두 값은 필수입니다.gemma-tunnel을 콘솔에서 등록한 공개 모델 이름으로 교체하세요.
OpenAI Python SDK 사용
OpenAI SDK로 로컬 모델을 프로그래밍 방식으로 호출하려면, 클라이언트를 Tokios Base URL로 지정하세요:openai_tokios.py
OpenAI SDK의 Base URL은
/v1로 끝나야 합니다. Tokios 엔드포인트는 https://api.tokios.com/v1입니다.문제 해결
404 Not Found
404 Not Found
프로필의
model 값이 config.toml에서 어떤 배포 이름과도 일치하지 않습니다. Models 탭에서 등록한 정확한 이름을 확인하세요 — 대소문자를 구분합니다.Codex ignores the Tokios profile
Codex ignores the Tokios profile
명령줄에서
--profile tokios를 전달하고 있는지 확인하세요. 플래그 없이는 Codex가 OpenAI의 호스팅 API를 가리키는 기본 프로필을 사용합니다. default_profile = "tokios"를 [general] 섹션의 config.toml에 설정하여 기본값으로 만들 수도 있습니다.다음 단계
Compatible clients
다른 OpenAI 및 Anthropic 호환 클라이언트의 Base URL 및 키 설정을 확인하세요.
API keys
팀원과 에이전트를 위한
sk-tok-… 키를 생성, 범위 지정, 로테이션하세요.