著者 VPSでAiderやGooseを動かす方法
VPSでAiderまたはGooseをターミナルから実行する手順です。Ubuntu 24.04のPEP 668対策、Ollamaのモデルサイズ、tmuxと安全な運用を解説します。
VPS でコーディングエージェントを実行する理由
コーディングエージェントは、コードベースを読み取り、変更を加え、ターミナルからテスト用のコマンドを実行するツールです。VPS で実行すると、ノートパソコンよりも 3 つの利点があります。切断後も処理を継続できること、コードとビルドツールのすぐ近くで動作すること、そして自分でホストするモデルと通信できることです。tmux セッション内で起動すれば、ノートパソコンを閉じた後でも、後から作業を再開できます。これは VPS 上で tmux を使って Claude Code を実行する場合と同じ方法です。
ターミナルベースのエージェントでは、2 つを知っておくとよいでしょう。Aider はターミナルに特化した、git を中心に据えた選択肢です。各変更を適切なメッセージ付きで自動コミットするため、履歴を整理された状態に保ち、すべての編集を元に戻せます。ターミナル用コーディングエージェントの中でも特に歴史が長い製品の 1 つですが、リリースのペースは低下しています。Block が開発する Goose は、より広範な用途に対応します。Apache-2.0 ライセンスのエージェントで、大規模な拡張機能エコシステムを備えています。ローカルの Ollama モデルを含む多くのプロバイダーもサポートしており、現在は Linux Foundation の Agentic AI Foundation (AAIF) の下で開発されています。規律ある git 中心のワークフローには Aider が適しており、幅広いプラグインを備えた汎用アシスタントには Goose が適しています。
必要なもの
Aider を使用する場合は、git、tmux、Aider に対応する新しい Python がインストールされた VPS が必要です。Goose を使用する場合は、Goose のインストーラーを用意します。さらに、モデルも必要です。Anthropic や OpenAI などのプロバイダーが提供するホスト型 API key、または 同じ VPS 上の Ollama で提供するローカルモデルを使用できます。セルフホスト構成ではコードを自分のサーバー内に保持でき、トークン単位の費用もかかりません。ただし、十分な性能のモデルを動かすには、必要なメモリを確保する必要があります。
Aider のインストールと実行
Ubuntu 24.04 では、仮想環境外で通常の pip install を実行できないようにブロックされているため（PEP 668）、apt から提供される pipx を使い、分離環境に Aider をインストールします。その後、切断されても処理が続くように tmux セッション内でプロジェクトに移動し、Aider を実行します。
sudo apt install pipx
pipx ensurepath
pipx install aider-chat
tmux new -s aider
cd ~/my-project
aiderバージョンに関する注意点があります。このインストール方法は Ubuntu 24.04 では記載どおりに動作します。現在、Ubuntu 26.04 では失敗します。Aider が固定している依存関係に、Ubuntu 26.04 の Python 3.14 ではビルドできない古い numpy が含まれているためです。対処するには、Aider 専用の Python 3.12 を用意します。
pipx install --python 3.12 --fetch-missing-python aider-chatpipx が Aider 専用の独立したインタープリターをダウンロードするため、インストールが完了します。これは Aider のリリースペースが落ちていることによる症状です。気になる場合は、より活発に保守されている Goose が適しています。
起動したら、Ctrl-b の後に d を押してセッションからデタッチします。ノートパソコンを閉じてもエージェントは処理を続けます。後で tmux attach -t aider を使って再アタッチし、変更内容を確認できます。2 つ目の tmux ウィンドウを開いて別のエージェントを実行することもできます。両方が Claude Code であれば、2 つのセッションで作業を受け渡しできます。その場合、あなたが手作業で中継する必要はありません。Aider はリポジトリを読み取り、編集を提案して適用し、その都度コミットします。変更が複数のファイルにまたがる場合は、コンテキストとして追加のファイルを読み込むこともできます。すべての変更がコミットになるため、エージェントによる変更は通常の git revert で取り消せます。これが、安心して使うための安全策になります。Goose は公式ドキュメントにある 1 行のスクリプトでインストールでき、ターミナルから同様に実行できます。拡張機能を通じてタスクを処理します。
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bashホスト型モデルとセルフホスト型モデル
ホスト型モデルは最高品質を得やすく、ローカルのハードウェアも不要ですが、トークン単位で料金が発生し、コードはプロバイダーに送信されます。エージェントはターンごとに会話全体を再送信するため、トークン料金は多くの人が想定するより速く増加します。長時間のエージェントセッションで実際にトークンをどれだけ消費するかにある Claude Code の内訳は、Aider と Goose も同じ方法で課金されるため、ここにも当てはまります。Ollama を通じたセルフホスト型モデルなら、すべてをサーバー上に保持できます。ハードウェアの購入後は無料で実行できますが、実用に十分なコーディングモデルには相応のメモリが必要です。検討すべきトレードオフは、品質と利便性をプライバシーとコストのどちらと優先するかです。
セルフホスト型を選ぶ場合、実際の問題はサーバーに適合するモデルを選ぶことです。同時にコンテキストウィンドウも確認してください。Ollama のデフォルト値は小さく、それを超える内容は警告なしに切り詰められます。コーディングエージェントでは、直前に読み込んだファイルがプロンプトから消えることを意味します。num_ctx を増やすことで解決できます。必要になる大きな KV キャッシュも、見積もるメモリに含めてください。8 ギガバイトのモデルを、保持できないサーバーにダウンロードする前に必要な容量を計算します。
安全対策: ファイルを編集し、コマンドを実行します
コーディングエージェントは受動的なツールではありません。ファイルを書き換え、ビルドやテストのコマンドを実行できるため、システムを変更できるプロセスと同じように慎重に扱ってください。リスクの大半は、3 つの習慣で抑えられます。まず、git リポジトリ内で作業します。すべての変更が追跡され、元に戻せるためです。この処理は Aider が自動的に行います。次に、エージェントは通常の権限を持たないユーザーとして実行し、決して root では実行しません。最小権限のユーザーに従えば、誤ったコマンドがシステム全体に影響することを防げます。さらに、サーバー自体も適切に堅牢化してください。コーディング用 VPS も公開サーバーであることに変わりはないため、鍵認証のみの SSH、デフォルト拒否のファイアウォールなどが必要です。OpenClaw の堅牢化ガイドも、より自律的なエージェントについて同じ方針を採用しています。この原則は他の環境にも適用できます。
コーディングエージェントを自分のワークフローに組み込む方法については、Claude で AI エージェントを構築するで、1 つのモデルからツールを操作する方法を説明しています。VPS で Google の Gemini CLI を実行するは別のターミナルの選択肢で、OpenHands をセルフホストするは、より重量級の自律運用向けです。この分野で現在最も多くのスターを獲得しているオープンプロジェクトにも、専用ガイドがあります。VPS で OpenCode を実行するでは、同じ tmux と権限を持たないユーザーの構成でセットアップします。
FAQ
有料 API の代わりにローカルモデルでコーディングエージェントを実行できますか？
はい。Aider と Goose はどちらも Ollama が提供するローカルモデルに対応しています。そのため、トークン単位の料金なしで、コードをサーバー外へ送信せずに、コーディングエージェントを完全にセルフホストできます。ただし、メモリが必要です。有用なコードを書けるモデルには十分な RAM または VRAM が必要になるため、導入前にモデルに合わせてマシンの容量を決めてください。
Aider と Goose のどちらを使うべきですか？
ターミナルと git を中心に運用し、成熟していてオーバーヘッドの少ない構成を求めるなら Aider を選んでください。Aider は変更を毎回自動的にコミットするため、履歴から変更を戻せます。より汎用的なアシスタント、大規模な拡張機能エコシステム、多数のプロバイダーへの対応を求めるなら Goose を選んでください。どちらもターミナルから実行でき、Ollama に対応しているため、VPS のいずれの環境にも適しています。
セルフホストのコーディングモデルには、どの程度のメモリが必要ですか？
モデルのサイズと量子化の度合いによって異なります。小型の量子化モデルは数 GB で実行できますが、より高性能なモデルにははるかに多くのメモリが必要です。コンテキストウィンドウを長くすると、必要量はさらに増えます。ダウンロードする前に、上記のサイジングツールを使って、モデルとコンテキスト長に必要なメモリを見積もってください。
AI エージェントにコードの編集やコマンドの実行を許可しても安全ですか？
適切な運用をすれば管理できます。作業内容は git リポジトリで管理し、すべての編集を元に戻せるコミットとして保存してください。エージェントは root ではなく非特権ユーザーで実行し、公開サーバーと同じように VPS を堅牢化してください。エージェントがコミットした変更を無条件に信頼せず、特にシステム上で実行しようとするコマンドは確認してください。