OpenCode：インストール、モデル、初回起動

OpenCodeは、ターミナルで使うオープンソースのAIコーディングエージェントです。ツール自体は無料（MITライセンス）で、ClaudeやGPTから、Ollama経由のローカルモデルまで、任意のモデルを接続できます。プロジェクトのGitHubリポジトリは、すでに20万スターを超えています。「どのモデルでも使える無料のClaude Code」という表現は魅力的に聞こえますが、補足が必要です。ツールは無料ですが、利用条件は選ぶモデルによって異なります。

以下では、公式ドキュメントに基づいて、ツールの概要、macOS、Linux、Windowsへのインストール方法、モデルの接続方法、初回起動時にすることを説明します。「無料」がここではツールだけを指すため、費用についての独立したセクションも設けました。モデルには料金がかかり、ここが混乱の原因になることがよくあります。

Ailootの活用方法はドキュメントをご覧ください。

コーディング用AIエージェントのOpenCodeとは？簡単に説明#

簡単に言うと、OpenCodeはClaude Codeと同じように、平易な言葉でタスクを受け取り、プロジェクト内で実行します。両者には大きな違いが2つあります。コードが完全に公開されているため、読んで確認できます。また、特定のモデルプロバイダーに縛られず、AnthropicやOpenAIから、自分のハードウェアで動くローカルモデルまで、75以上のプロバイダーに対応しています。

このプロジェクトはAnomalyチームが開発しています。リポジトリは2025年4月30日に作成され、2026年10月4日時点で21万1千を超えるスターと2万8千のフォークを獲得しています（GitHub APIリクエストで確認）。使用言語はTypeScriptです。ドキュメントは継続的に更新されているため、以下の手順は現行バージョンに基づいています。

名前を混同しないようにしましょう。現行系列のnpmパッケージはopencode-ai、リポジトリはanomalyco/opencode、ターミナルコマンドは単にopencodeです。古い記事にはsst/opencodeというアドレスが記載されていることがあります。組織名が変更され、古いリンクは新しいリンクにリダイレクトされます。

2026年10月4日更新：チームは、ツールの次期メジャー世代であるOpenCode 2.0をリリースしました。以下のインストールとモデル接続の手順は、現行の1.x系列を対象としています（コマンドcurl -fsSL https://opencode.ai/install | bashでインストールします。2026年9月30日時点の現行バージョンは1.18.34です）。この系列は引き続き積極的にサポートされており、opencode.ai/docsの公式ドキュメントがインストールするバージョンです。第2バージョンで具体的に何が変わったのか、いつ切り替えるべきかは、以下の独立したセクションで説明します。

OpenCodeはClaude CodeやCodexとどう違う？#

すでにClaudeのサブスクリプションを利用しているなら、Claude Codeをメインツールとして使い続けるのが妥当です。Claude Codeについては、詳しいインストールガイドをご覧ください。OpenCodeが適しているのは、ChatGPT PlusやGitHub Copilotのサブスクリプション経由で使いたい場合、API料金をかけずにローカルモデルを動かしたい場合、または複数のモデルを1つのインターフェースで使いたい場合です。Codexについても、レビューとインストールガイドがあります。

まだツールを選んでいる段階なら、まず2026年に何を使ってコーディングするかの概要をご覧ください。OpenCodeをすでにインストール済みで、ACP経由でDevin Desktopの他のエージェントと連携したい場合は、設定ガイドをご覧ください。

OpenCode 2.0で何が変わった？#

第2バージョンは、コマンドcurl -fsSL https://opencode.ai/v2/install | bashでインストールします。公式の移行ガイド（opencode.ai/v2/docs/migrate-v1）によると、両バージョンで同じopencodeコマンドを使い、デフォルトでは併存インストールされなくなりました。v2のインストーラーはv1のバイナリを置き換え、パッケージマネージャー経由でv2をインストールする前にv1を削除するよう、ドキュメントが明示しています。ただし、設定は同じファイル（~/.config/opencode/と<project>/.opencode/）から読み込むため、設定、エージェント、MCPサーバーは書き換えずに引き継がれます。書き換えが必要なのは3つです。新しいAPIを使うプラグイン、プロトコルが変更されたサーバーAPIとの連携、複数のtui.jsonファイルに代わって共有のcli.jsonファイルになったターミナル設定です。

v2で特に注目すべき新機能は2つあります。1つ目はConsoleです。利用状況の追跡、予算、すべてのメンバーで共有するポリシーを備えた、チーム向けの有料サービスです。2つ目は、Goサブスクリプションの料金がついに発表されたことです。Goは月額$10、より高い上限のGo Plusは月額$40です（opencode.ai/goのページを2026年10月4日に確認）。以前のドキュメントには、金額なしで「低料金のサブスクリプション」とだけ記載されていました。

初めて使う方やエージェントをインストールしたい方は、以下の手順に従ってください。公式ドキュメント自体が推奨する現行の初代バージョンを扱っています。新しいプラグイン機能やチーム向けConsoleが必要な場合はv2を検討してください。ただし、古いプラグインの一部は新しいAPIに合わせて書き換える必要があります。ターミナル不要のオープンソースデスクトップアプリケーションに関心があるなら、独自のインターフェースを備えた類似エージェント、ZCodeのレビューをご覧ください。

インストール前に必要なものは？#

インストールが予定どおり進まない可能性がある場所はターミナルだけなので、少し詳しく説明します。OpenCodeはターミナル内にパネルやハイライトを備えた完全なインターフェースを表示するため、ドキュメントでは最新のエミュレーターを求めています。起動後に表示がおかしい場合は、まず挙げられている4つの選択肢のいずれかをインストールしてください。WezTerm（すべてのシステムで動作）、Alacritty、Ghostty、Kittyです。Windowsでは、主な方法はWSL経由で、これについては以下の独立したセクションで説明します。

もう1つ必要なのはモデルです。OpenCodeは接続したモデルを通じて動作するため、単体ではリクエストを処理しません。選択肢は4つあります。サブスクリプション（ChatGPT Plus、GitHub Copilot、GitLab Duo）、任意のプロバイダーのAPIキー、チーム独自のアグリゲーターであるOpenCode Zen、またはOllama経由のローカルモデルです。4つの選択肢すべてを、モデル接続のセクションで説明します。

プロジェクトの説明がないと、エージェントはビルドコマンド、ファイル構成、使われている規約を推測しなければならず、「幻覚」が生じます。OpenCodeではAGENTS.mdファイルを使います。同じ考え方はClaude Codeやその他のエージェントにも当てはまり、変わるのは指示ファイルの名前だけです。

macOSとLinuxにOpenCodeをインストールする方法#

推奨されるのは、公式インストーラーを使う方法です。

1. インストーラーを実行する

   curl -fsSL https://opencode.ai/install | bash
   

   スクリプトがシステムを検出してOpenCodeをダウンロードします。インストール後にコマンドが見つからない場合は、ターミナルを閉じて開き直してください。新しいセッションでパスが認識されます。

2. 正しくインストールされたか確認する

   opencode --version
   

   コマンドがバージョン番号を返せば、インストールは成功です。「command not found」と表示された場合は最初の手順に戻り、新しいターミナルセッションを開始するか、PATHを手動で編集してください。

自分でパッケージを管理したい場合は、次の方法があります。

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Homebrewコマンドが意図的にanomalyco/tap/から始まるのは、Homebrewチームがbrew install opencodeのformulaを更新する頻度が低いため、独自のtapを使うようドキュメントが推奨しているからです。同じパッケージ名opencode-aiは、bun、pnpm、yarnでも使えます（bun install -g opencode-ai、yarn global add opencode-ai）。Arch Linuxでは、安定版リポジトリからsudo pacman -S opencodeを使うか、AURの最新バージョンにはparu -S opencode-binを使います。

OpenCodeを更新するにはopencode upgradeを実行します。自動更新が有効なら、起動時にも更新がダウンロードされます。更新後は、いつものopencode --versionでバージョンを確認してください。アンインストール機能も組み込まれています。

opencode uninstall

このコマンドは削除対象を正確に表示し、確認を求めます。設定とセッションデータを残すこともできます。その場合は--keep-configと--keep-dataフラグを使います。

WindowsにOpenCodeをインストールする方法#

開発者自身が推奨する最初の選択肢はWSLです。管理者として実行したPowerShellで、コマンドを1つ実行してインストールします。

wsl --install

再起動後、スタートメニューからUbuntuを開き、そこでいつものコマンドを実行します。

curl -fsSL https://opencode.ai/install | bash

Windowsドライブ上のファイルには、WSL内の/mnt/経由でアクセスできます。C:ドライブは/mnt/c/、D:ドライブは/mnt/d/にあります。そのため、C:\Users\Name\projectにあるプロジェクトは、次のように開けます。

cd /mnt/c/Users/Name/project
opencode

2つ目の選択肢はWSLを使わず、Windowsのパッケージマネージャーを利用する方法です。PowerShellで実行します。

choco install opencode

scoop install opencode

3つ目の選択肢は、デスクトップアプリケーションとWeb版です。アプリケーションは一般的なプログラムと同じようにインストールでき、ターミナルを使わずにウィンドウでインターフェースを表示します。Web版はopencode webコマンドで起動します。OpenCodeがブラウザーで開き、ファイルへのアクセス問題を避けるため、ドキュメントではこれもWSLから起動するよう推奨しています。ドキュメントには、利用頻度の低い選択肢としてmise、Docker、GitHubのリリースページにある既成バイナリも記載されています。Windowsでのbun経由のインストールはまだ開発中です。bunをメインのパッケージマネージャーとして使っている場合は、npmを利用してください。

OpenCodeにモデルを接続する方法#

OpenCodeはAI SDKとModels.devを通じて75以上のプロバイダーに対応し、ローカルモデルも利用できます。大半はインターフェース内の/connectコマンドで接続します。ローカルモデルの場合は、設定でサーバーアドレスも指定します。選択肢によって支払い方法とコンピューターの要件が異なります。

ドキュメントでは、初心者はOpenCode Zenから始めるよう推奨しています。チームがエージェント向けに特に相性のよいモデルを選び、プロバイダーとの組み合わせを独自のタスクでテストしています。

接続手順は次のとおりです。/connectと入力し、OpenCode Zenを選び、サインインしてopencode.ai/authで支払いを追加し、キーを取得して貼り付けます。その後、/modelsに推奨モデルの一覧が表示されます。2026年10月4日時点で、一覧にはたとえばGPT 6.1 Sol、GPT 6 Astra、Claude Opus 5.5、Claude Sonnet 5、GLM 5.3、Kimi K2.5が含まれています。ドキュメントでは、一覧は網羅的ではなく、新しいモデルが毎週登場するためすぐに古くなると、率直に注意しています。

サブスクリプションも同じ/connectコマンドで接続します。一覧からChatGPT PlusまたはGitHub Copilotを選び、自分のアカウントにサインインすれば完了です。追加の設定は必要ありません。

Anthropicを選ぶと、/connectに2つの方法が表示されます。APIキーを手動で入力する方法と、Claude Pro/Maxを選んでブラウザーから認証する方法です。ただし、AnthropicはClaude Pro/Maxサブスクリプションの利用に第三者プラグインを使うことを禁じており、OpenCodeではバージョン1.3.0から、この種の組み込みプラグインが削除されています。「ClaudeのサブスクリプションでOpenCodeを使う」という古い記事を見かけた場合、それは削除されたプラグインのことであり、公式の認証方法ではありません。ChatGPT Plus、GitHub Copilot、実験的と表示されるGitLab Duo、Atomic Chatのサブスクリプションは、追加設定なしで利用できます。

/connectから入力したキーは、OpenCodeによって~/.local/share/opencode/auth.jsonファイルに保存されます。毎回モデルを選びたくない場合は、プロジェクトのルートにあるopencode.json設定ファイルでデフォルトモデルを指定します。

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

形式はprovider/modelです。どちらの識別子も/modelsの出力に表示されます。

Ollama経由でローカルモデルを接続する方法#

この方法ならAPI料金は一切かかりません。モデルが自分のコンピューター上で動作します。無料モデル全般から選ぶ際の参考として、エージェントとしてある程度実用になるモデルと、理論上しか使えないモデルをまとめた別のレビューもあります。OpenCodeで使う場合は、公式サイトからOllamaをインストールして、モデルをダウンロードします。

ollama pull qwen3-coder

ドキュメントの便利な情報として、OllamaはOpenCode用の設定を自動で行えます。専用の連携ガイドもあります。すべてを手動で設定する場合は、ローカルのOllamaサーバーのアドレスを指定したプロバイダーをopencode.jsonに追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

インターフェースで/modelsを実行すると、ローカルモデルが一覧に表示されます。選択して作業を始めてください。ドキュメントでは、エージェントがツール（ファイル編集やコマンド実行）を呼び出さなくなった場合、Ollamaの設定でnum_ctxを増やすよう注意しています。まず16k～32kに設定してみてください。ローカルモデルは、エージェントとしての作業ではクラウドモデルより性能が劣り、コンテキストが小さいとさらに悪化します。ローカル版で足りない場合は、キーを使ってクラウドのQwenを接続できます。キーの取得方法はQwen CodeのAPIキー取得ガイドで説明しています。

OpenCodeとその利用にかかる費用は？#

ここで説明する費用はすべてモデルにかかるもので、利用方法は4つあります。APIキーまたはZenを使う場合は従量課金で、金額はエージェントの利用量によって異なります。Goは、OpenCodeチームが提供するオープンモデル向けのサブスクリプションプランです。Goは月額$10、上限がより高いGo Plusは月額$40です（opencode.ai/goのページを2026年10月4日に確認）。上限はモデルごとに異なります。たとえばGoでは、Kimi K3は5時間あたり約110リクエスト（月あたり440回）、軽量モデルのDeepSeek V4.1 Flashは5時間あたり約26,000リクエストが可能です。上限を超えて特定モデルを利用する場合の別料金もドキュメントに記載されています（Kimi K3は月額$15、Go Plusは$60）。モデルと上限の全一覧は、接続時にサブスクリプションのページをご覧ください。ChatGPT PlusまたはCopilotを使う場合、リクエストはすでに支払っているサブスクリプションで利用できます。ただし、サブスクリプションには独自の利用上限があります。最後に、Ollama経由のローカルモデルへのリクエストは無料ですが、十分な速度で動かすには高性能なコンピューターが必要です。

初回起動時にすることは？#

初回起動時は、プロジェクトのフォルダー内で次のコマンドを実行します。

cd path/to/project
opencode

入力欄のあるインターフェースが開きます。まず/initコマンドを使います。エージェントがリポジトリの重要なファイルをスキャンし、必要に応じていくつか質問した後、プロジェクトの構成、ビルドやテストに使うコマンド、規約を説明するガイド、AGENTS.mdファイルを作成します。このファイルはgitにコミットするようドキュメントで推奨されています。OpenCodeはその後、このファイルを恒久的なプロジェクト指示として使います。役割として、AGENTS.mdはOpenCodeのエコシステムにおいてCLAUDE.mdに直接相当します。

次に、Planモードを使います。Tabキーで、主な2つのエージェントを切り替えられます。Buildはファイルやコマンドに完全にアクセスでき、Planは分析と計画を担当します。デフォルトでは、Planモードでのファイル編集やbashコマンドの実行には承認が必要です。新しいタスクでは、まず計画から始めるようドキュメントで推奨されています。エージェントの実行予定を読み、表現を調整してから、TabキーでBuildに戻します。

ドキュメントでは、次のように助言しています。

タスクが具体的で、提供するコンテキストが充実しているほど、やり直しが減ります。リクエストにファイルを追加するには@を使います。名前を入力し始めると、インターフェースがあいまい検索でファイルを見つけます。画像はターミナルに直接ドラッグできます。また、!で始まるメッセージはシェルコマンドとして実行され、その出力がエージェントのコンテキストに追加されます。タスクを間違えた場合やエージェントが誤った操作をした場合は、/undoで変更を元に戻せます。連続して複数回使うこともできます。もう一度考えが変わった場合は、/redoで元に戻した変更を復元できます。/shareを使うとチーム用の会話リンクが作成されます。このコマンドを使わない限り、会話はどこにも公開されません。

OpenCodeでほかに何ができる？#

カスタムコマンド。繰り返し使うリクエストは、どれでもコマンドにできます。.opencode/commands/にMarkdownファイルを置き、frontmatterにdescription、agent、modelを設定して、その下にプロンプトのテンプレートを書きます。その後、/を使ってコマンドを呼び出します。公開前のプロジェクトチェック、最近のエラーの確認、マイグレーションの生成など、定期的に依頼する作業を設定できます。

サブエージェント。BuildとPlanのほかに、あと3種類あります。複数段階のタスクを担当するGeneral（タスクリスト以外のすべてのツールを利用可能）、編集の許可なしにコードを素早く読むExplore、外部ライブラリを調査するScoutです。メッセージ内で@を付けて名前を指定すると呼び出せます。

MCPサーバー。opencode.json設定のmcpセクションから外部ツールを接続できます。ローカルサーバーとリモートサーバーの両方に対応しています。各MCPサーバーはツールをコンテキストに追加します。GitHubのように多くの情報を取得するサーバーはコンテキストを非常に速く使い切ることがあるため、必要なものだけを選んで接続してください。MCPの仕組みについては、すぐに使える設定ガイドがあります。Claude Codeを題材にしていますが、プロトコルは共通です。

Web版とサーバー。opencode webでブラウザーにインターフェースを開きます。別のマシンからアクセスするには、opencode serve --hostname 0.0.0.0 --port 4096を使います。ネットワークからアクセスできる場合は、必ずOPENCODE_SERVER_PASSWORD変数でパスワードを設定してください。パスワードがないと、サーバーは保護されません。

インストールがうまくいかない場合は？#

インストール後に「opencode: command not found」と表示される。ターミナルが新しいパスをまだ認識していません。まず、ターミナルを閉じて開き直してください。解決しない場合は、インストーラーがバイナリを置いた場所を調べ、そのフォルダーをターミナルのPATHに追加します。

モデルが応答しない、または認証エラーが表示される。プロバイダーが接続されているか確認してください。/connectを入力して、再度認証します。キーは~/.local/share/opencode/auth.jsonに保存されています。別のマシンからインストール環境を移行したり、フォルダーを消去したりした場合、このファイルがない可能性があります。ドキュメントではProviderInitErrorとAI_APICallErrorを別々に扱っています。前者の場合はプロバイダーを再認証し、後者の場合は~/.cache/opencodeフォルダーを消去して再起動します。

インターフェースが崩れ、パネルが散らばったり、記号の代わりに読めない文字が表示されたりする。まずターミナルを確認してください。推奨されている選択肢のいずれかをインストールして起動します。WezTermは3つすべてのシステムで動作します。

解決しない場合はログを確認してください。macOSとLinuxでは~/.local/share/opencode/log/にあります。WindowsではWin+Rを押して、%USERPROFILE%\.local\share\opencode\logと入力します。直近10件のファイルが保存されます。opencode --log-level DEBUGフラグを使うと詳細なログ記録を有効にできます。ログを添えて、プロジェクトのGitHubリポジトリでバグを報告できます。

OpenCodeについてよくある質問#

Ailootを開く。