Coding Agent のセットアップ

MonkeyCode とは：起動方法と API 設定

MonkeyCode の用途を確認し、BetterToken の API Key、Base URL、Model ID を設定して、429 や接続エラーを解決します。

MonkeyCode は、独自の画面でカスタムプロバイダーを使ってモデルを接続できる AI ツールです。このガイドでは、AI Model で OpenAI Chat（Chat Completions）を使って BetterToken に接続する方法を説明します。MonkeyCode 独自の公式 API は対象外です。BetterToken API Key、https://bettertoken.ai/v1、正確な Model ID を入力し、接続設定を保存して新しいチャットを開始します。MonkeyCode で使う互換モデルを自分で選ぶ場合に利用してください。Kodacode / Koda の問題については、Kodacode の設定と 429 エラーガイドを参照してください。製品情報と現在のオンラインサービスは、MonkeyCode 公式リポジトリで確認できます。

主要な設定

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

前提条件

現在のバージョンのツールがインストールされている
BetterToken API Key：登録して取得
モデル広場の Model ID

登録して BetterToken API Key を取得

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

追加要件

MonkeyCode アカウント（サービスへのアクセス方法は公式リポジトリを参照）

インストール

MonkeyCode をインストールまたは開いてから、以下の手動設定を続けます。

手動設定

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

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

設定手順

MonkeyCode にログインする

MonkeyCode 公式リポジトリに記載されたオンラインサービスを開き、ログインします。

システム設定を開く

タスクページに入り、右下の Settings をクリックします。

AI モデルをバインドする

AI Model セクションで Bind をクリックします。

BetterToken の設定を入力する

項目	値
Model API URL	`https://bettertoken.ai/v1`
API Key	BetterToken API Key
API 形式	`OpenAI Chat`（Chat Completions）
モデル名	モデル広場からコピーした、モデル ID

公式ドキュメントで明示的に要求される場合にのみ追加ヘッダーを設定する

User-Agent を BetterToken で必須とする公式 MonkeyCode 設定要件は見つかりませんでした。このページに記載されている Base URL、API Key、モデル ID から始めてください。

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

保存して使い始める

Save をクリックしてからメインページに戻り、設定したモデルを選択します。

MonkeyCode を再起動する

設定を保存した後、新しいモデルを使用する前にページを更新するか、MonkeyCode を開き直します。

接続を確認する

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

モデルを切り替える

モデルセレクターを開くか、設定の 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 を追加しないでください。