Skip to main content

​
概要

Trae は ByteDance が 2025年1月にリリースした AIネイティブIDE で、プロの開発者向けの「Vibe Coding」生産性ツールとして位置付けられています。やりたいことを自然言語で伝えるだけで、AI が補完、バグ修正、プロジェクトの雛形作成、ワンクリックプレビューを担当します。Trae は 2 つのバージョンで提供されており、TRAE CN（trae.cn）と 国際版 TRAE（trae.ai）があります。さらに、SOLO シリーズ（Desktop / App / Web）では、エージェントがタスクの全ライフサイクルを引き受けます。 Trae の「カスタムモデル」機能で APIYI を接続すると、次のメリットがあります。

🔌 デュアルプロトコル対応

OpenAI と Anthropic の両方のプロバイダーを設定できます — 1つの token で2つのプロトコルに対応

🤖 400以上のモデル

GPT, Claude, Gemini, DeepSeek, Doubao, Qwen — すべて1つのゲートウェイの背後で利用できます

💰 Claude が5%オフ

token を作成する際に ClaudeCode グループを選ぶと、Claude が5%割引になり、チャージ特典と併用できます

🛡️ 安定したダイレクト接続

api.apiyi.com は中国本土から直接アクセスでき、追加のプロキシは不要です
製品情報
  • 🔗 国際版: www.trae.ai
  • 🔗 中国版: www.trae.cn
  • 👥 開発元: ByteDance
  • 📅 初回リリース: 2025年1月
  • 🧩 モード: Builder (agent) / Chat (サイドバー) / Inline Chat
  • 🌐 対応プロトコル: OpenAI, Anthropic, およびその他多数のサードパーティプロバイダー

​
主な機能

​
3つの操作モード

  • Builder mode: エージェントが引き継ぎ、ファイルの読み書き、コマンド実行、プロジェクトのスキャフォールドを行います
  • Chat mode: Cursor Chat / Cline に似たサイドバーでの会話で、Q&A やスニペットに最適です
  • Inline Chat: Cmd/Ctrl + I はエディタ内でインライン会話を開き、完了とリファクタリングへの最短ルートです

​
MCP とツール連携エコシステム

  • 外部ツールと API 向けの組み込み MCP (Model Context Protocol) サポート
  • Remote-SSH サポート — リモート開発もローカルと同じように使えます
  • プロジェクトレベルの AI の振る舞いを定義する .rules ファイル

​
カスタムモデル（このガイドの焦点）

国際版 Trae には Anthropic, OpenAI, Gemini, xAI, OpenRouter, Ollama, DeepSeek, Volcano Engine, Aliyun, Tencent Cloud, SiliconFlow, PPIO, Novita, BytePlus などのプリセットが付属しています。各プリセットでは、カスタム model ID + API key + カスタム request URL を入力できます。これが APIYI を組み込むための入口です。
APIYI 経由でルーティングする理由: Trae の組み込みモデルはリージョンとバージョンに制限があり、複数の上流アカウント間で使用状況を共有する方法もありません。APIYI なら、1つの token で OpenAI と Anthropic の両方をカバーできます。GPT と Claude を切り替えるたびに設定へ戻る必要はなく、Trae の上部バーのドロップダウンからモデルを選ぶだけです。
⚠️ モデル互換性 — セットアップ前にお読みください
  1. Trae は Responses プロトコルをサポートしていません: カスタムモデルが使えるチャネルは 2 つだけで、/v1/chat/completions（OpenAI プロトコル）と /v1/messages（Anthropic プロトコル）です。GPT-5.4 シリーズ以降、OpenAI は “reasoning + tool calling” を /v1/responses エンドポイントに制限しているため、gpt-5.4 / gpt-5.5 / gpt-5.6 は Trae の Builder / Chat（tools あり）シナリオではすべて 400 を返し、実質的に使えません。gpt-5.4 でも同様です（詳細は下の FAQ を参照してください）。
  2. OpenAI 互換の chat mode はエージェントには不向きです: 制限のない GPT モデルでも、chat mode のエージェントワークフローと高度な tool 権限への対応は不完全で、Builder mode がしばしば停止し、体験が悪化します。
  3. Trae では Claude ファミリーを推奨します: Builder mode で完全かつ安定した tool 呼び出しを備えた Anthropic のネイティブ /v1/messages プロトコルで動作するため、最優先の推奨です。
  4. Trae で動かせないモデル（最新の GPT シリーズ）は、Codex app に切り替えてください: Codex は Responses プロトコルをネイティブに話せるため、gpt-5.6-sol / gpt-5.5 がフル機能で動作します。

​
クイックスタート

​
ステップ 1: Trae をインストールする

www.trae.ai からダウンロードできます — macOS、Windows、Linux をサポートしています。国際版には GPT / Claude / Gemini のプリセットがあらかじめ同梱されています。

​
ステップ 2: APIYI Token を取得する

  1. APIYI token コンソールにアクセスします: api.apiyi.com/token
  2. 「New Token」をクリックします
  3. Claude を多く使う場合: ClaudeCode グループ を選択してください — Claude の呼び出しは 5% 割引 になり、10%-20% のチャージ特典と併用できます
  4. GPT/Gemini/DeepSeek を混在させて使う場合: Default グループ で問題ありません
  5. sk- が付いたキーをコピーします

​
ステップ 3: Trae でカスタムモデルパネルを開く

  • IDE モード: 右上の ⚙️ アイコンをクリック → 左ナビの Models → 「モデルを追加」 / 「カスタムモデル」
  • SOLO モード: チャットパネル右上の ⚙️ をクリック → Models → Add

​
ステップ 4: OpenAI プロトコルのエントリを追加する (GPT / Gemini / DeepSeek / Doubao など)

以下のように入力します。カスタムリクエスト URL には、ドメインだけでなく完全な /v1/chat/completions パスを含める必要があります: Trae カスタムモデル — OpenAI プロトコルで APIYI に接続し、リクエスト URL は https://api.apiyi.com/v1/chat/completions です
ベース URL には完全なパスが必要です: v3.3.51 以降、Trae の custom-model の baseURL フィールドは そのままの文字列 として使われます — /chat/completions を自動で付け足さなくなりました。https://api.apiyi.com や https://api.apiyi.com/v1 だけを入れるとエラーになります。
このエントリの対象モデル: gpt-5.1 / gpt-5.2、Gemini、DeepSeek、Doubao、Qwen など、chat プロトコルで制限なく使えるモデルです。gpt-5.4 およびそれ以降の GPT モデル (5.5 / 5.6 系) はここでは動作しません — 上の「モデル互換性」を参照してください。これらには Codex app を使ってください。

​
ステップ 5: Anthropic プロトコルのエントリを追加する (Claude ファミリー)

Claude Opus 4.6 / Sonnet 4.6 / Haiku 4.5 も使いたい場合は、2 つ目の provider エントリを追加します: Trae カスタムモデル — Anthropic プロトコルで APIYI に接続し、リクエスト URL は https://api.apiyi.com/v1/messages です
2 つのプロトコル、2 つのパス: OpenAI プロトコルは /v1/chat/completions を通り、Anthropic プロトコルは /v1/messages を通ります。APIYI は両方の endpoint をホストしているため、同じ token を 2 つの Trae provider エントリに同時に割り当てても競合しません。

​
ステップ 6: モデルを切り替えてコーディングを始める

エディタに戻り、上部のモデルのドロップダウンをクリックします — provider とそのすべてのモデルが表示されます。1 つ選んで、チャットを始めるか Builder モードに入ってください。

​
おすすめのモデル構成

日常のコーディング（最もコスパが高い）

Claude Sonnet 4.6（Anthropic）+ GPT-5.1（OpenAI）Sonnet 4.6 は非常に優れたコーディング性能を手頃な価格で提供し、GPT-5.1 は気軽な Chat により高速です

複雑なアーキテクチャ（フラッグシップ）

Claude Opus 4.6（Anthropic）大規模なリファクタリング、ファイル横断の分析、アーキテクチャ上の判断に最適です。Builder モードと組み合わせてください

深い推論

Claude Sonnet 4.6 Thinking / GPT-5.1 Thinking思考の連鎖を強制します。アルゴリズム、ロジックパズル、セキュリティレビューに最適です

コスト最適化（中国語圏モデル）

DeepSeek V4 / Doubao 1.5 Pro / Qwen3 CoderOpenAI プロトコル経由でルーティングされます。1 token あたりのコストが低く、自然な中国語出力が得られます
最新の GPT モデル（5.4 以降）がこの一覧にない理由: Trae は Responses プロトコルをサポートしていないため、gpt-5.4 / gpt-5.5 / gpt-5.6 は、Builder / Chat のツール呼び出しシナリオでいずれも 400 エラーになります（上の「モデル互換性」を参照してください）。それらを使う場合は Codex app をご利用ください。Trae 内のエージェントタスクでは、Claude ファミリー（ネイティブな Anthropic プロトコル）が最も信頼できる選択です。

完全なモデル一覧とコーディングのおすすめを見る

APIYI は、統一されたゲートウェイの背後で 400 以上のモデルを提供しています。モデルのおすすめページは、最新の性能と価格の比較に合わせて随時更新されています。

​
プロのヒント

1

プロバイダーのエントリは両方残してください

OpenAI と Anthropic の両方のエントリを追加しておけば、GPT/Gemini ↔ Claude を切り替えても baseURL を編集する必要がなくなります。
2

最新のモデルがドロップダウンに見つかりませんか？

Trae の組み込みモデルプリセットは、APIYI の実際の供給状況より遅れています。「カスタムモデル」を選んで ID を手入力してください — APIYI コンソールまたはモデル推奨ページで正しい ID を確認してください。
3

Builder モードでは Claude を優先してください

Claude（とくに Sonnet 4.6 / Opus 4.6）は、エージェントのワークフローにおける指示追従と複数ターンのツール呼び出しで、かなり信頼性が高いです。
4

難しいタスクには -thinking サフィックスを付けてください

モデル ID の末尾に -thinking を追加すると（例: claude-sonnet-4-6-thinking）、chain-of-thought を強制できます。Builder モードでのアーキテクチャ判断やセキュリティ監査におけるハルシネーションを大幅に減らせます。
5

グループごとに token を分けてください

Anthropic のエントリ専用に ClaudeCode-group token（95%の料金）を 1 つ作り、GPT/Gemini/DeepSeek 用には Default-group token を用意してください。課金とクォータの可視性が向上します。

​
FAQ

違いはありません — どちらのバージョンも Custom Model をサポートしており、OpenAI と Anthropic のプロバイダー項目を同時に追加できます。実際の違いは内蔵プリセットモデルだけです（CN は Doubao/DeepSeek に重点を置き、国際版は GPT/Claude/Gemini に重点を置きます）。推奨: 中国本土にいるなら TRAE CN（trae.cn）を選び、グローバルチーム向け、または海外のプリセットモデルが必要な場合は国際版 TRAE（trae.ai）を選んでください。
v3.3.51 以降、Trae はカスタムモデルの baseURL の解釈方法を変更しました。現在はリクエスト内でそのまま使用され、末尾に /chat/completions が自動付与されません。正しい例:
  • OpenAI プロトコル: https://api.apiyi.com/v1/chat/completions
  • Anthropic プロトコル: https://api.apiyi.com/v1/messages
誤り（404 かルートエラーになります）:
  • ❌ https://api.apiyi.com
  • ❌ https://api.apiyi.com/v1
はい。Anthropic プロバイダー項目にも「Custom Model」オプションがあり、claude-opus-4-6 / claude-sonnet-4-6-thinking / claude-haiku-4-5-20251001 のような ID を直接入力できます。APIYI の /v1/messages endpoint は公式の model ID と完全互換です。
api.apiyi.com/token で token を作成するときは、ClaudeCode グループを選択してください — Claude の呼び出しは自動的に 5% OFF になり、10%〜20% のチャージボーナスとも併用できます。この ClaudeCode グループの token を Trae の Anthropic プロバイダー項目に貼り付けると、割引が自動適用されます。
Trae のプリセット一覧は実際の上流の提供状況より遅れます。ベストプラクティス: 「Custom model」を選び、ID を手入力すること — APIYI のバックエンドがサポートしているものなら動作し、Trae クライアントがプリセットを更新するのを待つ必要はありません。
  1. Claude Sonnet 4.6 または Opus 4.6 を優先する: ツール呼び出しのワークフローでかなり安定しています
  2. 小さな非 reasoning モデルを避ける: DeepSeek-Chat / 小さめの Qwen 系は Builder モードでループすることがあります — thinking 版に切り替えてください
  3. コンテキスト長を確認する: 大きな複数ファイル変更では Opus 4.6（200K コンテキスト）に切り替えてください
  4. APIYI の稼働状況を確認する: まれに上流の揺らぎがすべてのクライアントに影響します — チャネルの問題ではないことを確認してください
完全なエラー文は通常、Function tools with reasoning_effort are not supported for gpt-5.6-sol in /v1/chat/completions. To use function tools, use /v1/responses or set reasoning_effort to 'none'.（400、invalid_request_error）です。これは GPT-5.4 シリーズで導入された OpenAI 公式の制限 であり、APIYI のチャネル問題ではありません。/v1/chat/completions endpoint では、function tools は reasoning_effort と none 以外を組み合わせられなくなっています。これらのモデルはデフォルトで reasoning_effort: medium になるため、クライアントがそのパラメータを設定していなくてもエラーが発生します。ツール定義を含むリクエストであれば十分です。OpenAI が提示している回避策は 2 つで、/v1/responses endpoint に切り替えるか、reasoning_effort を none に明示設定するかです（推論を諦めることになります）。Trae ではどちらもできません。カスタムモデルは /v1/chat/completions（OpenAI プロトコル）と /v1/messages（Anthropic プロトコル）しかサポートしておらず、Responses API はありません。また、reasoning_effort の設定もありません。Builder / Chat モードは常にツール定義を送るため、クライアント側での回避策はありません。JetBrains AI Assistant、opencode、その他のクライアントでも GPT-5.4 以降で同じ壁に当たります。対処方法:
  1. Trae で影響を受けないモデルに切り替える: gpt-5.1 / gpt-5.2（OpenAI プロトコル）、または Claude 系（/v1/messages 経由の Anthropic プロトコル）、Gemini / DeepSeek など
  2. Trae のまま使う: Trae に Roo Code プラグインを入れる — その「OpenAI」プロバイダーは /v1/responses を使用し、Trae 内でツール呼び出しが動作することを確認済みで、実質的に Responses チャネルを追加できます。なお、Roo Code は開発終了しており、プリセットモデル一覧は gpt-5.4 で止まっています
  3. gpt-5.5 / 5.6 の reasoning とツール呼び出しを両立したい場合: Responses API に対応したクライアントを使ってください — Codex app / CLI または opencode です。OpenAI Responses API ネイティブガイド にクライアント対応表の全体版があります
Trae は ByteDance のクライアントであり、公式のプライバシーポリシーに従ってテレメトリと会話データをアップロードします。クライアント側のテレメトリが気になる場合は、次を検討してください:
  • 企業側の送信出口で許可リスト登録する
  • Builder モードに入れる前に機密スニペットをマスキングする
  • 代替として Claude Code や Cline のようなオープンソース / 監査可能なクライアントを選ぶ
各連携ガイドはこちら: Cursor · Cline · Claude Code · Codex CLI
  1. API key が sk- で始まり、余計な空白がないことを確認する
  2. baseURL が正しいことを確認する — 特に末尾のパス（/v1/chat/completions と /v1/messages）
  3. APIYI コンソールで token が有効になっており、対象モデルが token のグループに紐付いていることを確認する
  4. 残高不足も 401 として表示されることがあるため、アカウント残高を再確認する

​
関連リソース

モデル推奨

400以上のモデルにわたる性能比較とコーディングシナリオ向けの推奨

APIYIコンソール

tokenの作成、使用状況の確認、グループの管理

Cursor連携

もう一つの主要なAI IDE向けセットアップガイド

Clineプラグイン

VS Code内のフル機能エージェント

Codexアプリ連携

ネイティブなResponsesプロトコル — 最新のGPTシリーズ（5.4+）に最適な場所
さらにサポートが必要ですか？ api.apiyi.comをご覧いただくか、公式コミュニティに参加して技術サポートを受けてください。