Trae 統合

ByteDance の Trae IDE で Claude Code 拡張機能を使用（Trae CN 向けオフラインインストール手順を含む）

Trae 統合 ¶

Trae は ByteDance がリリースした AI ネイティブ IDE で、VS Code のフォークとして構築されています。ほとんどの VS Code 拡張機能と互換性を持ちながら、独自の Builder と Chat AI エージェントを搭載しています。本ガイドでは、Trae（国際版）または Trae CN（中国版）に Claude Code 拡張機能をインストールし、QCode.cc 経由で Claude、Codex などのモデルを利用する方法を説明します。

前提条件 ¶

Trae 拡張機能を設定する前に、以下を確認してください：

Claude Code CLI がインストールされ、正常に動作している
インストールガイドを参照してインストールを完了
環境変数の設定を参照して設定を完了
Trae または Trae CN が最新版にインストール済み
国際版ダウンロード：trae.ai
中国版 Trae CN ダウンロード：trae.com.cn

Trae CN はいつ使う？ Trae CN は中国本土のネットワーク環境向けに最適化されたバージョンです。海外にいる場合や国際ネットワークが安定している場合は、国際版の使用を推奨します。

インストール手順 ¶

ステップ 1：Claude Code 拡張機能のインストール ¶

Trae はほとんどの VS Code 拡張機能と互換性があります。Claude Code 拡張機能のインストール方法は 2 つあり、順番に試してください。

経路 A：Trae 内蔵拡張機能マーケットからインストール（推奨）¶

Trae を開き、拡張機能パネルを開く（Ctrl+Shift+X / Cmd+Shift+X）
"Claude Code" を検索（発行元：Anthropic）
インストール をクリック

Trae の拡張機能マーケットで Claude Code が見つからない場合（Trae CN の初期バージョンでは一般的）、経路 B を使用してください。

経路 B：オフライン .vsix によるローカルインストール ¶

これは Trae CN ユーザーにとって最も信頼できる方法です：

ブラウザで Claude Code 拡張機能ページを開く
右側のサイドバーで Download Extension リンクを見つけ、.vsix ファイルをダウンロード

ヒント：中国本土から VS Code Marketplace にアクセスするにはプロキシが必要な場合があります。ローカルでダウンロードに失敗した場合は、安定した国際回線のある環境で .vsix をダウンロードし、対象マシンにコピーしてください。

Trae で拡張機能パネルを開く → 右上の ⋯ メニュー → VSIX からインストール（Install from VSIX）を選択し、ダウンロードした .vsix ファイルを選択

またはコマンドラインを使用：

bash trae --install-extension /path/to/claude-code-x.x.x.vsix

ステップ 2：primaryApiKey の設定 ¶

これは重要なステップです！Claude Code 拡張機能は設定ファイルに primaryApiKey を必要とします。

朗報：Trae は VS Code と同じ設定パス（~/.claude/config.json）を共有しているため、VS Code で既に設定済みのユーザーは再度設定する必要はありません。

Windows ¶

設定ファイル C:\Users\ユーザー名\.claude\config.json を編集または作成：

{
  "primaryApiKey": "qcode"
}

macOS ¶

設定ファイル ~/.claude/config.json を編集または作成：

mkdir -p ~/.claude

cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

Linux ¶

設定ファイル ~/.claude/config.json を編集または作成：

mkdir -p ~/.claude

cat > ~/.claude/config.json << 'EOF'
{
  "primaryApiKey": "qcode"
}
EOF

注意：primaryApiKey の値は何でも構いません（qcode など）。このフィールドを設定するだけで OK です。実際の API 認証は、環境変数で設定した ANTHROPIC_AUTH_TOKEN を使用します。

重要：設定ファイルは config.json であり、settings.json ではありません。これら 2 つのファイルを注意して区別してください。

ステップ 3：Trae を再起動 ¶

設定完了後、Trae を再起動して変更を有効にします。

Trae 内蔵 AI との関係 ¶

Trae には Builder と Chat の 2 つの AI モードが搭載されており、ByteDance の自社バックエンドによって駆動されています。一方、Anthropic 公式の Claude Code 拡張機能は、設定した ANTHROPIC_BASE_URL（つまり QCode.cc プロキシ）経由で動作します。両者は完全に独立しており、共存可能です：

機能	Trae 内蔵 AI	Claude Code 拡張機能（QCode.cc）
バックエンド	ByteDance	Anthropic 公式 / QCode.cc プロキシ
モデル	Trae 選定モデル群	Claude 4.x / Codex / Opus 4.7 など
課金	Trae 独自課金	QCode.cc プランの使用量課金
ショートカット	Trae 独自キー	`Cmd+Esc` / `Ctrl+Esc`

QCode.cc サービスを既に購入している場合は、プランを最大限活用するため、Claude Code 拡張機能を主に使用することを推奨します。

使用方法 ¶

キーボードショートカット ¶

ショートカット	機能
`Cmd+Esc` / `Ctrl+Esc`	Claude Code パネルを開く/閉じる
`Cmd+Shift+P` / `Ctrl+Shift+P`	コマンドパレットを開き、Claude コマンドを検索

よく使う機能 ¶

コード説明
コードを選択
右クリックで "Ask Claude" を選択するかショートカットを使用
質問を入力、例：「このコードを説明して」
コード生成
Claude パネルを開く
必要な機能を説明
Claude がコードを生成し、挿入オプションを提供
コードリファクタリング
リファクタリングするコードを選択
Claude にリファクタリングを依頼
プレビューして変更を適用
エラー修正
コードにエラーがある場合
エラーコードまたはメッセージを選択
Claude に分析と修正案を依頼

設定オプション ¶

Trae 設定で Claude Code 拡張機能の動作を調整できます（これらの設定は VS Code と共通です）：

設定を開く（Ctrl+, / Cmd+,）
"Claude Code" を検索
必要に応じてオプションを調整

よく使う設定 ¶

{
  "claude-code.autoSuggest": true,
  "claude-code.inlineChat": true
}

ターミナル CLI との併用 ¶

Trae 拡張機能とターミナル CLI は一緒に使用できます：

シナリオ	推奨ツール
素早いコード編集	Trae 拡張機能
複雑なプロジェクト分析	ターミナル CLI
コードレビュー	どちらでも
Git 操作	ターミナル CLI
ファイル生成	どちらでも