OpenCode、Ollama、Qwen を使ってオフラインコーディングエージェントを構築・実行する方法
10月27日 · 読了時間 9分

リモートワークについて語るとき、私たちは多くのこと、とりわけ安定した信頼性の高いインターネット接続や電力を当たり前のものと考えがちです。しかし実際には、飛行機の中や長時間の電車の移動中、あるいは電波が微弱だったり圏外だったりする場所で仕事をこなさなければならないケースもあります。
1年前、私はヒマラヤ山脈の麓へと移住しました。ここの静けさがとても気に入っていますが、ネットワークの寸断や停電といった特有の課題も伴います。かつては深く考えもしなかったような多くの事柄が、今では仕事の計画を立てるうえで欠かせない考慮事項となっています。
私は**トムソン・ロイター(Thomson Reuters)のプリンシパルエンジニア(Principal Engineer)として、日々の大半をコードの実装やチームメンバーのコードレビューに費やしています。コーディングエージェント(Coding Agent)は私の日常的なワークフローに深く浸透しており、ふと疑問に思いました。「オフラインの状態でも、このワークフローをどれだけ維持できるのだろうか?」**と。

ヒマラヤの麓でのリモートワーク。私のワークスペースの写真。
もしあなたも私のようにテクノロジーに触れるのが大好きで、かつネット環境が頼りにならないような人里離れた静かな場所で心の平穏を得ているなら、この記事はまさにうってつけです。また、完全にネットから切断された状態で、ノートPC単体だけでコーディングエージェントを動かせるのかに興味があるすべての人にも役立ちます。私はオフライン状態で実際にどれだけの作業をこなせるかを検証するため、ノートPC上でローカルにコーディングエージェントを動かしてみました。
オフラインで何ができるのか?
ノートPC上に既存のプロジェクトがあれば、十分に活用する余地があります。見慣れない関数の解説、失敗したテストのトラブルシューティング、小さなコードのリファクタリング、さらには機能実装のサポートなどをエージェントに依頼できます。**モデル、プロジェクトの依存関係、テストツールがローカルに揃ってさえいれば、**これらのタスクはすべてオフラインで実行可能です。ただし、新しいパッケージのダウンロードやWebでの情報検索には、依然としてインターネット接続が必要です。
OpenCode の役割
OpenCode は、ローカルプロジェクトと連携して動作するオープンソースのコーディングエージェントです。タスクを指示するだけで、ファイルの読み取り、修正案の提示、さらにはテストスイートの実行といったコマンドの処理までこなしてくれます。今回のセットアップでは、権限プロンプトの仕組みにより、コマンドやコードの変更を承認前にレビューできるようになっています。
OpenCode を選んだ理由は、ワークフローをターミナル内で完結させつつ、ローカルのノートPC上で稼働するモデルに接続できるためです。Ollama がモデルの実行を担い、OpenCode がプロジェクトとのやり取りを処理します。

Mac 上で動作する OpenCode。ローカルモデルとして Qwen3.5 9B を選択。
Qwen をはじめとするオープンウェイトモデル(open-weight models)の存在が、これを可能にしています。応答の生成に使われる学習済みパラメータである重みをダウンロードし、ローカルで実行できるのです。**Ollama を使って同じノートPC上で Qwen を動かすことで、OpenCode はローカルサービスにリクエストを送信できるようになります。**必要なものをすべて事前にダウンロードしておけば、コーディング作業中はネットワークから切断しても問題ありません。
ガイド付きのエディットワークフローを好む場合は、Aider も優れた選択肢のひとつです。こちらも Ollama をサポートしています。本記事の実践デモでは、環境構築と検証結果の一貫性を保つため、一貫して OpenCode を使用します。

OpenCode がプロジェクトファイルを操作し、同じノートPC上の Ollama へモデルリクエストを送信します。Ollama はローカルで Qwen を実行します。
オープンソースモデルの選定
Qwen にはさまざまなサイズバリエーションが用意されています。私は