Coding Agent のセットアップ

Kodacode：API 設定と 429 エラー対処

Kodacode に BetterToken API Key、Base URL、Model ID を設定し、429 エラーなどの一般的な問題を解決します。

Kodacode を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。MonkeyCode の問題については、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 がインストールされていること
Kodacode / Koda 拡張機能がインストールされていること
モデル広場から正確な Model ID をコピーしてください。

インストール

Kodacode をインストールまたは開いてから、以下の手動設定に進みます。

手動設定

項目	値
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	モデル広場にある現在の Model ID

セットアップ

Koda パネルを開き、モデルを追加する

VS Code サイドバーの KODA パネルを開き、入力ボックス下のモデルセレクターをクリックして、Add model: Agent を選択します。

Koda パネルのモデルセレクターで Add model: Agent を選択します。

OpenAI 互換モデルの設定を入力する

モデル追加ダイアログで次の値を使用します。

項目	推奨値
Provider	`Any OpenAI-compatible API`
API Base	`https://bettertoken.ai/v1/`
Model ID	モデル広場にあるモデル ID。例：`YOUR_MODEL_ID`
API Key	BetterToken API Key

項目を入力したら Connect をクリックします。

Kodacode のモデル追加ダイアログで Any OpenAI-compatible API を選択し、API Base、Model ID、API Key を入力します。

モデルが有効であることを確認する

接続に成功したら、Koda 入力ボックス下のモデルセレクターから YOUR_MODEL_ID などの新しいモデルを選択します。短いメッセージを送信し、Response が返ることを確認します。

config.yaml を確認する

Kodacode は設定を ~/.koda/config.yaml に書き込みます。このファイルを開き、モデルが追加されたことを確認します。

OpenAI 互換モデルの設定が追加された Kodacode の config.yaml。

config.yaml の例

この完全な構造を参照してください。YOUR_API_KEY を BetterToken API Key に置き換え、実際の API Key をリポジトリにコミットしないでください。

name: Koda
version: 0.0.1
schema: v1
models:
  - name: Koda Models
    provider: koda-chat-models
    model: AUTODETECT
    roles:
      - agent
      - chat
      - edit
  - name: YOUR_MODEL_ID
    provider: openai
    model: YOUR_MODEL_ID
    apiKey: YOUR_API_KEY
    apiBase: https://bettertoken.ai/v1/
    roles:
      - agent
      - chat
      - edit
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

接続を確認する

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

モデルを切り替える

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

よくあるエラー

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

接続に失敗する場合は、API Base が https://bettertoken.ai/v1/ であり、末尾の / を維持していることを確認します。
モデル広場から正確な Model ID をコピーしてください。
認証に失敗する場合は、API Key を再度コピーし、余分な空白や改行を避けます。
config.yaml の変更が反映されない場合は、VS Code を再起動するか、Developer: Reload Window を実行します。
BetterToken では通常、追加の User-Agent やカスタムヘッダーは必要ありません。