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

Trae는 ByteDance의 AI IDE입니다. 사용자 지정 모델 양식이 OpenAI 호환 엔드포인트를 받으므로 하나의 Code By AI 키로 Claude와 GPT를 모두 사용할 수 있습니다.

Trae는 여러 모델을 내장하고 있으며 서드파티 엔드포인트를 위한 사용자 지정 구성을 제공합니다. API 형식, 요청 URL, 모델 ID, 인증 정보를 입력할 수 있어 Agent 동작을 바꾸지 않고 IDE를 Code By AI로 연결할 수 있습니다.

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

setup.sh는 Trae를 구성하지 않습니다. Trae는 사용자 지정 모델을 앱 내부에 저장하고 편집용 파일을 공개하지 않으므로, 스크립트로 안전하게 바꿀 수 없습니다. 아래 단계를 사용하세요.

1. Code By AI API 키 만들기

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

2. 모델 설정 열기

Trae에서 Settings → Models를 열고 Add model을 클릭합니다. 채팅의 모델 선택기에서도 같은 모델 관리 화면으로 들어갈 수 있습니다.

3. 사용자 지정 구성 추가하기

1. Custom configuration을 선택합니다.
2. API format을 OpenAI Chat Completions로 설정합니다.
3. Request URL에 https://www.codebyai.net/api/agent/v1을 입력합니다.
4. Full URL은 끈 상태로 둡니다. Trae가 /chat/completions를 추가합니다. 켜는 경우 완전한 https://www.codebyai.net/api/agent/v1/chat/completions를 입력하세요.
5. Code By AI API 키를 붙여 넣습니다.
6. 모델 ID에 gpt-5.6-terra를 입력합니다.
7. 저장하고 채팅 모델 선택기에서 선택합니다.

4. Claude 추가하기

같은 URL과 키로 두 번째 사용자 지정 구성을 추가하고 모델 ID를 claude-sonnet-5로 설정합니다. 게이트웨이는 claude-* ID를 Claude 채널로 전달하고 Claude 요금으로 과금합니다.

SOLO에서는 사용자 지정 모델을 고르기 전에 AUTO를 끄세요. 켜져 있으면 내장 모델로 계속 라우팅될 수 있습니다.

5. 확인하기

새 채팅에서 짧은 요청을 보냅니다. 정상 응답이 오면 URL, 키, 모델 ID가 맞습니다. 모델이 보이지 않으면 모델 관리 화면을 다시 열어 사용자 지정 항목이 저장·활성화되었는지 확인하세요.

문제 해결

• 404 — 요청 URL과 Full URL 스위치가 어긋났습니다. 스위치를 끄고 base URL을 넣거나, 켜고 완전한 /chat/completions를 넣으세요. 둘을 섞지 마세요.
• 401 / 잘못된 키 — 키 앞뒤에 공백이 있거나 삭제·만료되었습니다. API Keys 페이지에서 새 키를 만드세요.
• 잔액 부족 — Wallet 페이지에서 충전하세요.
• 모델 선택기에 없음 — 사용자 지정 항목이 저장되지 않았거나 SOLO의 AUTO가 켜져 있습니다.
• 도구 호출 실패 — Model Plaza에서 도구 호출을 지원하는 agentic 모델 ID를 고르세요. 게이트웨이는 두 패밀리를 Chat Completions로 처리하지만 모델 자체의 지원이 필요합니다.