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

WorkBuddy는 텐센트 클라우드의 데스크톱 AI Agent입니다. 사용자 지정 모델 엔드포인트를 Code By AI로 향하게 하면 하나의 키로 Claude와 GPT 모델을 실행할 수 있습니다.

WorkBuddy는 여러 모델을 내장하고 있으며 사용자 지정 OpenAI 호환 엔드포인트도 받습니다. 사용자 지정 항목에는 완전한 Chat Completions URL을 입력하므로 Code By AI 게이트웨이와 바로 맞물립니다. 설정과 API 키는 로컬에 보관됩니다.

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

먼저 WorkBuddy를 완전히 종료한 뒤 실행합니다.

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

API 키를 숨김 입력으로 물어본 뒤 ~/.workbuddy/models.json에 gpt-5.6-terra와 claude-sonnet-5를 추가하고, 원본 파일을 백업하며 소유자만 읽고 쓸 수 있게 합니다. 다시 실행하면 키가 갱신되고, | sh -s -- --uninstall은 원래 파일을 복원합니다. 완료 후 WorkBuddy를 다시 시작하고 모델 선택기에서 사용자 지정 모델을 고르세요. 아래 수동 단계도 같은 작업을 합니다.

1. Code By AI API 키 만들기

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

2. 사용자 지정 모델 설정 열기

다음 두 경로 중 하나를 사용합니다.

• Settings → Model → Custom models
• 대화 화면 하단의 모델 전환 → + Configure Custom Model

3. GPT 모델 추가하기

Add Model 페이지에서 Custom / 自定义을 선택하고 다음을 입력합니다.

• Endpoint / 接口地址: https://www.codebyai.net/api/agent/v1/chat/completions
• API Key: Code By AI 키
• Model name / 模型名称: gpt-5.6-terra
• Capabilities: 선택한 모델이 지원할 때만 tool calling, 이미지 입력, reasoning을 켭니다. Agent 작업에 쓰는 사용자 지정 모델에는 tool calling이 필요합니다.

저장하고 설정이 적용될 때까지 기다립니다. WorkBuddy는 모델마다 별도 레코드를 만들므로 Claude는 같은 양식에 ID를 더하는 대신 두 번째 레코드로 추가합니다.

4. Claude 모델 추가하기

같은 엔드포인트와 키로 사용자 지정 모델을 하나 더 추가하고 모델 이름을 claude-sonnet-5로 설정합니다. Code By AI의 Chat Completions 엔드포인트는 두 패밀리를 모두 받습니다. GPT ID는 Codex 채널로, claude-* ID는 Claude 채널로 전달되어 Claude 요금으로 과금됩니다.

5. 모델 선택하기

대화로 돌아가 모델 선택기에서 사용자 지정 모델을 고릅니다. 짧은 요청을 보내면 엔드포인트, 키, 모델 ID를 확인할 수 있습니다. GPT와 Claude 항목은 같은 선택기에서 전환합니다.

엔드포인트 세부 사항

WorkBuddy가 요구하는 것은 base URL이 아니라 완전한 Chat Completions URL입니다. /api/agent/v1/chat/completions를 끝까지 유지하세요. 기본 프로토콜 설정에서는 WorkBuddy가 주소를 검증하고 빠져 있으면 표준 /chat/completions 경로를 자동으로 붙입니다. 주소가 거부되거나 /chat/completions가 두 번 붙는다면 고급 설정에서 Custom Protocol / 自定义协议을 켜세요. 이 스위치는 입력한 URL을 그대로 사용하고 경로 검증과 자동 보완을 건너뜁니다.

과금과 개인정보

사용자 지정 모델 사용량은 Code By AI가 과금하며 WorkBuddy 크레딧은 소비하지 않습니다. 엔드포인트, 키, 모델 목록은 로컬 models.json에 저장되고 클라우드로 업로드되지 않습니다. WorkBuddy는 대화를 설정한 엔드포인트로 전달하므로 해당 트래픽에는 Code By AI의 이용 약관과 개인정보 처리방침이 적용됩니다.

문제 해결

• 404 — 엔드포인트에 /v1/chat/completions가 빠졌거나 오타가 있거나, WorkBuddy가 경로를 덧붙였습니다. 이 페이지의 URL을 그대로 복사하고, 경로가 바뀌면 Custom Protocol을 켜세요.
• 401 / 잘못된 키 — 키 앞뒤에 공백이 있거나 삭제·만료되었습니다. API Keys 페이지에서 새 키를 만드세요.
• 잔액 부족 — Wallet 페이지에서 충전하세요.
• Agent가 파일을 편집하거나 명령을 실행하지 못함 — 해당 사용자 지정 모델에서 tool calling이 꺼져 있습니다. 설정을 다시 열어 활성화하세요.
• 모델은 답하지만 Agent 루프에 들어가지 않음 — 모델 ID가 패밀리와 맞지 않을 수 있습니다. Model Plaza에서 정확한 ID를 확인하세요.