# VS Code Agents ウィンドウ設定ガイド

> VS Code の Agents ウィンドウでカスタムエンドポイントを使って LLMoxy に接続し、API Key とモデル ID を設定して、Agent Host セッションで独自のモデルを使えるようにします。

ウェブサイト：[https://code.visualstudio.com/（クリックしてダウンロード！）](https://code.visualstudio.com/)

公式リファレンス：[AI language models in VS Code](https://code.visualstudio.com/docs/agent-customization/language-models)、[Use the Agents window](https://code.visualstudio.com/docs/copilot/agents/agents-window)

> **📌 Agents ウィンドウについて**
> Agents ウィンドウは VS Code 独立の Agent ワークベンチで、セッションの作成、モデルの選択、タスクの追跡に使用します。この記事では LLMoxy を設定する方法のみを説明し、セッション管理については扱いません。

## 準備

- [VS Code](https://code.visualstudio.com/) をインストール済みであること（比較的新しい Stable 版または Insiders を推奨）
- LLMoxy コンソールでトークンを作成します。[トークンを取得する](https://jp.llmoxy.com/docs/get-started/get-token) を参照してください
- **default** グループのトークン（GPT テキストモデル用）の使用をおすすめします。画像生成用の Key とは混在させないでください

接続情報：

| 項目 | 値 |
| --- | --- |
| ゲートウェイ | `https://llmoxy.com` |
| Chat Completions | `https://llmoxy.com/v1/chat/completions` |
| API Key | コンソールでコピーしたトークン |
| 推奨モデル | `gpt-6-astra`、`grok-4.7` |

Agent はツールを呼び出せる必要があるため、モデル設定で `toolCalling` を `true` にしてください。そうしないと、Agents ウィンドウのモデルリストに表示されません。

## Agents ウィンドウを開く

次のいずれかの方法で開きます。

- タイトルバーの **Open in Agents** をクリック
- コマンドパレット（`Ctrl+Shift+P` / `⌘⇧P`）で **Chat: Open Agents Window** を実行
- ターミナルで `code --agents` を実行

![Agents ウィンドウの画面](https://jp.llmoxy.com/docs-assets/tutorial-vscode-agents/agents-window.png)

新しいセッションを作成するときは、入力エリアでワークスペース、Agent harness、言語モデルを選択します。

![新規セッションの入力エリア](https://jp.llmoxy.com/docs-assets/tutorial-vscode-agents/new-session.png)

## Agent Host で独自のモデルを使えるようにする

Agents ウィンドウのセッションは Agent Host を経由します。LLMoxy のように自前の Key を使うモデルを利用するには、まず実験的なスイッチをオンにします。

1. 設定を開く（`Ctrl+,` / `⌘,`）
2. `agentHost.byok` を検索
3. **Chat > Agent Host: Byok Models Enabled**（`chat.agentHost.byokModels.enabled`）にチェックを入れる

GitHub にログインせず LLMoxy のみを使いたい場合は、さらに **Chat > Agent Host: Allow Signed Out When Usable**（`chat.agentHost.allowSignedOutWhenUsable`）にもチェックを入れます。

`settings.json` に直接書き込むこともできます。

```json
{
  "chat.agentHost.byokModels.enabled": true,
  "chat.agentHost.allowSignedOutWhenUsable": true
}
```

> **💡 ヒント**
> この 2 つの項目はデフォルトでオフです。オンにしないと、Chat ビューには LLMoxy のモデルが表示されても、Agents ウィンドウでは選択できません。

## LLMoxy のカスタムエンドポイントを追加する

VS Code の **Custom Endpoint**（カスタムエンドポイント）で接続します。非推奨になった旧 OpenAI Compatible の項目は使用しないでください。

### 1. 言語モデルの管理を開く

Chat または Agents ウィンドウの入力欄でモデルセレクターを開き、歯車アイコンの **Manage Language Models** をクリックします。コマンドパレットで **Chat: Manage Language Models** を実行しても開けます。

![Chat 入力欄のモデルセレクター](https://jp.llmoxy.com/docs-assets/tutorial-vscode-agents/model-picker.png)

![言語モデルマネージャー](https://jp.llmoxy.com/docs-assets/tutorial-vscode-agents/language-models-editor.png)

### 2. カスタムエンドポイントを追加する

1. **Add Models** をクリック
2. **Custom Endpoint** を選択
3. グループ名に `LLMoxy` を入力（モデルリストに表示されます）
4. 表示名と API Key（LLMoxy トークン）を入力
5. API タイプは **Chat Completions** を選択

![モデルプロバイダーを選択](https://jp.llmoxy.com/docs-assets/tutorial-vscode-agents/add-provider.png)

### 3. chatLanguageModels.json を編集する

VS Code が `chatLanguageModels.json` を開きます。次のように保存してください（Key は自分のトークンに置き換えます）。

```json
[
  {
    "name": "LLMoxy",
    "vendor": "customendpoint",
    "apiKey": "${input:llmoxyApiKey}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "gpt-6-astra",
        "name": "GPT-6 Astra",
        "url": "https://llmoxy.com/v1/chat/completions",
        "apiType": "chat-completions",
        "toolCalling": true,
        "vision": true,
        "thinking": true,
        "maxInputTokens": 922000,
        "maxOutputTokens": 128000,
        "supportsReasoningEffort": ["low", "medium", "high", "xhigh", "max"],
        "reasoningEffortFormat": "chat-completions"
      },
      {
        "id": "grok-4.7",
        "name": "Grok 4.7",
        "url": "https://llmoxy.com/v1/chat/completions",
        "apiType": "chat-completions",
        "toolCalling": true,
        "vision": true,
        "thinking": true,
        "maxInputTokens": 500000,
        "maxOutputTokens": 128000
      }
    ]
  }
]
```

保存すると、モデルセレクターに **GPT-6 Astra** と **Grok 4.7** が表示されるはずです。表示されない場合は、VS Code を一度再起動してください。

## Agents ウィンドウでモデルを切り替える

1. Agents ウィンドウを開き、セッションを新規作成するか選択します
2. 入力欄のモデルセレクターで、LLMoxy 配下のモデルを選択します
3. 推論モデルでは、名前の横の **>** をクリックして Thinking Effort（Low / Medium / High など）を設定できます

![Thinking Effort のサブメニュー](https://jp.llmoxy.com/docs-assets/tutorial-vscode-agents/thinking-effort.png)

セレクターには `GPT-6 Astra · High` のように表示されます。そのセッションは、今回選択した努力レベルを記憶します。

> **⚠️ 注意**
> 信頼されていないワークスペース（Restricted Mode）では、セレクターに **Auto** しか表示されません。先にワークスペースを信頼してください。
> 企業向け Copilot では **Bring Your Own Language Model Key in VS Code** が無効化されている場合があります。管理者が GitHub Copilot のポリシーで有効にする必要があります。

## よくある質問

- **Agents ウィンドウに LLMoxy のモデルが表示されない**：`chat.agentHost.byokModels.enabled` がオンになっていること、およびそのモデルの `toolCalling` が `true` であることを確認してください
- **422 / model not found**：`id` がコンソールと一致しているか確認してください（例：`gpt-6-astra`、`grok-4.7`）
- **401 / Invalid token**：トークンをコピーするときに空白や改行を含めないでください。Key が無効化されていないこと、上限を超過していないことを確認してください
- **アドレスの誤り**：API タイプは **Chat Completions** を選択し、`url` には `https://llmoxy.com/v1/chat/completions` を入力してください
- **画像生成用 Key でテキストモデルを呼び出すと失敗する**：画像生成には「GPT Image 2 画像生成グループ」専用の Key を使用し、テキストモデルと混在させないでください

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