Coding Agent のセットアップ

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

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

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

主要設定

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

ターミナルで次のコマンドを実行します。

python -m pip install aider-install
aider-install

インストール後、Aider が利用可能であることを確認します。

aider --help

export OPENAI_API_BASE="https://bettertoken.ai/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

cd /path/to/your/project
aider --model openai/YOUR_MODEL_ID

setx OPENAI_API_BASE "https://bettertoken.ai/v1"
setx OPENAI_API_KEY "YOUR_API_KEY"

setx の実行後に PowerShell を閉じて開き直します。その後、プロジェクトディレクトリに移動して実行します。

aider --model openai/YOUR_MODEL_ID

YOUR_API_KEY を BetterToken API Key に置き換えます。YOUR_MODEL_ID は例です。モデル広場にある現在のModel IDに置き換え、openai/ プレフィックスはそのままにします。

ターミナルを開くたびに変数を設定しないよう、プロジェクトの Git ルートに .env ファイルを作成します。

OPENAI_API_BASE=https://bettertoken.ai/v1
OPENAI_API_KEY=YOUR_API_KEY
AIDER_MODEL=openai/YOUR_MODEL_ID

API Key がコミットされないよう、.env を .gitignore に追加します。その後、プロジェクトディレクトリに移動して実行します。

aider

プロジェクトごとに別のファイルを使用する場合は、明示的に指定します。

aider --env-file ./aider-bettertoken.env

機密でない設定だけを保存するには、ホームまたはプロジェクトディレクトリに .aider.conf.yml を作成します。

model: openai/YOUR_MODEL_ID
openai-api-base: "https://bettertoken.ai/v1"

API Key は共有 YAML ファイルではなく、OPENAI_API_KEY 環境変数に保持します。

起動コマンドのモデルを、現在のModel IDに置き換えます。

aider --model openai/YOUR_MODEL_ID

openai/ プレフィックスは削除しないでください。Model ID は設定した Endpoint と互換性が必要です。

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

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

症状	対処方法
`401`、`Unauthorized`、`Invalid API key`	`OPENAI_API_KEY` を確認し、BetterToken API Key であることと余分な空白がないことを確かめます。
`model not found` またはモデルが利用できない	モデル広場から正確な Model ID をコピーしてください。
Request URL が正しくない、または `404`	`OPENAI_API_BASE` が `https://bettertoken.ai/v1` であることを確認します。`/chat/completions` は追加しません。
Windows が新しい変数を読み取らない	`setx` は新しく開いたターミナルにのみ反映されます。現在の PowerShell ウィンドウを閉じ、新しいウィンドウを開きます。
Aider が不明なモデルを報告する	まず Model ID と API プロバイダーを確認します。Aider は新しいモデルに警告を表示することがありますが、モデル広場の現在の ID を使用する必要があります。