# Zed Agent

出典: https://docs.aicentos.com/ja/clients/zed-agent

Language: ja

> Zed の Agent Panel から OpenAI 互換 Provider で aicentos に接続する

Zed には OpenAI 互換の Provider タイプが内蔵されています。`settings.json` にエンドポイント、モデル、コンテキスト長を宣言すれば、Agent Panel で aicentos に接続されたモデルを利用できます。

## 準備

まずコンソールの「API Key」ページで Zed 専用のキーを作成します（名前は `zed-agent` がおすすめです）。

* コンソール：[https://aicentos.com](https://aicentos.com)
* キーの作成：[https://aicentos.com/keys](https://aicentos.com/keys)
* 残高不足のときのチャージ：[https://aicentos.com/wallet](https://aicentos.com/wallet)

Zed は API Key を `settings.json` に書き込まず、同名の環境変数を読みます。Provider ID は大文字のスネークケースに変換され、末尾に `_API_KEY` が付きます。したがって Provider ID を `aicentos` にすると、環境変数名は `AICENTOS_API_KEY` になります。

## 設定値

| 項目                              | 値                         |
| ------------------------------- | ------------------------- |
| Provider ID                     | 自由に設定。例：`aicentos`        |
| `api_url`                       | `https://aicentos.com/v1` |
| `available_models[].name`       | コンソール「モデル広場」のモデル名         |
| `available_models[].max_tokens` | モデルのコンテキストウィンドウ           |
| API Key                         | 環境変数 `AICENTOS_API_KEY`   |

## 設定手順

* Zed の `settings.json` を開きます（コマンドパレットで `zed: open settings` を実行）。
* `language_models.openai_compatible` の設定を追加します：

```json
{
  "language_models": {
    "openai_compatible": {
      "aicentos": {
        "api_url": "https://aicentos.com/v1",
        "available_models": [
          {
            "name": "gpt-5",
            "display_name": "GPT-5 (aicentos)",
            "max_tokens": 128000,
            "max_output_tokens": 16384,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}
```

* 環境変数をエクスポートします（`~/.zshrc` に書き込んでから再読み込みします）：

```bash
export AICENTOS_API_KEY="sk-あなたのaicentosキー"
```

* Agent Panel を開き、モデルのドロップダウンでその Provider 配下のモデルを選択します。

Agent 設定で **Add Provider** をクリックし、GUI から Provider 名、API URL、モデル ID、コンテキストウィンドウを入力することもできます。

## テスト

設定が完了したら、Agent Panel で新しい会話を作成し、まず簡単なプロンプト 1 つで軽くテストします。正常に返ることを確認してから、本格的にツール呼び出しを使い始めてください。

## 注意事項

* `api_url` は `https://aicentos.com/v1` まで入力し、完全な `/chat/completions` に補わないでください。Zed が自動で連結します。
* API Key を `settings.json` に直接書くことはできません。環境変数を使う（または Provider 設定画面からシステムのキーチェーンに保存する）必要があります。空でない環境変数はキーチェーンより優先されます。
* `max_tokens` はコンテキストウィンドウです。モデルの実際の値に合わせて設定することをおすすめします。欠落しているとコンテキスト管理が正しく動作しません。
* ツール呼び出しはデフォルトで有効（`capabilities.tools`）です。画像入力と並列ツール呼び出しはデフォルトで無効のため、必要に応じて手動で有効にしてください。
* 公式ドキュメント：[https://zed.dev/docs/ai/llm-providers](https://zed.dev/docs/ai/llm-providers)
* その他の説明はドキュメントサイトをご覧ください：[https://docs.aicentos.com](https://docs.aicentos.com)