Codex 설정

전용 Codex 채널로 Codex를 사용하세요. 대시보드에서 API 키를 만들고 유형으로 Codex를 선택한 뒤 클라이언트에 사용합니다. Codex 채널은 구매한 쿼터를 0.8배 속도로 소비하며 구매한 쿼터 자체는 바꾸지 않습니다.

Codex 키는 GPT/Codex 모델만 지원합니다. AWSQ와 CCMAX 키는 Anthropic 호환 엔드포인트를, Gemini 키는 /api/gemini를 사용해야 합니다.

지원 모델 및 가격

모델	채널	입력	캐시	출력
`gpt-6-astra`	Codex	8.00	0.80	48.00
`gpt-5.5`	Codex	4.00	0.40	24.00
`gpt-5.6-sol`	Codex	4.00	0.40	24.00
`gpt-5.6-terra`	Codex	2.00	0.20	12.00
`gpt-5.6-luna`	Codex	0.80	0.08	4.80

가격은 Codex 채널의 실제 USD/백만 토큰 요금입니다(상위 요금에 0.8배 소비 계수를 적용). 키의 구매 쿼터는 모든 요청에서 공유됩니다.

Codex CLI

Node.js 18 이상에서 공식 CLI를 설치합니다.

1 npm install -g @openai/codex
2 codex --version

macOS/Linux에서는 ~/.codex, Windows에서는 C:\Users\사용자이름\.codex에서 설정을 읽습니다. 폴더가 없으면 한 번 생성하세요.

`config.toml`

해당 폴더에 config.toml을 만듭니다.

1 model_provider = "aiinide"
2 model = "gpt-5.5"
3 model_reasoning_effort = "high"
4 disable_response_storage = true
5  
6 [model_providers.aiinide]
7 name = "AI in IDE"
8 base_url = "https://aiinide.com/api/codex"
9 wire_api = "responses"
10 requires_openai_auth = true
11  
12 [features]
13 web_search_request = true

gpt-5.5가 Codex 기본 모델입니다. 새 모델은 gpt-6-astra로 선택하고, 비용을 낮추려면 gpt-5.6-sol, gpt-5.6-terra 또는 gpt-5.6-luna로 바꾸세요. Base URL은 /api/codex에서 끝나며 CLI가 /responses를 추가합니다.

`auth.json`

같은 폴더에 대시보드에서 만든 키를 넣은 auth.json을 만듭니다.

1 {
2   "OPENAI_API_KEY": "YOUR_DASHBOARD_API_KEY"
3 }

서버의 업스트림 CODEX_API_KEY를 클라이언트에 넣지 마세요. CLI와 에디터에는 대시보드 키만 사용합니다.

Codex 시작

1 cd your-project
2 codex

공식 VS Code Codex 확장도 같은 두 파일을 사용할 수 있습니다. 설정 오류가 표시되면 파일 위치와 키 유형을 확인하세요.

Responses API

Responses 주소는 다음과 같습니다.

1 POST https://aiinide.com/api/codex/responses

1 export CODEX_API_KEY="YOUR_DASHBOARD_API_KEY"
2  
3 curl https://aiinide.com/api/codex/responses \
4   -H "Authorization: Bearer $CODEX_API_KEY" \
5   -H "Content-Type: application/json" \
6   -d '{"model":"gpt-6-astra","input":"이 저장소를 세 가지 요점으로 설명하세요.","reasoning":{"effort":"high"}}'

스트리밍은 "stream": true와 curl -N을 사용합니다.

1 curl -N https://aiinide.com/api/codex/responses \
2   -H "Authorization: Bearer $CODEX_API_KEY" \
3   -H "Content-Type: application/json" \
4   -d '{"model":"gpt-6-astra","input":"이 코드를 요약하세요.","stream":true}'

Chat Completions

OpenAI 호환 클라이언트는 다음 주소를 사용할 수 있습니다.

1 curl https://aiinide.com/api/codex/chat/completions \
2   -H "Authorization: Bearer $CODEX_API_KEY" \
3   -H "Content-Type: application/json" \
4   -d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"짧은 배포 체크리스트를 작성하세요."}],"stream":false}'

프록시는 키의 채널과 모델을 확인하고 Codex 업스트림으로 전달한 뒤 응답 후 사용량을 기록합니다. Codex 요청에는 /api/anthropic를 사용하지 마세요.

문제 해결

401: 유효하고 만료되지 않은 대시보드 키를 Authorization: Bearer ...로 전송하세요.
400: 모델명과 JSON 형식, 키의 Codex 채널 여부를 확인하세요. AWSQ/CCMAX 키는 사용할 수 없습니다.
429: 구매 쿼터, 달러 쿼터 또는 요청 한도에 도달했습니다.
503: Codex 업스트림이 일시적으로 unavailable 상태입니다. 잠시 후 다시 시도하세요.

1	`model_provider = "aiinide"`
2	`model = "gpt-5.5"`
3	`model_reasoning_effort = "high"`
4	`disable_response_storage = true`
5
6	`[model_providers.aiinide]`
7	`name = "AI in IDE"`
8	`base_url = "https://aiinide.com/api/codex"`
9	`wire_api = "responses"`
10	`requires_openai_auth = true`
11
12	`[features]`
13	`web_search_request = true`

1	`export CODEX_API_KEY="YOUR_DASHBOARD_API_KEY"`
2
3	`curl https://aiinide.com/api/codex/responses \`
4	`-H "Authorization: Bearer $CODEX_API_KEY" \`
5	`-H "Content-Type: application/json" \`
6	`-d '{"model":"gpt-6-astra","input":"이 저장소를 세 가지 요점으로 설명하세요.","reasoning":{"effort":"high"}}'`

1	`curl -N https://aiinide.com/api/codex/responses \`
2	`-H "Authorization: Bearer $CODEX_API_KEY" \`
3	`-H "Content-Type: application/json" \`
4	`-d '{"model":"gpt-6-astra","input":"이 코드를 요약하세요.","stream":true}'`

1	`curl https://aiinide.com/api/codex/chat/completions \`
2	`-H "Authorization: Bearer $CODEX_API_KEY" \`
3	`-H "Content-Type: application/json" \`
4	`-d '{"model":"gpt-5.6-terra","messages":[{"role":"user","content":"짧은 배포 체크리스트를 작성하세요."}],"stream":false}'`

1	`npm install -g @openai/codex`
2	`codex --version`

1	`{`
2	`"OPENAI_API_KEY": "YOUR_DASHBOARD_API_KEY"`
3	`}`

1	`cd your-project`
2	`codex`