Codex + 다른 모델 제공자
Codex 실행 구성에 별도의 모델 제공자를 지정하거나 이미 사용 중인 Codex 프로필을 활용합니다.
제공자 정보 준비
Codex를 설치하고 제공자의 기본 URL, API 키, 모델 ID를 준비하십시오. 엔드포인트는 OpenAI Responses API를 지원해야 하며, Chat Completions 호환성만으로는 충분하지 않습니다.
이 예제는 다른 Codex 항목을 바꾸거나 Codex 전역 구성을 편집하지 않고 Codex · work를 추가합니다.
이미 Codex 프로필이 있다면 기존 Codex 프로필 사용으로 건너뛰십시오.
1. 제공자 정의
이 구성을 facade.json에 추가하십시오(에이전트 설정 참조). 예제의 기본 URL, 키, 모델 ID를 바꿉니다:
{
"clis": {
"Codex · work": {
"type": "codex",
"model": "YOUR_MODEL_ID",
"args": [
"-c",
"model_provider=work",
"-c",
"model_providers.work.name=Work",
"-c",
"model_providers.work.base_url=https://api.example.com/v1",
"-c",
"model_providers.work.wire_api=responses",
"-c",
"model_providers.work.env_key=WORK_API_KEY"
],
"env": {
"WORK_API_KEY": "YOUR_API_KEY"
}
}
}
}model_provider=work와 모든 model_providers.work.… 설정에서 동일한 제공자 ID인 work를 사용하십시오. 키의 변수 이름 WORK_API_KEY는 env_key와 일치해야 합니다.
2. 제공자 설정 확인
| 설정 | 역할 |
|---|---|
model_provider=work | work 설정에서 정의한 제공자를 선택합니다. |
model_providers.work.name | 해당 제공자에 표시 이름을 지정합니다. |
model_providers.work.base_url | API 기본 URL을 설정합니다. |
model_providers.work.wire_api=responses | Responses API 형식을 사용합니다. |
model_providers.work.env_key=WORK_API_KEY | Codex에 키가 들어 있는 환경 변수를 알려 줍니다. |
env.WORK_API_KEY | Codex 프로세스에 해당 키를 제공합니다. |
각 -c는 이 항목으로 시작한 에이전트에 Codex 옵션 하나를 설정합니다.
예제는 키를 facade.json에 저장합니다. 키가 이미 환경 변수에 있다면 env.WORK_API_KEY를 ${env:WORK_API_KEY}로 설정하십시오. 편집기에는 에이전트를 시작하기 전에 해당 변수가 있어야 합니다.
3. 이 구성으로 Codex 시작
facade.json을 저장하고 New Agent를 선택한 뒤 Codex · work를 고릅니다. /model로 선택된 모델을 확인한 다음 프로젝트의 짧은 작업을 보내십시오.
제공자가 사용량을 보고한다면 요청이 올바른 계정에 표시되는지 확인합니다. 시작 구성을 확인하려면 Show Agent Launch를 실행하고 작업 위치를 선택하십시오. 보고서에서 이 항목을 찾으면 현재 설정으로 다음 에이전트가 어떻게 시작되는지 확인할 수 있습니다.
요청 오류는 문제 해결을 참조하십시오.
예제: QwenCloud
QwenCloud Token Plan 키를 사용한다면 기본 URL로 https://token-plan.maas.qwencloudapi.com/compatible-mode/v1을 사용하고 wire_api=responses를 유지하십시오. 요금제에서 사용할 수 있는 모델을 사용합니다. 종량제 키는 해당 지역의 엔드포인트를 사용합니다.
기존 Codex 프로필 사용
이미 Codex 프로필을 사용하고 있다면 항목의 인수로 해당 프로필을 선택하십시오:
{
"clis": {
"Codex · profile": {
"type": "codex",
"args": [
"--profile",
"work"
]
}
}
}work를 사용 중인 프로필로 바꾸십시오. 제공자 구성은 Facade 항목에 반복하지 말고 해당 프로필에 두십시오. 저장한 뒤 New Agent를 선택하고 Codex · profile을 고릅니다. 짧은 작업을 보내고, 제공자가 사용량 기록을 제공하는 경우 해당 기록에서 요청을 확인하십시오.