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

CodeBuddy는 텐센트 클라우드의 AI 코드 편집기입니다. models.json이 완전한 OpenAI 호환 엔드포인트를 받으므로 하나의 Code By AI 키로 Claude와 GPT를 사용할 수 있습니다.

CodeBuddy는 ~/.codebuddy/models.json(사용자 수준) 또는 <workspace>/.codebuddy/models.json(프로젝트 수준)에서 사용자 지정 모델을 읽습니다. 같은 id의 프로젝트 항목이 사용자 항목을 덮어쓰며, 저장 후 약 1초 뒤 핫 리로드됩니다.

명령 하나로 설정 (macOS / Linux)

Copy
1
curl -fsSL https://www.codebyai.net/setup.sh | sh -s -- --codebuddy

API 키를 숨김 입력으로 물어본 뒤 사용자 수준의 ~/.codebuddy/models.json에 gpt-5.6-terra와 claude-sonnet-5를 추가하고, 원본 파일을 백업하며 소유자만 읽고 쓸 수 있게 합니다. CodeBuddy가 이 파일을 자동으로 다시 읽으므로 모델 선택기에서 고르기만 하면 됩니다. 다시 실행하면 키가 갱신되고, | sh -s -- --uninstall은 원래 파일을 복원합니다. 같은 id를 정의한 프로젝트 수준의 .codebuddy/models.json은 여전히 이 항목보다 우선합니다. CodeBuddy 플러그인 버전은 models.json을 읽지 않으니 IDE나 CLI를 사용하세요. 아래 수동 단계도 같은 작업을 합니다.

1. Code By AI API 키 만들기

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

2. models.json 편집하기

~/.codebuddy/models.json을 열고 기존 객체에 다음을 병합합니다. 이미 있는 모델은 유지하세요.

Copy
1
{
2
  "models": [
3
    {
4
      "id": "gpt-5.6-terra",
5
      "name": "CodeByAI GPT",
6
      "vendor": "Custom",
7
      "url": "https://www.codebyai.net/api/agent/v1/chat/completions",
8
      "apiKey": "sk-proj-xxxx",
9
      "maxInputTokens": 200000,
10
      "maxOutputTokens": 65536,
11
      "supportsToolCall": true,
12
      "supportsImages": false,
13
      "supportsReasoning": false
14
    },
15
    {
16
      "id": "claude-sonnet-5",
17
      "name": "CodeByAI Claude",
18
      "vendor": "Custom",
19
      "url": "https://www.codebyai.net/api/agent/v1/chat/completions",
20
      "apiKey": "sk-proj-xxxx",
21
      "maxInputTokens": 200000,
22
      "maxOutputTokens": 65536,
23
      "supportsToolCall": true,
24
      "supportsImages": false,
25
      "supportsReasoning": false
26
    }
27
  ]
28
}

CodeBuddy는 OpenAI 인터페이스 형식만 지원하므로 url은 완전한 Chat Completions 경로여야 합니다. Claude ID도 사용할 수 있습니다. 게이트웨이가 claude-*를 Claude 채널로 전달하고 Claude 요금으로 과금합니다.

3. 모델 선택하기

파일을 저장합니다. CodeBuddy가 자동으로 다시 읽으므로 모델 선택기에서 CodeByAI GPT 또는 CodeByAI Claude를 고릅니다. availableModels를 관리한다면 두 ID를 모두 추가하세요. 비어 있지 않은 목록에 없는 모델은 표시되지 않습니다.

모델 필드

• maxInputTokens와 maxOutputTokens는 모델의 실제 한도에 맞춥니다. 게이트웨이 모델은 200,000과 65,536을 사용합니다.
• Agent 작업에서는 supportsToolCall을 true로 유지하세요.
• supportsImages와 supportsReasoning은 선택 사항이며, 모델이 이미지 입력이나 추론 파라미터를 지원할 때만 켭니다.

문제 해결

• 404 — url이 base URL이거나 끝이 /chat/completions가 아닙니다. 완전한 https://www.codebyai.net/api/agent/v1/chat/completions를 사용하세요.
• 401 / 잘못된 키 — 키 앞뒤에 공백이 있거나 삭제·만료되었습니다. API Keys 페이지에서 새 키를 만드세요.
• 잔액 부족 — Wallet 페이지에서 충전하세요.
• 모델이 숨겨짐 — 비어 있지 않은 availableModels에 ID가 없습니다. ID를 추가하거나 목록을 제거하세요.
• 파일이 적용되지 않음 — 잘못된 JSON은 리로드를 막습니다. CodeBuddy 파일은 순수 JSON이므로 주석과 끝의 쉼표를 제거하세요.