Coding Agent のセットアップ

Zed のカスタムモデルと API 接続設定

Zed で BetterToken を OpenAI 互換プロバイダーとして追加し、Base URL、API Key、モデルを設定して、キーをシステムキーチェーンに保存します。

Zed の Agent Settings で OpenAI 互換プロバイダーを追加してから、BetterToken API Key、Base URL、Model ID を入力します。Zed はこの画面から保存されたキーを、settings.json ではなくシステムキーチェーンに保存します。

主要な設定

項目	値
プロバイダー	`BetterToken`
API Key	`YOUR_API_KEY`
Base URL	`https://bettertoken.ai/v1`
Model	`YOUR_MODEL_ID`

前提条件

現在のバージョンの Zed をインストール
BetterToken API Key を作成
モデル広場から YOUR_MODEL_ID をコピー

登録して BetterToken API Key を取得

アカウントをお持ちの方は、ログインして残高をチャージし、コンソールでキーを作成してください。

インストール

Zed Web サイトから現在のバージョンをインストールまたは更新します。Zed を起動してから、以下の手順で Agent 設定を開きます。

手動設定

OpenAI 互換プロバイダーを追加する

Add Provider をクリックし、OpenAI Compatible を選択して、プロバイダー名に BetterToken を入力します。

接続設定を入力する

項目	値
API URL	`https://bettertoken.ai/v1`
API Key	`YOUR_API_KEY`
Model ID	`YOUR_MODEL_ID`

Base URL のみを入力します。このガイドでは Zed のデフォルトの Chat Completions モードを使うため、Zed がそのエンドポイントのパスを追加します。

API Key を保存する

Zed 設定でプロバイダーを保存します。Zed は API Key をローカルのシステムキーチェーンに保存し、settings.json には書き込みません。

モデルを選択する

Agent Panel のモデルピッカーを開き、YOUR_MODEL_ID を BetterToken の下で選択します。

任意：`settings.json` でプロバイダーとモデルを宣言する

ファイルで管理するモデル宣言が必要な場合は、zed: open settings file を実行します。ファイルにはプロバイダー、api_url、モデルメタデータだけを保持します。

{
  "language_models": {
    "openai_compatible": {
      "BetterToken": {
        "api_url": "https://bettertoken.ai/v1",
        "available_models": [
          {
            "name": "YOUR_MODEL_ID",
            "display_name": "YOUR_MODEL_ID",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

Zed ではモデルのコンテキストウィンドウ宣言として max_tokens が必要です。選択したモデルに合わせて調整してください。API Key は Agent Settings に入力し、システムキーチェーンに保存します。

接続を確認する

Agent Panel で BetterToken / YOUR_MODEL_ID を選択します。
短いテストメッセージを送信します。
認証またはモデルエラーなしで正常なレスポンスが返れば、設定は確認できています。

プロバイダーまたはモデル設定を変更した後は、Zed を完全に終了して再起動してください。

モデルを切り替える

Agent Panel のモデルピッカーで別の BetterToken モデルを選択します。Model ID を追加するには、モデル広場から現在の値をコピーし、プロバイダー設定または available_models を更新します。

よくあるエラー

エラー	対処方法
`401` または `Unauthorized`	Agent Settings で BetterToken API Key を再入力し、前後の空白を削除します。
`404`	API URL には `https://bettertoken.ai/v1` を使用します。`/chat/completions` を追加しないでください。
`model not found`	モデル広場から `YOUR_MODEL_ID` をもう一度コピーします。
設定が反映されない	プロバイダーを保存し、Zed を完全に終了して開き直します。
Zed が古いキーを使用する	プロバイダー ID を大文字のスネークケースに変換し、`_API_KEY` を付けた変数を確認します。`BetterToken` なら `BETTERTOKEN_API_KEY` です。空でない値があるとキーチェーンより優先されます。変数を解除して Zed を再起動すると、保存済みのキーを使えます。Zed のキーの優先順位を参照してください。

技術詳細

キーチェーン、設定ファイル、Endpoint

Zed は OpenAI 互換プロバイダーを通じて BetterToken を呼び出します。設定画面はキーをシステムキーチェーンに保存し、settings.json にはプロバイダー、api_url、モデル宣言のみが含まれます。このガイドのデフォルトの Chat Completions 設定では、Base URL に https://bettertoken.ai/v1 を指定し、Zed にエンドポイントのパスを追加させます。