Codex

Codex는 TokenHub의 OpenAI compatible 인터페이스로 모델을 호출할 수 있습니다. 공식 설치 방식은 그대로 두고 API key, Base URL, model ID만 바꿉니다.

이 가이드에서 사용하는 TokenHub endpoint는 https://us-api.tokenhub.com/v1/responses입니다.

사용할 때

작은 저장소나 테스트 프로젝트에서 시작하세요. 먼저 파일 읽기, 코드 설명, 계획 생성을 확인한 뒤 편집과 자동화 작업을 켭니다.

설치 또는 열기

먼저 Codex 공식 문서에 따라 설치하거나 엽니다. 메뉴가 다르면 현재 공식 문서를 우선하세요.

CLI 도구는 TokenHub 자격 증명을 추가하기 전에 실행 파일이 동작하는지 먼저 확인합니다:

codex --version

TokenHub 자격 증명 준비

TokenHub API key를 만들고 TokenHub 모델 목록에서 이 도구에 맞는 모델을 선택합니다.

export TOKENHUB_API_KEY="sk-..."

키는 로컬 shell, IDE 비밀 저장소, 또는 도구의 안전한 API key 필드에 저장하세요. 저장소에 커밋하지 마세요.

TokenHub 공급자 설정

Models, Providers, API Keys, OpenAI Compatible 설정 화면에서 아래 값을 입력합니다.

Provider 값

필드	값
공급자	OpenAI Compatible 또는 Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` 값
모델	`gpt-4.1` 또는 다른 TokenHub model ID

설정 파일 위치

필드	값
User config	`~/.codex/config.toml`
Provider section	`model_providers.tokenhub`
Secret source	`env_key = "TOKENHUB_API_KEY"`

model = "gpt-4.1"
model_provider = "tokenhub"

[model_providers.tokenhub]
name = "TokenHub"
base_url = "__API_BASE_URL__/v1"
env_key = "TOKENHUB_API_KEY"
wire_api = "responses"

Codex uses the Responses wire API for this provider, so choose a TokenHub model that supports https://us-api.tokenhub.com/v1/responses.

설치된 버전이 조금 다른 schema를 쓰는 경우 먼저 대화형 설정을 사용한 뒤 같은 TokenHub 값인 Base URL, API key, model ID를 유지하세요.

도구가 chat, edit, apply, fast models를 나누어 두었다면 첫 테스트에서는 같은 TokenHub 모델을 사용하세요. 동작 확인 후 비용, 지연 시간, 추론 성능에 따라 분리합니다.

임시 환경 변수는 디버깅용

임시 변수는 key, 네트워크, 모델 이름 확인에만 사용하세요. 검증 후 같은 값을 위의 영구 설정으로 옮기세요.

export TOKENHUB_API_KEY="sk-..."

연결 확인

먼저 읽기 전용 프롬프트로 모델이 컨텍스트를 읽고 파일을 바꾸지 않는지 확인합니다. 그 다음 편집이나 agent 작업을 테스트합니다.

프로젝트 README를 읽고 세 문장으로 요약해 주세요. 파일은 수정하지 마세요.

프롬프트가 성공하면 TokenHub 요청 로그에서 모델 이름, endpoint, token 사용량, billing group을 확인합니다.

문제 해결

증상	해결 방법
401 또는 인증 실패	`TOKENHUB_API_KEY`가 유효하고 같은 terminal, IDE, 클라이언트 프로필에 저장되어 있는지 확인합니다.
404 또는 모델 없음	TokenHub 워크스페이스에 존재하고 선택한 프로토콜과 맞는 모델 ID를 사용합니다.
endpoint 오류	Base URL을 위 값과 정확히 맞춥니다. OpenAI 호환 도구는 보통 `/v1`이 필요하고 Claude 호환 도구는 보통 필요하지 않습니다.
요청 timeout	`https://us-api.tokenhub.com`까지의 네트워크, proxy settings, 워크스페이스 allowlist를 확인합니다.
다른 모델이 사용됨	chat, edit, apply, fast, autocomplete 등 모든 모델 필드를 다시 확인합니다.

이 페이지에서