Qoder 사용자 지정 모델: Claude와 GPT

Qoder는 알리바바의 Agentic IDE입니다. Code By AI를 OpenAI 호환 공급자로 추가하면 하나의 Code By AI 키로 Claude와 GPT 모델을 실행할 수 있습니다.

Qoder는 Models 설정에서 BYOK(Bring Your Own Key) 모델을 지원합니다. 사용자 지정 공급자 양식이 OpenAI 호환 base URL을 받으므로, Code By AI 하나로 두 모델 패밀리를 모두 처리할 수 있습니다. GPT ID는 Codex 채널로, claude-* ID는 Claude 채널로 전달되어 Claude 요금으로 과금됩니다.

명령 하나로 설정할 수 있나요?

setup.sh는 Qoder를 구성하지 않습니다. BYOK 공급자와 자격 증명은 Qoder 계정 카탈로그가 관리하며, Qoder CLI 문서도 settings.json에 직접 쓰지 말라고 명시합니다. 아래 UI 단계를 사용하세요.

1. Code By AI API 키 만들기

Code By AI에 로그인하고 API Keys 페이지에서 키를 만듭니다. sk-proj-... 형식입니다.

2. 사용자 지정 공급자 추가하기

1. Qoder Settings를 엽니다.
2. 왼쪽 탐색에서 Models를 선택합니다.
3. Add model을 클릭합니다.
4. Provider에서 Custom → OpenAI Compatible을 고른 뒤 Chat Completions API를 선택합니다.
5. Base URL에 https://www.codebyai.net/api/agent/v1을 입력합니다.
6. Code By AI API 키를 붙여 넣습니다.
7. 모델 ID gpt-5.6-terra를 추가합니다.
8. 필요하면 Display name을 지정합니다.
9. Qoder가 표시하는 컨텍스트 윈도와 기능을 설정합니다. 확실하지 않으면 기본값을 두고, Vision과 Thinking은 실제로 지원하는 모델에만 켭니다.
10. Validate and add model을 클릭합니다.

Qoder가 요구하는 것은 완전한 엔드포인트가 아니라 base URL입니다. /api/agent/v1을 그대로 붙여 넣으세요. Chat Completions 경로는 Qoder가 추가합니다.

3. 같은 공급자에 Claude 모델 추가하기

Add Model ID를 클릭하고 claude-sonnet-5를 입력합니다. 같은 base URL이 두 패밀리를 모두 처리하므로 Claude와 GPT에 공급자 항목 하나면 충분합니다. 사용할 ID는 Model Plaza에서 추가하세요.

Chat Completions API 대신 Responses API를 선택해도 base URL은 같습니다. 게이트웨이는 /api/agent/v1/responses도 라우팅합니다. 다만 대부분의 서드파티 OpenAI 호환 클라이언트는 Chat Completions를 구현하므로, 기본값으로는 이쪽이 안전합니다.

4. 모델 선택하기

채팅을 열고 모델 선택기에서 새 모델을 고른 뒤 짧은 요청을 보냅니다. 정상 응답이 오면 키, base URL, 모델 ID가 모두 맞습니다.

과금

사용자 지정 모델 트래픽은 Code By AI가 과금하며 Qoder Credits를 쓰지 않습니다. Qoder의 Repo Wiki는 자체 고정 모델을 계속 사용하고 Credits를 소비합니다. 사용자 지정 모델을 추가해도 이 동작은 바뀌지 않습니다.

문제 해결

• 검증 실패 — Base URL에 /chat/completions가 붙어 있지 않은지, 키 앞뒤에 공백이 없는지, 모델 ID가 Model Plaza와 정확히 일치하는지 확인하세요.
• 404 — Base URL이 완전한 엔드포인트이거나 /v1이 중복되었습니다. https://www.codebyai.net/api/agent/v1을 사용하세요.
• 401 — 키가 유효하지 않거나 삭제·만료되었습니다.
• 잔액 부족 — Wallet 페이지에서 충전하세요.
• Claude 모델이 GPT처럼 동작하거나 과금됨 — 모델 ID가 claude-로 시작하는지 확인하세요. 게이트웨이는 이 접두사로 채널을 고릅니다.

모델 하나에는 경로 하나만 사용하세요. 같은 모델 ID를 Chat Completions와 Responses 양쪽에 추가해도 기능은 늘지 않고 문제 진단만 어려워집니다.