# Trae 設定ガイド

> ByteDance の Trae IDE でカスタムモデルを使って LLMoxy に接続し、Chat / Builder で Agent コーディングを行います。

ウェブサイト：[https://www.trae.cn（中国国内）](https://www.trae.cn) · [https://www.trae.ai（海外）](https://www.trae.ai)

Trae（/treɪ/ と発音）は ByteDance の AI IDE で、VS Code をベースに Chat と Builder を搭載しています。組み込みモデルのほか、カスタム設定でリクエストを LLMoxy に向けることができます。

始める前に [LLMoxy トークン](https://jp.llmoxy.com/docs/get-started/get-token) を 1 つ用意してください。**auto** グループの使用をおすすめします。

## インストール

1. 公式サイトを開き、OS に合わせて `.exe` または `.dmg` をダウンロードします（Apple Silicon は ARM を選択）。
2. 初回起動時にテーマと言語（簡体字中国語）を選択します。
3. オプション：VS Code または Cursor からプラグイン、ショートカット、設定をインポートします。
4. `trae` コマンドラインのインストールをおすすめします。以降は `trae .` で現在のディレクトリを開けます。

![Trae をダウンロード](https://jp.llmoxy.com/docs-assets/migrated/tutorial-trae/download.png)

![VS Code / Cursor からインポート](https://jp.llmoxy.com/docs-assets/migrated/tutorial-trae/import.webp)

## LLMoxy に接続する

1. **設定 → モデル** を開きます。
2. **モデルを追加** をクリックします。
3. 最上部の **カスタムモデル** を選択します（DeepSeek、Alibaba Cloud などのプリセットベンダーは選択しないでください）。
4. 以下のように入力し、追加をクリックします。Trae はまずキーが有効かどうかを検証します。

![モデル管理を開く](https://jp.llmoxy.com/docs-assets/migrated/tutorial-trae/models.png)

![カスタムモデルを選択](https://jp.llmoxy.com/docs-assets/migrated/tutorial-trae/add-model.webp)

**OpenAI 互換を使う場合（推奨。GPT / Gemini / ほとんどのモデル）：**

| フィールド | 入力内容 |
| --- | --- |
| API 形式 | OpenAI Chat Completions |
| カスタムリクエスト URL | `https://llmoxy.com/v1` |
| 完全な URL | **オフ** |
| モデル ID | 例：`grok-4.7` |
| API キー | LLMoxy トークン |

**Anthropic 互換を使う場合（Claude シリーズ）：**

| フィールド | 入力内容 |
| --- | --- |
| API 形式 | Anthropic Messages |
| カスタムリクエスト URL | `https://llmoxy.com` |
| 完全な URL | **オフ** |
| モデル ID | 例：`claude-opus-5-5`、`claude-fable-5-2` |
| API キー | LLMoxy トークン |

> **💡 ヒント**
> 「完全な URL」はデフォルトでオフです。オンにする場合は、`https://llmoxy.com/v1/chat/completions` のように完全なパスを入力する必要があります。GPT-5 / GPT-6 の場合は、詳細設定で対応する「モデルシリーズ」を選択することをおすすめします。Trae がリクエストフィールドを自動的に調整します。

追加に成功したら、チャット入力欄の右下で Auto をオフにし、リストから追加したモデルを選択します。

## 使い方

右側は AI パネルです。

- **Chat**：コードの解説、バグの調査、`@ファイル名` でコンテキストを付けた質問。
- **Builder**：自然言語でゼロからプロジェクトを構築します。ファイルの作成、依存関係のインストール、プレビューの実行を行います。

![Chat と Builder](https://jp.llmoxy.com/docs-assets/migrated/tutorial-trae/assistant.png)

| 操作 | macOS | Windows |
| --- | --- | --- |
| 現在のファイルの変更を承認 | `Command + Enter` | `Ctrl + Enter` |
| 現在のファイルの変更を拒否 | `Command + Backspace` | `Ctrl + Backspace` |
| インライン会話 | `Command + I` | `Ctrl + I` |

VS Code プラグインにも対応しています。Cline のほうが使い慣れている場合は、[Trae Cline プラグインガイド](https://jp.llmoxy.com/docs/code-tutorials/trae-cline) を参照してください。

## よくある質問

**カスタムリクエスト URL がずっと赤く表示される**
まず「完全な URL」がオフであることを確認し、アドレスには `https://llmoxy.com/v1`（OpenAI）または `https://llmoxy.com`（Anthropic）を入力してください。`/chat/completions` をベース URL に付け足さないでください。

**キーの検証に失敗する**
トークンに空白が含まれていないこと、グループが **auto** であること、モデル ID がコンソールの表示と完全に一致していることを確認してください。

**Windows で Builder がターミナルエラーを出す**
設定 → ターミナルプロファイルで、PowerShell 6 以降を選択してください。

これは https://jp.llmoxy.com/docs/code-tutorials/trae の markdown 版です。
