ブログに戻る

ツールと連携ガイド

自分の API キー用の Aider 設定ファイル: .aider.conf.yml と Windows setx

自分の API キーとベース URL を .aider.conf.yml に保管し、読み込み順を正しく理解し、Windows setx の罠を避け、セッションのコスト見積もりも確認しましょう。

投稿者: CheapTokens Team公開日 読了時間 4 分

Aider を OpenAI 互換 API に接続するコマンドを表示したターミナル
このページの内容
  1. Windows: setx と新しいターミナル
  2. どの編集にどのモデルか
  3. 最初の編集を実行する
  4. 入力を繰り返すのをやめる: .aider.conf.yml
  5. セッションにかかるコスト
  6. うまくいかない場合

OPENAI_API_BASE と OPENAI_API_KEY の2つの変数、そして openai/<model id> のようなモデル引数があれば、Aider を CheapTokens に向けられます。手順の基本（インストール、最初のリクエスト、401/404/400/402）は How to connect Aider to CheapTokens にあります。このページでは、そのガイドが触れていない点を扱います。Windows の setx、設定ファイルとその読み込み順、そしてセッションのコスト見積もりです。

出典: OpenAI 互換 API に関する Aider のドキュメント（ページ確認日 2026年10月26日。ドキュメントには日付もバージョンも記載されておらず、その日の PyPI 上の最新 aider-chat は 0.86.2 でした）。

Windows: setx と新しいターミナル#

Mac と Linux では2つの変数を export します。Windows（PowerShell または cmd）では setx を使います:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

Windows には落とし穴があります。setx は今入力しているセッションではなく、今後のセッション用に変数を書き込むので、Aider を起動する前にターミナルを閉じて新しく開いてください。変数を設定したのに Aider がまだキーを要求する場合、これがよくある原因です。

どの編集にどのモデルか#

モデル引数は openai/ に完全な id を加えたものなので、CheapTokens ではスラッシュが2つになります:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 は 180K のコンテキストを持ち、最大 8,192 トークンまで応答します。応答が短く収まる小規模から中規模の編集に適しています。編集が長い diff で返ってくる場合は、試す価値のあるもう一つのモデルが DeepSeek-V4-Flash です。1回の応答で最大 32,768 トークン、380K のコンテキスト、そして時間帯を問わず一定の価格です。

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

完全な id は CheapTokens docs または pricing のモデル一覧からコピーしてください。

最初の編集を実行する#

Aider は git リポジトリ内で動作するので、リポジトリ内で始めてください。ファイルを追加して、小さな変更を依頼します:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Aider がファイルへの編集で応答すれば、キー、ベース URL、モデル id はすべて正しいです。

The wrong model id next to the full id that works, then the first edit
Wrong id versus full id, and the first request

入力を繰り返すのをやめる: .aider.conf.yml#

Aider はホームディレクトリ、次に git リポジトリのルート、次にカレントディレクトリから .aider.conf.yml を読み込み、後のファイルが優先されます。つまり、グローバルファイルにキーとベースを入れ、リポジトリのファイルでモデルを選べます。特定の1つのファイルだけを読み込み、他は何も読み込まないようにしたい場合は、aider --config <file> がそのファイルだけを読み込みます。

ホームディレクトリのファイル（例。自分のキーを入れてください）:

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

これで aider だけで正しいエンドポイントとモデルで起動します。ファイルをリポジトリにコミットする場合は、キーを外して環境変数か .env ファイルに保管してください。キーの行は自分のホームディレクトリ用です。

Aider が知らないモデルについては、ドキュメントで model-settings-file（.aider.model.settings.yml）が説明されており、そこでその設定を指定できます。

セッションにかかるコスト#

Aider は追加したファイルとチャット履歴をメッセージごとに再送信するので、入力トークンは出力より速く増えます。約20メッセージの作業セッションで 400,000 入力トークンを送信し、40,000 出力トークンが返ってくるとします（例のための仮定です。自分の数値に置き換えてください）。MiniMax-M2.7 では $0.026 となり、入力と出力を合計すると OpenRouter より安くなります。以下の表は同じセッションを当社のモデル全体で実行したものです:

モデル コスト OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

合計 400,000 入力トークンと 40,000 出力トークン。100万トークンあたりの価格は現行のもので、当社の料金体系に合わせて変動します。OpenRouter 列は同じワークロードの参考価格を示しています。

入力側を小さく保つ方法（読み取り専用ファイル、/drop、リポジトリマップのサイズ）は How much does Aider cost で扱っています。最新の価格は常に pricing page にあります。

うまくいかない場合#

  • Aider が API キーを要求する、または間違ったサービスと通信する。 変数がプロセスから見えていません。Windows では setx の後にターミナルを再起動してください。Mac と Linux では同じシェルで echo $OPENAI_API_BASE を実行してください。
  • 設定が無視されているようだ。 順序を思い出してください: ホーム、リポジトリルート、カレントディレクトリ。より近いファイルがグローバルなものを上書きします。
  • モデルが見つからない、404、または認証エラー。 これらは How to connect Aider to CheapTokens で扱っています。

同じ OpenAI 互換アドレスは他のツールでも機能します。エディタエージェントも使う場合は、connecting OpenCode または where to plug in your own API key の概要を参照してください。

タグ: