Aider×Claude APIでターミナルからコードを書き直す

AIコーディングツールの選択肢は増えているが、悩みも増えている

AIを活用したコーディング支援ツールは、ここ数年で急速に普及しました。 GitHub Copilot、Cursor、Claude Codeなど、様々な選択肢が登場しています。しかし、これらのツールを使っているエンジニアから、こんな声をよく聞きます。

「IDEの拡張機能が重くて、起動のたびにストレスを感じる。」「月額費用が積み重なると、個人開発や小規模チームには痛い出費になる。」「社内のセキュリティポリシーで外部クラウドAPIへの送信が制限されている。」「サーバー上でバッチ処理として動かしたいのに、GUIツールでは対応できない。」

こうした課題に応えるのが、Aider です。 Aiderはターミナル（コマンドライン）から動作するオープンソースのAIペアプログラマーで、Claude API、OpenAI API、Gemini、さらにOllamaを使ったローカルモデルにまで幅広く対応しています。 IDEは不要で、pip install aider-chat の1行でインストールでき、すぐに使い始められます。

この記事では、Aiderの概要と特徴をていねいに解説し、Claude APIとの接続設定から主な操作コマンド、実際の業務活用シーン、そしてCursor・Claude Codeとの使い分け方まで一通り紹介します。ターミナル作業が多いバックエンドエンジニアや、コスト意識の高い個人開発者に特におすすめの内容です。

Aiderとは何か：特徴と仕組みを理解する

オープンソースのCLI型AIペアプログラマー

Aider は、Pythonで書かれたオープンソースのAIコーディングアシスタントです。 GitHubで公開されており、誰でも無料でソースコードを確認・改変できます。 GUIは一切なく、すべてターミナル上のチャット形式で操作します。

ユーザーが自然言語で指示を入力すると、AIがコードを生成・編集し、その変更をそのままGitコミットとして記録します。「このクラスにメソッドを追加して」「この関数のバグを直して」「テストを書いて」といった自然な日本語の指示にも対応しています。

Gitとの深い統合がもたらす安心感

Aiderのもっともユニークなポイントのひとつが、Git と深く統合されている ことです。 AIが行ったコード変更はすべて自動的にGitコミットとして保存されます。コミットメッセージもAIが自動生成するため、「何を変えたか」を後から追いやすくなります。

気に入らない変更があればすぐに /undo コマンドで取り消せます。 Gitのコミット単位で巻き戻せるため、「AIに任せて思わぬバグが入った」という事態も安心して対処できます。この設計は、AIを信頼しながらも自分でコントロールしたいエンジニアに非常に好評です。

豊富なモデル対応という柔軟性

Aiderは以下のようなAIモデルに対応しています。

Claude（Anthropic）：Sonnet、Opusなど各種モデル
GPT-4、GPT-4o（OpenAI）
Gemini（Google）
Ollama経由のローカルモデル（Llama、Mistralなど）
OpenAI互換APIを持つその他のモデル

ローカルモデル対応は、クラウドAPIへのデータ送信を避けたい企業や、コストゼロで使いたい個人開発者にとって大きなメリットです。

4つのチャットモード

Aiderのチャットには複数のモードがあり、用途に応じて切り替えられます。

code モード：デフォルトのモード。AIが直接ファイルを編集する
architect モード：まず大きなモデルで設計方針を立て、別のモデルにコーディングを任せる2段階方式。複雑なタスクに有効
ask モード：コードを編集せず、質問への回答や解説だけを行う
help モード：Aider自身の使い方や機能について聞けるモード

インストールとClaude APIとの接続設定

インストール手順

Aiderのインストールは pip を使います。 Python 3.10以上が必要です。 pipx でインストールすれば依存関係をシステム全体から分離できるため、こちらの方法をおすすめします。

# pipxでのインストール（環境分離のためおすすめ）
pipx install aider-chat

# または通常のpipでインストール
pip install aider-chat

# バージョン確認でインストール成功を確認
aider --version

# ヘルプを表示してオプション一覧を確認
aider --help

インストール後、aider --help を実行してオプション一覧が表示されれば、正常にインストールできています。

Claude APIとの接続設定

Claude APIを使う場合は、ANTHROPIC_API_KEY 環境変数を設定します。 Anthropicのコンソール（console.anthropic.com）でAPIキーを発行し、以下のように環境変数に設定してください。

# 環境変数の設定
# .bashrc または .zshrc に追記しておくと毎回設定不要
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxx

# Claude Sonnetモデルでプロジェクトディレクトリに移動して起動
cd /path/to/your/project
aider --model claude-sonnet-4-5

# architect モードで起動する場合
aider --model claude-opus-4-5 --architect

# 対応モデルの一覧確認
aider --list-models anthropic/

モデル名は aider --list-models anthropic/ コマンドで確認できます。 Anthropicが提供しているモデルは基本的に指定可能ですが、利用にはAnthropicアカウントと有効なAPIクレジットが必要です。

設定ファイルで毎回の入力を省略する

Aiderはプロジェクトルートに .aider.conf.yml を置くことで、起動オプションを自動読み込みできます。チームで共有するプロジェクトでは、この設定ファイルをリポジトリに含めておくと便利です。

# .aider.conf.yml の設定例
model: claude-sonnet-4-5
auto-commits: true
dark-mode: true
# テストコマンドの設定（/testコマンドで実行されます）
test-cmd: pytest tests/ -v

この設定ファイルを置いたディレクトリで aider と入力するだけで、設定済みのモデルとオプションが自動的に反映されます。プロジェクトごとに .aider.conf.yml を使い分けることで、異なるプロジェクトでも最適な設定を維持できます。

主な操作コマンドと使い方

Aiderを起動するとターミナル上にチャットUIが開きます。ここからAIに自然言語で指示を出せます。まず覚えておきたい基本コマンドを紹介します。

ファイルをコンテキストに追加・削除する

Aiderでは、AIに編集させたいファイルを明示的に「コンテキスト」に追加する必要があります。追加されたファイルの内容がAIへのプロンプトに含まれます。

/add src/utils.py — ファイルをコンテキストに追加
/add src/ — ディレクトリ内のファイルをまとめて追加
/drop src/utils.py — コンテキストから削除
/ls — 現在コンテキストに含まれているファイルの一覧表示

不要なファイルを大量に追加するとトークン消費が増えコストが上がるため、作業に関連性の高いファイルだけを絞り込む習慣が大切です。

変更の確認と取り消し

/diff — 直近のGit変更差分を表示
/undo — AIによる直前のコミットを取り消し
/git log --oneline -5 — Aider経由のコミット履歴確認（gitサブコマンドはほぼすべて使用可能）

/undo は非常に便利なコマンドで、「AIが想定外の変更をした」「余計なリファクタリングが入った」といった場合もワンコマンドで元の状態に戻せます。

コードの実行とテスト

/run python main.py — 任意のシェルコマンドをAiderから実行し、出力をAIに共有
/test — .aider.conf.yml で設定したテストコマンドを実行

/run でテストを実行し、失敗した場合の出力をAIが確認して修正提案を行う、というフローが非常に実用的です。 --auto-test オプションを有効にすると、コード変更のたびに自動でテストが走るようにもなります。テストが通るまでAIが繰り返し修正を試みるため、TDDに近いワークフローを実現できます。

実際の業務での活用シーン

既存コードのリファクタリング

「このファイルの長い関数を、責務ごとに小さい関数に分割してください」といった指示をAiderに伝えると、ファイルを解析して分割案を提示しコミットします。「PEP 8に準拠した変数名に統一して」「型ヒントを全関数に追加して」のような定型作業も得意です。

チームのコーディング規約に合わせた変換作業は手作業では時間がかかりますが、Aiderなら関連ファイルを一度にコンテキストに入れて一括で処理させられます。

バグ修正支援

エラーが発生した場合、エラーメッセージとスタックトレースをそのままAiderのチャットに貼り付けるだけで、AIが原因を推定して修正案を提示してくれます。 /run コマンドでエラーが出たスクリプトをその場で実行し、出力結果をAIに直接確認させることもできます。このフローを使うと、デバッグのサイクルが大幅に短縮されます。

テストの自動生成

「src/parser.py の全パブリックメソッドに対するユニットテストを pytest で書いて」と指示すれば、テストファイルを新規作成してコミットします。既存のテストファイルを /add でコンテキストに含めておくと、既存のテストスタイルに揃えた形で生成されます。テストカバレッジが不十分なプロジェクトで一気にカバレッジを上げたいときに特に有効です。

CI/CDパイプラインへの組み込み

AiderはCLIツールであるため、GitHub ActionsやGitLab CIなどのCIパイプラインにも組み込めます。「プルリクエストのレビューコメントに応じて自動修正を行う」「特定のラベルが付いたIssueに対してコードの修正案を自動生成する」といった自動化ワークフローの構築も可能です。 GUIが不要なCLI構造が、この種の自動化と非常に相性がよいです。

Claude Code・Cursorとの使い分け基準

Aider、Claude Code、Cursorはいずれも「AIとともにコードを書くツール」ですが、それぞれ得意な場面が異なります。

Aiderが向いているシーン

ターミナル完結で軽量に使いたい場合：IDEのセットアップが不要で、リモートサーバーでもSSH経由でそのまま使えます。 ローカルモデルを使いたい場合：Ollamaを使えばインターネット接続なしで完全オフライン動作が可能です。 CIやスクリプトに組み込みたい場合：CLIとして動作するため、シェルスクリプトやMakefileからの呼び出しが容易です。 コストを細かく管理したい場合：APIの使用トークン数がターミナル上に表示されるため、コスト把握がしやすいです。 Git履歴で変更を追いたい場合：AIの変更がすべてGitコミットとして残るため、チームでのレビューやロールバックが簡単です。

Claude Codeが向いているシーン

Anthropicが直接提供するCLIツールであり、Claudeの最新機能やモデルアップデートにいち早くアクセスできます。コードベース全体を把握した上での大規模なリファクタリングや、複雑な要件定義から実装までを一連の作業として任せたい場合に強みがあります。

Cursorが向いているシーン

VSCodeベースのGUIで操作するため、インラインのコード補完やファイル間のナビゲーションが直感的です。フロントエンド開発やUI実装など、コードとプレビューを並べながら視覚的に確認したい作業に特に向いています。 AIによるコード提案をインライン表示で確認しながら選択・修正できるため、細かい調整が多い場面でも快適に使えます。

3ツールの使い分けまとめ

シンプルな選択基準 として、以下のような使い分けが現実的です。

「ターミナル完結・ローカルモデル・CI組み込み」を重視するなら Aider
「GUI操作・フロントエンド中心・インライン補完」を重視するなら Cursor
「Claudeの最先端機能・大規模リファクタリング・深いコード理解」を重視するなら Claude Code

3つのツールは競合というよりも補完関係にあるため、プロジェクトごと・タスクごとに使い分けるのが最も効率的です。

まとめ：まず小さく試して、自分の開発フローに取り込もう

Aiderは、ターミナルとGitに慣れたエンジニアであれば非常に低いコストで始められるAIコーディングツールです。 pip install aider-chat のあとにAPIキーを1行設定するだけで、数分で使い始められます。

IDEへの依存をなくしたい方、ローカルモデルで安全に使いたい方、CIに自動化フローを組み込みたい方など、さまざまなニーズに応えられる柔軟さがAiderの強みです。

まず次のステップから実際に試してみてください。

pipx install aider-chat でインストールする
Anthropicコンソールでですでにお持ちのAPIキーを export ANTHROPIC_API_KEY=... で設定する
手元のGitリポジトリで aider --model claude-sonnet-4-5 を起動する
/add でファイルを追加して、「このファイルのテストを書いて」と自然言語で指示してみる

最初の一歩を踏み出せば、AIとのペアプログラミングがどんなものか、すぐに体感できます。まずは個人プロジェクトや小さなスクリプトから気軽に試してみてください。