📋 준비 단계
시작하기 전에 다음 사항을 확인하세요.
- Koze 계정을 등록하고 로그인했는지 확인하세요.
- API 관리 페이지에서 API 키를 생성했는지 확인하세요.
- Codex CLI를 설치했는지 확인하세요. (
npm install -g @openai/codex)
🚀 1단계: Codex 구성 파일 설정
~/.codex/config.toml 파일의 시작 부분에 다음 구성을 추가하세요.
model_provider = "koze"
model = "gpt-4.1"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.koze]
name = "koze"
base_url = "https://api.kozeai.com/v1"
wire_api = "responses"
requires_openai_auth = true
💡 팁: `
https://api.kozeai.com/v1`을 실제 Koze 프록시 주소로 바꾸세요. `model` 필드에서 플랜에 따라 다른 모델을 선택할 수 있습니다.
🔑 2단계: API 키 설정
~/.codex/auth.json 파일에 API 키를 설정하세요.
{
'OPENAI_API_KEY': 'Koze API 키'
}
🎯 3단계: Codex 시작
설정 후 터미널에서 Codex를 직접 실행하세요.
codexCodex CLI는 API 요청에 Koze 프록시를 자동으로 사용합니다.
📌 사용 가능한 모델
설정 파일의 `model` 필드에서 다음 모델을 사용할 수 있습니다.
| 모델 이름 | 설명 |
|---|---|
gpt-5.3-codex |
gpt-5.3-codex, 일상적인 프로그래밍 작업에 적합 |
gpt-5.4-mini |
GPT-4.1 Mini, 가성비 우수 |
gpt-5.4 |
GPT-5.4 멀티모달 모델 |
⚠️ 자주 묻는 질문
| 문제 | 해결 방법 |
|---|---|
| 팁: "인증 실패" | auth.json 파일의 API 키가 올바른지 확인하세요 |
config.toml이 작동하지 않습니다 |
구성이 파일 시작 부분에 작성되었는지, 그리고 model_provider 이름이 [model_providers.xxx]와 일치하는지 확인하세요
|
| Nginx 안티 프로토타입을 사용하면 실패합니다. | Nginx `http` 블록에 `underscores_in_headers on;`을 추가하세요. 그렇지 않으면 Nginx는 기본적으로 밑줄이 포함된 요청 헤더를 무시합니다. |