Coding Agent のセットアップ

Roo Code のインストールと API 設定

Roo Code をインストールし、BetterToken の Base URL と API Key を設定して、モデルを選び、よくあるエラーを解決します。

Roo Code を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。

主要な設定

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

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

この設定は Roo Code の設定 UI で完了します。設定ファイルを編集する必要はありません。

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Roo Code の Settings パネルを開きます。

次の値を入力します。

確認した公式 Roo Code 資料は OpenAI 互換またはカスタム API の設定に焦点を当てていますが、追加の User-Agent を BetterToken の必須手順として扱っていません。

カスタムゲートウェイ、テナントルーティング、可観測性、キャッシュレイヤーも使用している場合は、その上流サービスの公式ドキュメントに従ってのみヘッダーを追加してください。

Save と Done をクリックしてから、設定したモデルを選択します。

設定を保存した後、設定したモデルを選択する前に VS Code を再起動するか、Roo Code 拡張機能を再読み込みします。

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

続いて、プロジェクト内のファイルを一つ読み、要約するよう Roo Code に依頼します。ファイル読み取りツールを実行し、その結果を使っていることを確認してください。テキストの返答だけでは、エージェントのツール利用を検証できません。

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

エラー	確認事項
`401` または `Unauthorized`	BetterToken API Key を確認し、先頭または末尾の空白を削除します。
`404`	Base URL を確認し、特定の Endpoint パスを追加しないでください。
`model not found`	モデル広場から現在の Model ID をコピーします。
変更が反映されない	設定を保存して、ツールを完全に再起動します。

プロトコル、Endpoint、内部プロバイダーフィールド

この設定では https://bettertoken.ai/v1 を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、/chat/completions や /responses を追加しないでください。