Coding Agent のセットアップ

Cline のインストールと API 設定

Cline をインストールし、BetterToken の Base URL と API Key、互換プロバイダーのモデルを設定して、よくあるエラーを解決します。

Cline を BetterToken に接続するには、API Key を用意し、次の Base URL とモデル一覧にある現在の Model ID を入力します。同様の画面を使うツールは Roo Code、Kilo Code、MonkeyCode も参照してください。

主要設定

フィールド	値
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	モデル一覧にある現在の Model ID

前提条件

現在のバージョンのツールをインストールします
BetterToken API Key：登録して取得します
モデル一覧にある Model ID

登録して BetterToken API Key を取得

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

追加要件

VS Code をインストールします

インストール

Cline をインストールする

VS Code を開き、拡張機能マーケットプレイスで Cline を検索してインストールします。

手動設定

Cline の設定画面で次の操作を行います。設定ファイルを編集する必要はありません。

フィールド	値
API Key	使用する BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	モデル一覧にある現在の Model ID

設定手順

競合する環境変数を削除する

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Cline の設定画面を開く

Cline のサイドバーで Use your own API key をクリックします。

API プロバイダーを設定する

次のフィールドを入力します。

API Provider → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → BetterToken API Key
モデル広場から正確な Model ID をコピーしてください。

Model Configuration では、選択したモデルの確認済みのコンテキスト上限と出力上限を設定します。画像入力や Computer Use は、モデルとエンドポイントの両方が対応する場合にのみ有効にしてください。Cline のプロバイダー設定を参照してください。

公式ドキュメントで必要な場合だけ追加の headers を設定する

Cline の OpenAI 互換設定に関する公式ドキュメントでは、Base URL、API Key、Model ID を設定します。BetterToken への接続で追加の User-Agent は通常必要ありません。

カスタム gateway、tenant routing、observability、cache レイヤーも使用する場合は、その upstream サービスの公式ドキュメントに従って必要なヘッダーだけを追加してください。

設定を保存する

Done をクリックします。

Cline を再起動する

設定を保存した後、VS Code を再起動するか Cline 拡張機能を再読み込みして、新しい設定を反映します。

接続の確認

プロバイダー設定の Verify で接続を確認します。

短いテストプロンプトを送信します。認証エラーや Model ID エラーがなく応答が返れば、接続は完了です。設定を変更した後は、ツールを完全に再起動してください。

Cline CLI

公式 Cline CLI をインストールします。VS Code 拡張機能とは別にインストールしてください。macOS で GPT モデルを使ったテストでは、Cline CLI 3.0.73 がテキストリクエストとファイル読み取りのツール呼び出しを完了しました。

YOUR_API_KEY を BetterToken API Key に、YOUR_MODEL_ID をモデル広場にある正確な ID に置き換えてから、認証します。

cline auth --provider openai --apikey YOUR_API_KEY --baseurl https://bettertoken.ai/v1 --modelid YOUR_MODEL_ID

非対話型のテキスト確認を実行します。

cline --json --retries 2 --timeout 170 --provider openai --model YOUR_MODEL_ID "Reply with only: OK"

最終回答が OK であることを確認します。テストでは CLI の --provider openai が openai-compatible と記録されました。コマンドラインの値は IDE の OpenAI Compatible メニュー表示とは異なります。--data-dir で設定ディレクトリを選ぶ場合は、両方のコマンドに同じディレクトリを指定してください。

モデルの切り替え

モデル選択を開くか、設定の Model フィールドを変更します。モデル一覧にある正確な Model ID を使用し、現在のセッションを再起動してください。

よくあるエラー

エラー	確認項目
`401` または `Unauthorized`	BetterToken API Key を確認し、前後の空白を削除します。
`404`	Base URL を確認し、特定のエンドポイントパスを追加しないでください。
`model not found`	モデル一覧から現在の Model ID をコピーします。
変更が反映されない	設定を保存し、ツールを完全に再起動します。

技術情報

プロトコル、エンドポイント、内部プロバイダーフィールド

この設定では https://bettertoken.ai/v1 を使用します。ツールが OpenAI 互換エンドポイントのパスを追加します。特定のフィールドで明示的に必要な場合を除き、/chat/completions や /responses を追加しないでください。