본문으로 건너뛰기
한국어

Codex CLI 연결

OpenAI Codex CLI를 1折AI에 연결하는 구성 방법(~/.codex/config.toml의 model_providers), Responses 인터페이스를 통해 GPT 모델 호출.

OpenAI / GPT 모델이 출시되었습니다. Codex CLI는 OpenAI Responses 인터페이스(/v1/responses)를 사용하며, 본 사이트 API 키로 연결합니다. 사용 가능한 모델과 가격은 모델 카탈로그에서 확인하세요.

먼저 Codex 사용자 지정 공급자 구성 방식을 명확히 설명하겠습니다. 형식은 Codex 공식 구성 문서에서 가져왔습니다.

Codex의 구성은 ~/.codex/config.toml에 있습니다. 사용자 지정 공급자는 이 사용자 수준 파일에만 작성할 수 있으며, 프로젝트의 .codex/config.toml에서 model_provider을(를) 설정하면 무시됩니다.

~/.codex/config.toml
model_provider = "onezhe"
model = "gpt-6-astra"
[model_providers.onezhe]
name = "1折AI"
base_url = "https://1zheai.com/v1"
env_key = "ONEZHE_API_KEY"
wire_api = "responses"

예제는 gpt-6-astra을(를) 사용하며, 키가 지원하는 다른 GPT 모델 ID로 교체할 수 있습니다.

각 필드의 의미:

필드설명
model_provider어떤 공급자를 사용할지, 아래 [model_providers.<id>]의 id에 해당합니다. openai, ollama, lmstudio은(는) 예약된 이름이므로 사용할 수 없습니다
base_url/v1을(를) 포함해야 합니다
env_keyCodex가 이 환경 변수에서 API 키(API key)를 읽습니다. 이름이 export한 것과 정확히 일치해야 합니다
wire_api공식 문서에 따르면 현재 responses만 지원하며, 생략 시에도 동일합니다

그런 다음 API 키를 환경 변수에 넣습니다:

macOS / Linux
export ONEZHE_API_KEY="sk-你的Key"

다음 명령은 Codex 공식 문서에서 가져왔습니다:

npm
npm install -g @openai/codex
401?

env_key에 작성된 변수 이름이 실제 export한 것과 일치하지 않거나, 환경 변수를 설정하기 전에 터미널을 열었습니다. 양쪽 이름을 다시 확인하고, 터미널을 다시 열어 재시도하세요.

wire_api를 chat으로 변경할 수 있나요?

불가능합니다. Codex 공식 구성 문서에서 wire_api은(는) responses만 허용합니다. Chat Completions 인터페이스만 제공하는 서비스는 Codex에 연결하려면 별도의 프로토콜 변환 도구가 필요합니다.

GPT 모델을 어떻게 선택하나요?

모델 카탈로그에서 현재 모델을 확인하고, 모델 ID를 model에 입력하세요. Codex를 시작한 후 짧은 요청을 보내고, 호출 로그에서 모델과 상태를 확인하세요.