Codex 설정

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

GPT 모델에는 Codex 채널 키를 사용하세요.

모델과 현재 요금

설정된 GPT 모델에는 Codex 키를 사용하세요. 전체 모델 요금에서 가격 페이지를 확인하고, Sol과 Terra 비교에서 두 모델의 차이와 호환되는 추론 설정을 확인하세요.

현재 쿼터 요금은 AI in IDE에 설정된 모델 가격 × Codex 채널 배율이며 공급자 참고 가격과 다를 수 있습니다. Sol과 Terra 페이지의 현재 쿼터 요금을 확인하세요. 쿼터 소비와 구매 시 지불하는 금액은 별개입니다. 비용 계산기에서 구매 비용을 추정할 수 있습니다.

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

GPT-6.1 Terra에도 같은 컨텍스트 및 처리 등급 규칙이 적용됩니다. 기본 요금은 공식 모델 문서를 참고하세요. GPT-5.6과 GPT-6의 캐시 쓰기는 30분 보관 시 입력 요금의 1.25배, 12시간 보관 시 2.5배입니다. prompt_cache_options.ttl 또는 prompt_cache_breakpoint.ttl을 "12h"로 설정할 수 있으며, 보관 시간이 섞이면 응답의 시간별 쓰기 토큰 수로 정산합니다. 캐시 문서를 참고하세요.

GPT-5.6 및 GPT-6의 Fast 요금은 표준 요금의 2배입니다. 이 모델들의 Flex는 0.5배이며 응답의 service_tier로 청구합니다. 생략 시 default를 전송합니다. ultrafast 등 가격이 설정되지 않은 티어는 거부됩니다. OpenAI Fast 요금을 참고하세요.

토큰 요금 외에 내장 Web search는 검색 1회당 $0.010가 부과됩니다(Codex 채널의 1배 계수 적용 후). 비추론 모델의 미리 보기 검색은 회당 $0.025입니다. Chat 검색 모델에도 검색 요금이 적용됩니다. 검색 결과 페이지 열기에는 별도의 검색 호출 요금이 없습니다. 벡터 저장소의 소유자를 확인할 수 없어 File search는 비활성화되어 있습니다. 호스팅 Code Interpreter, 호스팅 shell, 이미지 생성 도구는 별도 사용 요금을 여기서 정확히 계산할 수 없어 이 채널에서 사용할 수 없습니다. OpenAI 도구 요금을 참고하세요.

GPT-5.6, GPT-6에서 max_output_tokens를 생략하면 기본값은 32,768입니다(명시적으로 최대 128,000까지 지정 가능). 모든 Codex 모델에서 내장 검색 도구는 max_tool_calls를 지정하지 않으면 최대 5회로 제한됩니다. 각 요청에 대화 기록을 직접 포함하세요. 모든 Codex 모델은 저장된 컨텍스트(previous_response_id, conversation, 프롬프트 ID), 이전 오디오 ID 및 원격 파일·이미지 참조를 거부합니다.

연결이 끊어지면 전체 요청 제한 시간인 15분 안에서 최종 사용량을 최대 15초 더 기다립니다. 저장된 응답은 원래 작업 ID로 나중에 조회하며 확인된 실제 사용량으로 정산합니다.

Responses의 max_tool_calls는 검색 호출을 0–20회로 제한합니다. 공유 자격 증명으로는 비공개 터널, 원격 MCP 도구, 사용자 지정 음성 ID를 사용할 수 없습니다. 지원 모델의 오디오와 텍스트에는 별도 토큰 요율이 적용됩니다.

API 키와 결제에 사용하는 잔액이 모두 0보다 크면 생성 요청을 보냅니다. 요청에 설정한 출력 및 도구 한도는 그대로 전달하고 실제 사용량으로 정산합니다. 동시 요청으로 잔액이 음수가 될 수 있습니다.

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-6.1-sol"
3
model_reasoning_effort = "high"
4
disable_response_storage = true
5
 
6
[model_providers.aiinide]
7
name = "AI in IDE"
8
base_url = "https://api.aiinide.com"
9
wire_api = "responses"
10
requires_openai_auth = true
11
 
12
[features]
13
web_search_request = true

이 설정 예시는 gpt-6.1-sol을 사용합니다. gpt-5.5는 제공이 종료되었습니다. CLI가 Base URL 뒤에 /responses를 붙입니다.

기존 Base URL의 /api/codex 및 /api/gemini 접두사도 기존 키로 계속 사용할 수 있습니다.

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://api.aiinide.com/responses
1
export CODEX_API_KEY="YOUR_DASHBOARD_API_KEY"
2
 
3
curl --globoff --fail-with-body 'https://api.aiinide.com/responses' \
4
  -H "Authorization: Bearer $CODEX_API_KEY" \
5
  -H "Content-Type: application/json" \
6
  -d '{"model":"gpt-6.1-sol","input": "Rewrite this sentence in plain English: The application facilitates the modification of account settings.","reasoning": {"effort": "low"}, "max_output_tokens": 4096}'

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

1
curl --globoff --fail-with-body -N 'https://api.aiinide.com/responses' \
2
  -H "Authorization: Bearer $CODEX_API_KEY" \
3
  -H "Content-Type: application/json" \
4
  -d '{"model":"gpt-6.1-sol","input": "Explain this JavaScript function in one sentence: function add(a, b) { return a + b; }","reasoning": {"effort": "low"}, "max_output_tokens": 4096, "stream":true}'

이 예제에는 필요한 입력이 모두 포함되어 있으며 로컬 저장소를 읽지 않습니다. 일반 응답은 status: "completed"와 output[].content[], 스트리밍은 response.completed 이벤트를 확인하세요. 출력 한도에 도달하면 incomplete_details.reason을 확인하세요. 추론 토큰도 한도에 포함됩니다. 사용 기록에서 사용량을 확인할 수 있습니다.

Chat Completions

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

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

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

문제 해결

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