Claude, GPT, Gemini를 하나로 쓰는 통합 API
AI in IDE 계정 하나로 네 개 채널을 통해 Claude, GPT, Gemini에 연결합니다. 채널마다 베이스 URL과 계수가 다릅니다.
계정 하나, 채널 넷
키는 대시보드 API 키 페이지에서 만들 때 채널에 묶입니다. 채널은 그 키로 호출할 수 있는 모델, 요청을 받아 주는 엔드포인트 계열, 구매한 할당량이 줄어드는 속도를 결정합니다.
| 채널 | 모델 | 엔드포인트 계열 | 할당량 계수 |
|---|---|---|---|
| AWSQ | Claude: claude-opus-5-5, claude-sonnet-5-5, claude-haiku-4-5-20251001. Fable 미지원. | Anthropic Messages, OpenAI Chat Completions / Responses | 0.8배 |
| CCMAX | Claude(Fable, claude-opus-5-5, claude-sonnet-5-5 포함) | Anthropic Messages, OpenAI Chat Completions / Responses | 2배 |
| Codex | 예시 모델 gpt-6.1-sol | Responses, Chat Completions | 0.8배 |
| Gemini | Gemini Flash: gemini-3.5-flash, gemini-3.7-flash, gemini-3.8-flash | Gemini generateContent | 0.5배 |
계수는 AI in IDE의 모델 기본 요금으로 계산한 요청 비용에 곱해지는 배율입니다. 구매한 할당량 자체를 바꾸지는 않습니다. 같은 모델이라면 0.8배 채널이 2배 채널보다 잔액이 오래 버틴다는 점이 AWSQ와 CCMAX의 실질적인 차이입니다.
API Keys에서 기존 키의 채널을 바꿀 수 있습니다. 같은 요청을 AWSQ(0.8배)에서 CCMAX(2배)로 바꾸면 할당량 소모량이 2.5배가 됩니다.
베이스 URL
| 클라이언트 | 설정할 값 | 클라이언트가 붙이는 경로 |
|---|---|---|
| Claude Code, Anthropic SDK | https://api.aiinide.com | /v1/messages |
| OpenAI 호환 클라이언트 | https://api.aiinide.com/v1 | /chat/completions 또는 /responses |
| Codex CLI, Responses 클라이언트 | https://api.aiinide.com | /responses |
gemini CLI, Gemini 클라이언트 | https://api.aiinide.com | /v1beta/models/... |
실패하는 설정의 대부분은 다음 두 가지로 막을 수 있습니다.
- Anthropic 베이스 URL은 도메인까지만 씁니다.
/v1을 덧붙이면/v1/v1/messages로 요청이 나가 404이 돌아옵니다. - 키는 엔드포인트 계열을 넘나들 수 없습니다. Codex 키를
/v1/messages로, Gemini 키를/api/codex로 보내면 조용히 다른 경로로 넘기지 않고 400으로 거부합니다.
Claude Code는 Base URL에 /v1/messages를 붙입니다. 기존 연동을 위해 /api/anthropic 접두사도 지원합니다.
프로토콜별 첫 요청
Anthropic Messages
1 curl --globoff 'https://api.aiinide.com/v1/messages' \2 -H "x-api-key: YOUR_DASHBOARD_API_KEY" \3 -H "anthropic-version: 2023-06-01" \4 -H "Content-Type: application/json" \5 -d '{"model":"claude-haiku-4-5-20251001","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'
"stream":true를 더하면 스트리밍 응답이 됩니다.
OpenAI 호환 Chat Completions
1 curl --globoff 'https://api.aiinide.com/v1/chat/completions' \2 -H "Authorization: Bearer YOUR_DASHBOARD_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{"model":"claude-haiku-4-5-20251001","messages":[{"role":"user","content":"ping"}],"max_tokens":16}'
같은 키로 POST /v1/responses도 호출할 수 있습니다. 이쪽은 messages 대신 input과 max_output_tokens를 씁니다.
Codex Responses
1 curl --globoff 'https://api.aiinide.com/responses' \2 -H "Authorization: Bearer YOUR_DASHBOARD_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{"model":"gpt-6.1-sol","input":"이 저장소를 세 가지로 설명해 주세요."}'
Gemini generateContent
1 curl --globoff 'https://api.aiinide.com/v1beta/models/gemini-3.8-flash:generateContent' \2 -H "x-goog-api-key: YOUR_DASHBOARD_API_KEY" \3 -H "Content-Type: application/json" \4 -d '{"contents":[{"role":"user","parts":[{"text":"ping"}]}]}'
네 채널 모두 GET /v1/models로 OpenAI 형식의 목록을 조회할 수 있습니다. AWSQ 및 CCMAX 키만 anthropic-version 헤더로 Anthropic 형식을 요청할 수 있습니다. Codex 또는 Gemini 키로 이 헤더를 보내면 400이 반환되므로 생략하세요.
에디터와 CLI
| 도구 | 참고 문서 |
|---|---|
| VS Code | VS Code에서 Claude Code 사용하기 |
| Cursor | Cursor에서 Claude Code 사용하기 |
| JetBrains | JetBrains에서 Claude Code 사용하기 |
| Claude Code CLI | 설정 |
| Codex CLI | Codex 설정 |
| Gemini CLI | Gemini 설정 |
어느 것도 클릭 한 번으로 끝나는 설치가 아닙니다. 클라이언트를 설치하고, 베이스 URL을 지정하고, 키를 저장하는 몇 분의 복사 작업이며, 모든 것을 자동으로 설정해 주는 설치 프로그램이 아닙니다.
그대로 유지되는 것과 달라지는 것
요청의 형태는 각 사의 문서와 같습니다. JSON 본문, 스트리밍 이벤트 이름, 도구 호출 블록, 프롬프트 캐시 제어가 동일합니다. 달라지는 것은 계정 계층입니다. 과금은 대시보드의 달러 할당량에서 차감되고, 채널 계수가 적용되며, 키별 할당량과 만료가 요청을 보내기 전에 검사됩니다.
OpenAI 호환 경로에서는 Anthropic 전용 기능 몇 가지가 의도적으로 빠집니다. 백그라운드 생성, 서버에 저장되는 컨텍스트(항상 store=false), 호스팅 도구, Fast 모드, 1시간 캐시 확장입니다. 매 턴 대화 전체를 보내고, 이런 Claude 전용 기능이 필요하면 Anthropic Messages를 쓰세요.
FAQ
키 하나로 세 회사 모델을 모두 호출할 수 있나요? 아닙니다. 키는 하나의 채널에 속하고, 채널은 한 회사 계열만 담당합니다. 한 계정에서 AWSQ, CCMAX, Codex, Gemini 키를 동시에 보유할 수 있고, 각각 할당량과 만료를 따로 설정할 수 있습니다.
Anthropic, OpenAI, Google 계정이 따로 필요한가요? 아닙니다. 대시보드 키가 위에 나온 클라이언트에서 각 사의 로그인과 과금을 대신합니다.
왜 상위 오류 대신 400이 오나요? 엔드포인트가 키의 채널을 허용하는지, 해당 채널이 선택한 모델 계열을 지원하는지 확인하세요. 모델을 지정할 때는 GET /v1/models가 돌려준 정확한 ID를 사용하세요.
OpenAI 경로는 다른 모델을 쓰나요? 아닙니다. AWSQ와 CCMAX는 같은 Claude 모델을 두 프로토콜로 제공하며, 요청과 응답의 포장만 달라집니다.
가격은 어디서 나오나요? 참고 요금은 공급자가 공개한 100만 토큰당 가격입니다. 표준 사용량의 할당량은 AI in IDE에 설정된 모델 요금에 채널 배율을 곱해 차감합니다. 자세한 내용은 다음 문서를 참고하세요. Claude Code API 가격.