Trae 사용자 지정 모델: API 키 하나로 Claude와 GPT 사용하기

Code By AI 키 하나면 Trae 안에서 Claude와 GPT를 토큰 단위로 사용할 수 있습니다. 구독도, 벤더별 API 계정도 필요 없습니다.

실시간 카탈로그의 토큰 요금: Claude는 공식 가격의 1/4, GPT/Codex 텍스트 모델은 1/10입니다. 가격 보기모델 둘러보기

공식 구독, 공식 API, Code By AI 비교

여기에는 정성적인 차이만 정리했습니다. 이 페이지는 요금제 가격을 인용하지 않습니다.

항목공식 구독공식 APICode By AI
과금 방식요금제별 고정 월 요금벤더가 토큰 사용량 기준으로 과금토큰 사용량 기준 과금, 구독 없음
계정벤더와 요금제마다 계정 하나API 사용 권한과 결제가 활성화된 벤더 계정Claude와 GPT에 쓰는 Code By AI 계정과 키 하나
모델 범위요금제가 제공하는 모델, 요금제 할당량 내에서해당 벤더의 모델을 벤더 정가로같은 OpenAI 호환 엔드포인트로 Claude와 GPT
사용 한도요금제에 묶인 할당량벤더의 속도 제한과 선불 크레딧잔액에서 차감하고 소진되면 충전
비용 구조할당량 사용 여부와 무관한 고정 월 요금벤더의 토큰당 정가종량제: Claude는 공식 가격의 1/4, GPT/Codex 텍스트는 1/10

Trae 설정

Trae는 ByteDance의 AI IDE이며 사용자 지정 모델을 앱 내부에 보관하므로 setup.sh로 설정할 수 없습니다. 모델 관리 화면에서 엔드포인트와 키를 추가하세요. Trae 공식 사이트

  1. 1. API 키 만들기

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

  2. 2. 모델 설정 열기

    Trae에서 Settings → Models를 열고 Add model을 클릭합니다. 채팅의 모델 선택기에서도 같은 관리 화면이 열립니다.

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

    Custom configuration을 선택하고 API format을 OpenAI Chat Completions로 설정합니다. Full URL이 꺼진 상태에서 요청 URL에 https://www.codebyai.net/api/agent/v1을 입력하고, 키를 붙여 넣고, 모델 ID를 gpt-5.6-terra로 설정합니다. 모델을 저장한 뒤 채팅의 모델 선택기에서 선택하세요.

  4. 4. 전체 경로를 붙여 넣을 때만 Full URL을 켜세요

    Full URL이 꺼져 있으면 Trae가 /chat/completions를 직접 붙입니다. 켜는 경우에는 대신 https://www.codebyai.net/api/agent/v1/chat/completions을 입력하세요. 둘을 섞으면 요청이 404를 반환합니다.

  5. 5. Claude 추가하기

    같은 URL과 키로 두 번째 구성을 추가하고 모델 ID를 claude-sonnet-5로 설정합니다. 게이트웨이는 claude-* ID를 Claude 채널로 라우팅하고 Claude 요금으로 과금하므로 두 패밀리가 하나의 엔드포인트를 공유합니다.

  6. 6. 확인하기

    새 채팅에서 짧은 메시지를 보낸 뒤 사용 내역에서 토큰 사용량이 늘어난 모델의 이름이 Trae에 입력한 ID와 일치하는지 확인하세요. ID에 오타가 있으면 HTTP 400이며 다른 모델이 응답하지 않습니다.

Base URL(Full URL 꺼짐): https://www.codebyai.net/api/agent/v1
Full URL(스위치 켜짐): https://www.codebyai.net/api/agent/v1/chat/completions
모델 ID: gpt-5.6-terra / claude-sonnet-5

SOLO: AUTO를 먼저 끄세요

SOLO에서는 사용자 지정 모델을 고르기 전에 AUTO를 끄세요. 그렇지 않으면 에이전트가 내장 모델로 계속 라우팅할 수 있습니다.

Trae 가이드 읽기

자주 묻는 질문

Trae에서 보낸 요청의 요금은 Code By AI에서 어떻게 계산하나요?
Trae가 Code By AI 키로 요청을 보내면 사용한 토큰의 요금이 잔액에서 차감됩니다. 사용 내역에서 사용량과 요금을 확인할 수 있습니다.
API 키는 어디에 넣나요?
Trae 모델 관리 화면의 사용자 지정 구성 인증 정보 필드에 붙여 넣습니다. Trae는 사용자 지정 모델을 앱 내부에 저장하므로 setup.sh가 안전하게 수정할 파일이 없고, 키를 저장소에 커밋해서는 안 됩니다.
SOLO에서 사용자 지정 모델이 무시되는 이유는 무엇인가요?
AUTO가 아직 켜져 있을 가능성이 큽니다. 사용자 지정 모델을 고르기 전에 AUTO를 끄세요. 그렇지 않으면 에이전트가 내장 모델로 계속 라우팅할 수 있습니다.
요청이 404를 반환하는 이유는 무엇인가요?
요청 URL과 Full URL 스위치가 서로 어긋났습니다. Full URL을 끄고 base URL을 쓰거나, 켜고 전체 /chat/completions URL을 사용하세요. 둘을 섞지 마세요.
요청에 403 오류가 발생하면 어떻게 하나요?
오류 메시지를 확인하세요. “Invalid key”라면 붙여 넣은 키가 맞는지 확인하고, 삭제되었거나 만료된 키는 교체하세요. API 키 할당량을 언급하면 API Keys에서 해당 키의 한도를 확인하세요. 잔액 부족이나 사용자 할당량을 언급하면 지갑에서 잔액을 확인하고 필요할 때 충전하세요.
Claude와 GPT는 어떻게 전환하나요?
모델별로 사용자 지정 구성을 하나씩 저장하세요. 두 구성에 같은 엔드포인트와 API 키를 사용하고 각각 해당 모델 ID를 입력한 뒤, 채팅의 모델 선택기에서 원하는 모델로 전환하세요.

위 단계와 오류 코드는 Trae 가이드를 따릅니다. Trae 가이드 읽기

Code By AI 키로 Trae 사용해 보기

키를 만들고 잔액을 충전하면 Claude와 GPT를 엔드포인트 하나로 사용할 수 있습니다.