Trae + JoinGonka Gateway — AI-IDE에서 Gonka 네트워크 모델 활용하기

Trae는 에이전트, 자율형 SOLO 모드, 그리고 월간 한도에서 차감되는 내장 모델 세트를 갖춘 AI-IDE입니다. 2026년 8월부터 데스크탑 환경은 문서에서 TraeCode로 지칭됩니다. 인터페이스나 도움말에서 이 이름을 보더라도 동일한 IDE를 의미합니다.

내장 모델 외에도 Trae는 자체 모델을 사용할 수 있습니다. Add Model 창에는 Custom Model 옵션이 있어 API 형식, 요청 주소, 모델 ID 및 키를 지정할 수 있습니다. OpenAI Chat Completions와 Anthropic Messages 두 가지 형식을 지원하며, JoinGonka Gateway는 하나의 키로 두 형식 모두를 처리합니다. 이를 통해 Trae 에이전트는 분산형 Gonka 네트워크의 모델을 네트워크의 실시간 가격에 따른 토큰 결제로 이용할 수 있습니다. 등록 및 주소 확인 후 계정에 3M의 무료 토큰이 지급되며, 이는 프로젝트에서 연동을 테스트하기에 충분한 양입니다.

아래 메뉴 항목과 필드 명칭은 영어 인터페이스 기준 Trae 공식 문서를 따릅니다. 현지화된 인터페이스에서는 이름이 번역될 수 있으나 단계는 동일합니다.

준비 사항: Trae 빌드, 버전 및 키

빌드 및 버전. Trae는 국제 버전(docs.trae.ai)과 중국 버전(docs.trae.cn) 두 가지 브랜치가 있습니다. Custom Model 폼은 양쪽 모두 존재하며 구조가 동일합니다. 다만 내장 모델과 추가 설정의 프리셋이 다를 수 있습니다. 자체 모델 요청 주소는 2026년 4월 14일자 버전 3.5.51부터 지원되므로, 이전 빌드를 사용 중이라면 업데이트하십시오. 국제 버전 빌드는 모든 국가에서 이용 가능한 것은 아니므로, 설치 전 지원되는 국가 및 지역 목록을 확인하십시오.

시스템. macOS 12 이상, Windows 10 또는 11 (x64), .deb 및 .rpm 패키지의 Linux. Trae를 처음 실행하면 테마 및 언어 선택, VS Code 또는 Cursor에서의 설정 가져오기, 계정 로그인을 진행하게 됩니다.

JoinGonka 키. 게이트웨이에 등록한 후 대시보드의 'API-keys' 섹션에서 'Create key'를 클릭합니다. 키는 jg-로 시작하며 한 번만 표시되므로 즉시 저장하십시오. Trae 전용 키를 따로 생성하는 것이 관리하기 좋습니다. 'Usage' 섹션에서 해당 사용량을 별도의 항목으로 확인할 수 있습니다.

Trae 플랜. 자체 모델은 목록에서 수동으로 선택해야 하며, Trae 요금제 표에서 무료 플랜의 모델 선택 행에는 Auto 모드만 기재되어 있고 여기서는 자체 모델을 사용할 수 없습니다. 이 제한이 자체 키로 추가된 모델에도 적용되는지 여부에 대해서는 문서에 명시되어 있지 않습니다. 실무적인 규칙은 간단합니다. 플랜에서 모델 목록의 Auto 모드를 끌 수 있다면 준비가 완료된 것이며, 그렇지 않다면 유료 플랜이 필요합니다.

연결: Settings → Models → Add Model → Custom Model

Settings → Models를 엽니다 — 모델 관리 패널입니다.
Add Model을 클릭합니다. 열린 창에서 미리 준비된 목록의 프로바이더가 아니라 Custom Model을 선택합니다.
표의 값으로 필드를 채웁니다. 열은 API 형식별로 두 개이므로 하나를 선택합니다.
Add Model을 클릭합니다. Trae가 테스트 API 호출을 보내 키를 검증합니다. 성공하면 모델이 목록에 나타나고, 실패하면 오류 메시지와 프로바이더 응답 로그가 표시됩니다.

필드	OpenAI 형식	Anthropic 형식
API Format	`OpenAI Chat Completions`	`Anthropic Messages`
Custom Request URL, Full URL 토글 꺼짐	`https://gate.joingonka.ai/v1`	`https://gate.joingonka.ai`
Custom Request URL, Full URL 토글 켜짐	`https://gate.joingonka.ai/v1/chat/completions`	`https://gate.joingonka.ai/v1/messages`

나머지 필드는 형식에 관계없이 동일합니다:

필드	값	설명
Model ID	`deepseek-ai/DeepSeek-V4-Flash-0731`	게이트웨이가 반환하는 정확한 모델 식별자
Display Name	`DeepSeek V4 Flash (Gonka)`	모델 목록에 표시되는 이름. 없으면 Trae는 Model ID를 표시합니다
API Key	`jg-your-key`	하나의 키로 두 형식 모두 사용 가능

어떤 형식을 선택할까. OpenAI Chat Completions부터 시작하세요. 이것이 게이트웨이의 주요 경로이며 대부분의 도구가 이 방식으로 작동합니다. Anthropic Messages는 다른 도구에서 이 형식에 익숙하거나 두 프로토콜에서 에이전트 동작을 비교하고 싶을 때 유용합니다 — 키와 잔액은 공통입니다.

Full URL의 작동 방식. 이 토글은 누가 경로를 추가하는지를 결정합니다. 꺼짐 — 기본 주소를 입력하면 Trae가 선택한 형식에 따라 경로를 추가합니다: OpenAI의 경우 /v1이 붙은 주소에 /chat/completions를, Anthropic의 경우 루트에 /v1/messages를 추가합니다. 켜짐 — 주소가 그대로 사용되며 경로 전체가 주소에 포함되어야 합니다. 가장 흔한 실수는 모드를 혼동하는 것입니다: 토글이 꺼진 상태에서 전체 경로를 입력하거나, 켜진 상태에서 기본 주소를 입력하는 경우입니다.

하나의 항목 = 하나의 모델. 네트워크의 다른 모델들에도 같은 단계를 반복하면 설정으로 돌아가지 않고 전환할 수 있습니다: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7, zai-org/GLM-5.3-Flash. 최신 목록은 GET https://gate.joingonka.ai/v1/models로 받을 수 있습니다. 추가한 모델은 나중에 편집하거나, 비활성화하거나(패널에는 남지만 채팅 목록에서는 사라집니다), 삭제할 수 있습니다.

추가 설정 및 모델 선택

기본 필드 아래에 접을 수 있는 Advanced Settings 목록이 있습니다. 그대로 두어도 Trae가 기본값을 채워주지만, 모델 시리즈와 컨텍스트 윈도우라는 두 가지 설정은 명확하게 지정하는 것이 좋습니다.

설정	선택 기준	이유
Model Series	`Default`	시리즈 프리셋은 벤더 자체 API에 맞춰 프롬프트, 하이퍼파라미터 및 컨텍스트 윈도우를 변경합니다. 예를 들어 Deepseek-4 프리셋은 입력 제한을 616,000 토큰, 출력 제한을 384,000 토큰으로 늘리지만, 이는 네트워크 내 모델의 실제 지원 범위를 초과할 수 있습니다.
Context Window (Token)	아래 모델 표에 따라 입력	필드가 비어 있으면 Trae가 자체 기본값으로 채웁니다. 수동으로 설정하면 우선순위를 가지며, 모델이 허용하는 범위를 초과하여 에이전트가 컨텍스트를 쌓는 것을 방지합니다.
Image Input Support	끄기	네트워크 내 모델은 텍스트 모델입니다. 끄기로 설정하면 Trae가 자동으로 모델이 이미지를 지원하지 않음을 경고합니다.
Thinking Mode	`Follow model default`	추론(Thinking)은 모델 자체가 관리합니다. GLM-5.3 Flash는 기본적으로 켜져 있습니다.
Tool Call Rounds, Hyperparameters	비워두기	기본값으로 충분합니다. Temperature, Top P, Top K는 필요시 나중에 조정할 수 있습니다.

네트워크 내 모델은 가격이 동일하므로 선택의 기준은 동작 방식입니다. 표에 있는 모든 모델은 Trae 에이전트 작업의 핵심인 네이티브 Tool Calling을 지원합니다.

모델	Model ID	컨텍스트 윈도우: 입력 / 출력	Trae 사용 시점
DeepSeek V4 Flash	`deepseek-ai/DeepSeek-V4-Flash-0731`	380000 / 32768	에이전트 기본 모델: 대형 리포지토리, 장시간 세션, 대용량 파일 생성 등 네트워크 내 가장 큰 응답 제한을 제공합니다.
MiniMax M2.7	`MiniMaxAI/MiniMax-M2.7`	200000 / 8192	빠른 수정, 코드 질문, 코드 조각 설명 등 짧은 '질문-응답' 주기.
GLM-5.3 Flash	`zai-org/GLM-5.3-Flash`	390000 / 8192	추론 모델: 답변 전 스스로 추론합니다. 설계, 복잡한 디버깅, 외부 아키텍처 분석 시 사용하며, 출력 제한의 일부가 추론 과정에 소비됩니다.

추론 예산이 어떻게 구성되는지, 왜 추론 모델의 출력 제한을 낮게 설정하면 안 되는지에 대해서는 GLM-5.3 Flash 개요를 참조하십시오. 개발 작업에서의 모델 비교는 코딩을 위한 최고의 AI 모델 기사에서 확인할 수 있습니다.

검증 및 진단

사용자 지정 모델은 공통 목록에 있습니다. 채팅 입력창 오른쪽 하단에 있는 현재 모델 이름을 클릭하고 추가한 모델을 선택하세요. 그곳에 Auto Mode 스위치도 있는데, 이를 꺼야 합니다. Auto 모드에서는 Trae가 기본 제공 모델을 자동으로 선택하므로, 사용자가 추가한 모델은 사용되지 않기 때문입니다.

도구가 필요한 작업을 에이전트에게 시켜보세요. 예: "package.json을 읽고 빌드 스크립트를 나열해줘". 에이전트가 파일을 열고 정확히 답변한다면 게이트웨이를 통한 "요청 - 도구 호출 - 응답" 루프가 정상적으로 구성된 것입니다. 그 후 게이트웨이 대시보드의 "사용량(Usage)" 섹션을 엽니다. "키별(By Key)" 블록에서 Trae 키의 요청 수와 마지막 접근 시간을, "모델별(By Model)" 블록에서 선택한 모델을 확인할 수 있습니다.

무언가 잘못되었다면 오류 텍스트를 확인하세요. Trae는 사용자 지정 모델의 답변을 숨기지 않습니다. 공급자의 오류를 그대로 보여주며 자체 코드 4028을 표시합니다.

표시 내용	의미	조치 방법
`401`, `Invalid API key` — Add Model 창 또는 채팅 내	게이트웨이가 키를 인식하지 못함	키가 `jg-`로 시작하고 공백 없이 입력되었으며, "API 키" 섹션에서 활성화되어 있는지 확인하세요
`404`, `Invalid URL (POST …)`	경로에 불필요한 세그먼트가 있음. 게이트웨이는 오류 텍스트에 요청이 도달한 곳을 표시합니다	주소를 표와 대조하세요. 전체 경로는 Full URL이 활성화된 경우에만 허용되며, Anthropic 형식의 기본 주소에는 `/v1`을 넣지 마세요
`405 Not Allowed`, `301` 또는 응답 대신 HTML	요청이 API를 거치지 않음. OpenAI 형식의 경우 기본 주소에서 `/v1`이 누락되었거나 Full URL 활성화 시 기본 주소만 지정된 상태	주소를 표 형식 중 하나로 맞추세요. Full URL 비활성화 시 기본 주소, 활성화 시 전체 경로를 사용합니다
코드 984, `Incorrect model name`	Model ID가 게이트웨이의 식별자와 일치하지 않음	모델 표에서 식별자를 한 글자씩 복사하세요
코드 4028 및 `429`가 포함된 텍스트	모델 과부하: 피크 시간에는 특정 모델의 네트워크 용량이 모두 소진될 수 있음	몇 초 후 다시 시도하거나 다른 모델로 전환하세요. 네트워크 상태는 상태 페이지에서 확인할 수 있습니다
코드 4054, `Model Request failed`	사용자 지정 모델에 대한 요청이 도달하지 않거나 중단됨	상태 페이지를 통해 게이트웨이 사용 가능 여부를 확인하고, Edit을 통해 모델 등록 설정(형식, 주소, 식별자)을 대조하세요
코드 7000: 모델이 이미지를 인식하지 못함	메시지에 이미지가 첨부되었으나 네트워크 모델이 텍스트 전용임	이미지를 제거하거나 해당 작업에 시각 기능이 있는 내장 모델을 선택하세요
사용자 지정 모델을 선택했는데 다른 모델이 답변함	Auto Mode가 활성화됨	모델 목록에서 끄세요

비용 안내

IDE 내 에이전트는 채팅보다 토큰을 더 빠르게 소비합니다. 각 요청마다 시스템 지침, 도구 설명, 열린 파일 및 단계 기록이 포함되기 때문입니다. 따라서 토큰당 가격은 에이전트를 사소한 작업마다 실행할지, 아니면 아껴야 할지를 결정하는 기준이 됩니다.

JoinGonka Gateway를 통하면 토큰당 가격은 입력 100만 개당 $0.0069, 출력 100만 개당 $0.021입니다. 이 가격은 네트워크 내 모든 모델에 동일하게 적용되며 실시간 소스에서 이 페이지로 반영됩니다. 2026년 9월 가격 기준 예시는 다음과 같습니다:

시나리오	소비량	Gateway 통과 시
일회성 작업: 파일 읽기 및 수정	수만 토큰	1센트 미만
에이전트와 함께하는 활발한 개발 하루	3-7M 토큰	몇 센트
매일 개발 업무 (한 달)	~150M 토큰	1~2달러 내외

Trae 자체 가격과 비교하면 더 명확합니다. 기본 제공 모델에도 오픈 모델이 포함되어 있으며, Trae는 100만 토큰당 가격표를 게시합니다. DeepSeek-V4-Flash와 MiniMax-M2.7은 입력 $0.30, 출력 $1.20이지만, GLM-5.3 Flash는 국제 버전 내장 목록에 없습니다. 게이트웨이를 통하면 같은 모델이라도 입력에서 약 ×43, 출력에서 약 ×58의 차이가 납니다.

방법	계산 방식	제한 사항
Trae 기본 모델	Trae 가격표에 따른 토큰 기반, 월간 Dollar Usage 한도 존재; 한도 초과 시 On-Demand Usage 추가 요금	요금제 한도 및 가격
사용자 지정 모델 + JoinGonka Gateway	네트워크 가격에 따른 토큰 기반, 게이트웨이 잔액에서 차감	잔액만 고려: 소비량은 일별, 키별, 모델별로 대시보드에서 확인 가능

사용 시 참고 사항

모델 리스트가 있는 곳에서는 자체 모델이 작동합니다. 채팅 및 에이전트 모드 모두(IDE 및 SOLO 모드 포함, SOLO 모드는 3.3.0 버전부터 자체 모델 지원)에서 가능합니다. 자동 완성 및 수정 예측은 별도의 설정 패널이 있는 독립적인 CUE 메커니즘에 의해 처리됩니다. 이 메커니즘에서는 모델을 선택할 수 없으며 제한 사항은 Trae 요금제에 의해 설정됩니다.

도구 및 MCP. Trae 에이전트는 MCP 클라이언트로 작동하며, 연결된 서버는 자체 모델을 사용하는 동안에도 에이전트가 사용할 수 있습니다. 네트워크의 모든 모델은 네이티브 도구 호출을 지원합니다. Trae가 도구 인수 스키마가 모델과 호환되지 않는다고 알리는 경우(코드 4027), 네트워크 내의 다른 모델이나 다른 MCP 서버를 시도해 보세요.

TraeWork. 별도의 애플리케이션인 TraeWork에서도 자체 모델 추가 양식은 동일하지만, 문서에 따르면 TraeWork Desktop에서만 작동하며 로컬 환경의 작업에만 국한됩니다.

타 에디터용 플러그인. VS Code 및 JetBrains용 TraeCode 플러그인 문서에는 자체 모델에 대한 섹션이 없습니다. 이 가이드는 데스크톱 IDE에 관한 것입니다. VS Code를 계속 사용하는 경우 Cline과 같은 에이전트 확장을 통해 동일한 게이트웨이를 연결할 수 있습니다.

개인정보 보호. Privacy Mode 설정(Settings → Account)은 Trae가 귀하의 대화와 코드 조각을 어떻게 처리할지 관리합니다. 이 모드를 사용하면 데이터가 분석 및 학습에 사용되지 않습니다. 게이트웨이 측에서는 대화 내용이 저장되지 않으며, 프롬프트와 응답은 완료 후 유지되지 않습니다. 관리 화면에는 요청 및 토큰 카운터만 표시됩니다.

이미지 작업이 필요한 경우(레이아웃, 오류 스크린샷 등)는 시각 기능이 있는 내장 모델에 작업을 맡기고, 코드, 명령어 및 파일은 네트워크 모델에 맡기세요. 모델 리스트에서 클릭 한 번으로 전환할 수 있습니다.

Trae는 Settings → Models → Add Model → Custom Model을 통해 JoinGonka Gateway에 연결합니다. OpenAI Chat Completions 형식은 주소를 https://gate.joingonka.ai/v1 으로, Anthropic Messages는 https://gate.joingonka.ai 로 설정하고, 모델 식별자와 jg- 키를 입력합니다. 'Full URL' 스위치는 경로를 누가 완성할지 결정하므로 모드를 혼용하지 마세요. 추가 설정에서 시리즈는 'Default'로 두고 모델에 맞는 컨텍스트 윈도우를 설정하세요(DeepSeek V4 Flash: 380000 및 32768, MiniMax M2.7: 200000 및 8192, GLM-5.3 Flash: 390000 및 8192). 또한 Auto Mode를 끄는 것을 잊지 마세요. 켜져 있으면 Trae는 자체 모델을 사용하지 않습니다.

← Warp + JoinGonka Gateway — 엔드포인트 터미널 에이전트 Cherry Studio + JoinGonka Gateway — 데스크톱 AI 클라이언트 →

더 자세히 알고 싶으세요?

다른 섹션을 탐색하거나 지금 GNK를 얻기 시작하세요.

키 및 무료 토큰 받기 →