Aider 連携

QCode.cc で Aider を設定:Claude は Anthropic エンドポイント(anthropic/ プレフィックス)、GPT と中国系モデルは OpenAI 互換エンドポイント

最終更新 2026-10-27

API キーが必要ですか? 登録する →エンドポイントと Base URL →

目次

最終確認:2026-09-18 · 📄 公式ドキュメント準拠(Aider のリポジトリ、状態は下記の注記参照)

リポジトリの活動状況:Aider-AI/aider の最終コミットは 2026-05-22 で、以降の新規リリースはありません(2026-09-18 に GitHub API で確認)。本ページの接続方法はそのまま利用可能です。活発な保守が必要な場合は Cline や Kilo Code を検討してください。

概要

項目 内容
利用できるモデル Claude ✅(anthropic/ プレフィックスで Anthropic エンドポイント)· GPT ✅ · 中国系モデル ✅(OpenAI 互換)· Gemini ❌(本ページは Gemini を扱わない)
プロトコルと Base URL Anthropic:https://api.qcode.cc/api · OpenAI:https://api.qcode.cc/openai/v1
関連環境変数 ANTHROPIC_API_BASE と OPENAI_API_BASE がそれぞれ両経路を指す
設定場所 CLI 引数または ~/.aider.conf.yml
公式ドキュメント aider.chat

Aider はターミナルで動く人気のオープンソース AI ペアプログラマ(GitHub 39K+ スター)で、100 以上の言語に対応します。内部で LiteLLM を使ってモデルをルーティングするため、Anthropic と OpenAI の両プロトコルに対応しています。

🔴 最初にこれ:Claude は Anthropic エンドポイントが必須

QCode の OpenAI 互換エンドポイントは Claude モデルを受け付けません。OPENAI_API_BASE を QCode に向けて openai/claude-… というモデル名を使うと model_not_available_on_endpoint が返ります。

使いたいモデル Aider のモデル名プレフィックス 環境変数 値
Claude anthropic/ ANTHROPIC_API_BASE https://api.qcode.cc/api
GPT 系 / 中国系 4 ファミリー openai/ OPENAI_API_BASE https://api.qcode.cc/openai/v1

対応表は エンドポイントと API パス を参照。

Aider を選ぶ理由

  • 完全オープンソース:API 利用料のみ
  • Architect モード:一方が計画、もう一方が編集。品質が上がる
  • Git 深い統合:AI の編集ごとに git commit
  • Repository Map:tree-sitter によるコードベース全体のインデックス
  • 両プロトコル対応:Claude は Anthropic、GPT / 中国系は OpenAI

インストール

# pipx 推奨(隔離インストール)
pipx install aider-chat

# または pip
pip install aider-chat

Claude の設定(Anthropic エンドポイント)

export ANTHROPIC_API_BASE="https://api.qcode.cc/api"
export ANTHROPIC_API_KEY="cr_あなたのQCodeキー"

aider --model anthropic/claude-sonnet-5

LiteLLM がこの base に /v1/messages を自動で連結するため、/api までとし末尾スラッシュは付けません。

変数名はバージョンで異なることがあります:LiteLLM では ANTHROPIC_API_BASE と ANTHROPIC_BASE_URL の両方が使われてきました。片方が効かない場合はもう片方を、あるいはコマンドライン引数 --anthropic-api-key を試してください。詳細は Aider 公式ドキュメント。

永続化(~/.zshrc または ~/.bashrc に追記):

echo 'export ANTHROPIC_API_BASE="https://api.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="cr_あなたのQCodeキー"' >> ~/.zshrc
source ~/.zshrc

GPT と中国系モデルの設定(OpenAI 互換エンドポイント)

export OPENAI_API_BASE="https://api.qcode.cc/openai/v1"
export OPENAI_API_KEY="cr_あなたのQCodeキー"

aider --model openai/gpt-6-sol

中国系 4 ファミリー(glm-5.2 / kimi-k3 / deepseek-v4-pro / qwen3.8-max など)は両方の経路で動きます。id は 中国系モデル連携 を参照。

使い方

cd /path/to/your/project

# 日常の主力
aider --model anthropic/claude-sonnet-5

# 旗艦モデル
aider --model anthropic/claude-opus-5

Architect モード(推奨)

一方が計画し、もう一方が編集を適用します:

# Opus が計画 + Sonnet が編集(推奨)
aider --architect --model anthropic/claude-opus-5 --editor-model anthropic/claude-sonnet-5

# Sonnet が計画 + Haiku が編集(低コスト)
aider --architect --model anthropic/claude-sonnet-5 --editor-model anthropic/claude-haiku-5-5

2 つのモデルは同じプロトコル経路である必要があります。混在(例:anthropic/ で計画、openai/claude-… で編集)すると編集側で拒否されます。

よく使うコマンド

Aider セッション内:

コマンド 説明
/add file.py ファイルをチャットのコンテキストに追加
/drop file.py ファイルを除外
/run pytest コマンドを実行し出力を AI に送る
/diff すべての変更を表示
/undo 直前の AI 編集を取り消す
/commit 現在の変更をコミット
/help ヘルプを表示

その他のノード

3 つのアクセスドメインは機能的に同一で、違いはネットワーク経路だけです。キーは共通:

ノード Anthropic(Claude) OpenAI(GPT / 中国系)
グローバル https://api.qcode.cc/api https://api.qcode.cc/openai/v1
アジア(中国本土推奨) https://asia.qcode.cc/api https://asia.qcode.cc/openai/v1
北米 / 欧州 https://us.qcode.cc/api https://us.qcode.cc/openai/v1

利用可能なモデル

モデル Aider での名前 説明
Claude Sonnet 5 anthropic/claude-sonnet-5 推奨、コスパ良好
Claude Opus 5 anthropic/claude-opus-5 最も高性能
Claude Haiku 5.5 anthropic/claude-haiku-5-5 低コスト・高速
GPT-6 Sol openai/gpt-6-sol OpenAI 旗艦
GLM 5.2 openai/glm-5.2 中国系、単価が低い

claude-sonnet-4-6、claude-opus-4-8 などの 4.x も引き続き販売中です(プレフィックスは同じく anthropic/)。最新一覧は qcode.cc/models。

Claude Code CLI との比較

観点 Aider Claude Code CLI
オープンソース 完全オープン クローズド
Git 統合 編集ごとに自動 commit 手動 /commit
Architect モード 2 モデルで計画+編集 単一モデル
ツール能力 ファイル編集 + Shell より豊富(LSP、検索、ブラウザ)
コンテキスト管理 Repository Map インデックス 20 万〜100 万トークン
クォータ QCode.cc プランを共有 QCode.cc プランを共有

おすすめの組み合わせ:素早い修正と Architect モードの計画には Aider、複雑なプロジェクト分析や自動化には Claude Code CLI。

よくある質問

model_not_available_on_endpoint が出る

Claude モデルを OpenAI 経路に送っています。2 点を確認してください:モデル名のプレフィックスは openai/ ではなく anthropic/、base は ANTHROPIC_API_BASE=https://api.qcode.cc/api。

"Model not found" が出る

Aider はプレフィックスで provider を判断します:

# 正しい
aider --model anthropic/claude-sonnet-5

# 誤り(プレフィックスなし)
aider --model claude-sonnet-5

API 呼び出しがタイムアウトする

別ノードに切り替えるか、タイムアウトを延ばします:

aider --model anthropic/claude-sonnet-5 --timeout 120

次のステップ

QCode を始める

API キーひとつで Claude Code・Codex などに対応。トークン単位の課金で、各モデルの単価は qcode.cc/models に掲載

企業版 →