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	40.00
`gpt-6-sol`	Codex	1.60	0.16	8.00
`gpt-6.1-sol`	Codex	1.60	0.08	8.00
`gpt-5.5`	Codex	4.00	0.40	24.00
`codex-auto-review`	Codex	4.00	0.40	24.00
`gpt-5.6-sol`	Codex	3.20	0.32	16.00
`gpt-5.6-terra`	Codex	1.60	0.16	9.60
`gpt-5.6-luna`	Codex	0.16	0.016	0.96

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

표의 GPT-5.5, GPT-5.6, GPT-6 요금은 입력 토큰이 272K 이하인 요청에 적용됩니다. 272K를 초과하면 요청 전체의 입력 및 캐시 요금이 2배, 출력 요금이 1.5배가 됩니다. GPT-5.6과 GPT-6의 캐시 쓰기는 기본 입력 요금의 1.25배입니다. OpenAI의 GPT-5.5, GPT-5.6 Sol, Astra, GPT-6 Sol 요금을 참고하세요.

Fast는 GPT-5.6 및 GPT-6에서 표준 요금의 2배, 짧은 컨텍스트의 GPT-5.5에서 2.5배입니다. 이 모델들의 Flex는 0.5배이며 응답의 service_tier로 청구합니다. 생략 시 default를 전송하고, 명시적 auto는 Fast 가능성을 포함해 예약합니다. ultrafast 등 가격이 설정되지 않은 티어는 거부됩니다. OpenAI Fast 요금을 참고하세요.

토큰 요금 외에 내장 Web search는 검색 1회당 $0.008, File search는 호출 1회당 $0.002가 부과됩니다(Codex 채널의 0.8배 계수 적용 후). 검색 결과 페이지 열기에는 별도의 검색 호출 요금이 없습니다. 호스팅 Code Interpreter, 호스팅 shell, 이미지 생성 도구는 별도 사용 요금을 여기서 정확히 계산할 수 없어 이 채널에서 사용할 수 없습니다. OpenAI 도구 요금을 참고하세요.

GPT-5.5, GPT-5.6, GPT-6에서 max_output_tokens를 생략하면 기본값은 32,768입니다(명시적으로 최대 128,000까지 지정 가능). 모든 Codex 모델에서 내장 검색 도구는 max_tool_calls를 지정하지 않으면 최대 5회로 제한됩니다. 이 모델들과 사용량 기반 도구를 쓰는 요청은 서버에 저장된 컨텍스트(previous_response_id, conversation, 프롬프트 ID)와 원격 파일·이미지 참조를 지원하지 않습니다. 입력 사용량을 쿼터에서 미리 예약할 수 없기 때문입니다.

검색 결과 내용도 모델 입력 요금으로 청구됩니다. max_tool_calls는 0–20입니다. 가능한 후속 실행마다 최대 1,050,000 입력 토큰을 긴 컨텍스트·캐시 쓰기·티어 요금과 함께 예약하므로 최종 청구액보다 클 수 있습니다. 호출 상한을 줄이면 임시 예약액이 줄어듭니다. 완료 후 실제 사용량으로 정산하고 예약을 해제합니다.

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 계열을 사용하려면 model을 gpt-6-astra, gpt-6-sol 또는 gpt-6.1-sol로 변경하세요. 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`