Aider 連携

オープンソース AI プログラミングアシスタント Aider で QCode.cc API を利用する

Aider 連携 ¶

Aider は人気のオープンソース AI プログラミングアシスタント（GitHub Stars 39K 以上）で、ターミナル上で動作し、100 以上のプログラミング言語に対応しています。簡単な環境変数の設定だけで QCode.cc API と連携できます。

Aider を選ぶ理由 ¶

完全オープンソースで無料：API 料金のみが必要
Architect モード：一つのモデルで計画、もう一つで実行し、コード品質を向上
Git との深い統合：AI の編集ごとに自動で git commit を生成
Repository Map：tree-sitter ベースでコードベース全体をスマートにインデックス
最も簡単な設定：環境変数 2 行で QCode.cc に接続

インストール ¶

# pipx での隔離インストールを推奨
pipx install aider-chat

# または pip を使用
pip install aider-chat

QCode.cc の設定 ¶

方法 1：環境変数（推奨）¶

export OPENAI_API_BASE="https://asia.qcode.cc/claude/v1"
export OPENAI_API_KEY="cr_your_api_key"

永続的に設定する場合（~/.zshrc または ~/.bashrc に追加）：

echo 'export OPENAI_API_BASE="https://asia.qcode.cc/claude/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' >> ~/.zshrc
source ~/.zshrc

方法 2：コマンドライン引数 ¶

aider --openai-api-base "https://asia.qcode.cc/claude/v1" \
      --openai-api-key "cr_your_api_key" \
      --model openai/claude-sonnet-4-6

使い方 ¶

基本的な使い方 ¶

# プロジェクトディレクトリに移動
cd /path/to/your/project

# Aider を起動（Claude Sonnet を使用）
aider --model openai/claude-sonnet-4-6

# Claude Opus を使用（より強力）
aider --model openai/claude-opus-4-6

Architect モード（推奨）¶

Architect モードでは、一つのモデルが計画を担当し、もう一つがコード変更を実行します：

# Opus で計画 + Sonnet で実行（推奨）
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6

# Sonnet で計画 + Haiku で実行（コスト節約）
aider --architect --model openai/claude-sonnet-4-6 --editor-model openai/claude-haiku-4-5-20251001

よく使うコマンド ¶

Aider セッション内で：

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

バックアップノード ¶

# 香港ノード
export OPENAI_API_BASE="http://103.218.243.5/claude/v1"

# 深センノード
export OPENAI_API_BASE="http://103.236.53.153/claude/v1"

利用可能なモデル ¶

モデル	Aider での名前	説明
Claude Sonnet 4.6	`openai/claude-sonnet-4-6`	推奨、コスパが良い
Claude Opus 4.6	`openai/claude-opus-4-6`	最強モデル
Claude Haiku 4.5	`openai/claude-haiku-4-5-20251001`	低コストで高速

注意：モデル名の前に openai/ プレフィックスを付ける必要があります。これにより Aider が OpenAI 互換エンドポイントを使用します。

Claude Code CLI との比較 ¶

項目	Aider	Claude Code CLI
オープンソース	完全オープンソース	非公開
Git 統合	編集ごとに自動 commit	手動 /commit
Architect モード	デュアルモデルで計画+実行	シングルモデル
ツール機能	ファイル編集 + Shell	より豊富（LSP、検索、ブラウザ）
コンテキスト管理	Repository Map によるスマートインデックス	20 万〜100 万トークンウィンドウ
クォータ	QCode.cc プランのクォータを共有	QCode.cc プランのクォータを共有

おすすめの組み合わせ：Aider は素早いコード修正と Architect モードでの計画に、Claude Code CLI は複雑なプロジェクト分析と自動化タスクに使うのが効果的です。

よくある質問 ¶

「Model not found」エラーが出る場合 ¶

モデル名の前に openai/ プレフィックスがあることを確認してください：

# 正しい
aider --model openai/claude-sonnet-4-6

# 誤り（プレフィックスがない）
aider --model claude-sonnet-4-6

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

バックアップノードへの切り替えか、タイムアウト時間の延長を試してください：

aider --model openai/claude-sonnet-4-6 --timeout 120

次のステップ ¶

Cline 連携で VS Code でのグラフィカルな代替手段を確認
CLI のヒントで Claude Code の上級な使い方を確認
Aider 公式ドキュメントでさらに詳しい機能を確認

← 前のページ

Cline 連携

OpenCode 統合

🚀

QCode を始めよう — AI プログラミングアシスタント

Claude Code 公式リレー、高速・安定・すぐに使える

料金プランを見る → アカウント登録