Aider

Aider は TokenHub の OpenAI compatible インターフェイス経由でモデルを呼び出せます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。

このガイドで使う TokenHub endpoint は https://us-api.tokenhub.com/v1/chat/completions です。

使う場面

小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。

まず Aider 公式ドキュメントに従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。

CLI ツールの場合、TokenHub 認証情報を追加する前に実行ファイルが使えることを確認します：

aider --version

TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。

export TOKENHUB_API_KEY="sk-..."

キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。

Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。

項目	値
プロバイダー	OpenAI Compatible または Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` の値
モデル	`gpt-4.1` または別の TokenHub model ID

設定ファイルの場所

項目	値
User config	`~/.aider.conf.yml`
Project config	`.aider.conf.yml`
API key source	`OPENAI_API_KEY=$TOKENHUB_API_KEY`

model: openai/gpt-4.1
openai-api-base: __API_BASE_URL__/v1

プロジェクトファイルに秘密情報を入れないでください。コミットするのはモデルや Base URL などの非秘密デフォルトだけにし、API key は各開発者がローカルで提供します。

ツールが chat、edit、apply、fast model を分けている場合、最初のテストでは同じ TokenHub モデルを使います。動作確認後にコスト、レイテンシ、推論力で分けます。

一時変数は key、ネットワーク、モデル名の確認にだけ使います。確認後は同じ値を上の永続設定に移してください。

export TOKENHUB_API_KEY="sk-..."
export OPENAI_API_KEY="$TOKENHUB_API_KEY"
export OPENAI_API_BASE="__API_BASE_URL__/v1"

まず読み取り専用のプロンプトで、モデルが文脈を読めること、ファイルを変更しないことを確認します。その後、編集や Agent タスクを試します。

このプロジェクトの README を読み、3 文で要約してください。ファイルは変更しないでください。

プロンプトが成功したら、TokenHub のリクエストログでモデル名、endpoint、token 使用量、課金グループを確認します。

症状	対処
401 または認証失敗	`TOKENHUB_API_KEY` が有効で、同じ terminal、IDE、クライアントプロファイルに保存されているか確認します。
404 またはモデルが見つからない	TokenHub ワークスペースに存在し、選択したプロトコルに対応するモデル ID を使います。
endpoint が違う	上記の Base URL と完全に一致させます。OpenAI 互換ツールは通常 `/v1` が必要で、Claude 互換ツールは通常不要です。
リクエストがタイムアウトする	`https://us-api.tokenhub.com` へのネットワーク、プロキシ設定、ワークスペースの allowlist を確認します。
別のモデルが使われる	chat、edit、apply、fast、autocomplete など全てのモデル欄を再確認します。