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

> macOS、Linux、Windowsへのインストール、OpenCode 1.xと2.0、プロバイダーとOllamaの接続、設定、費用、トラブルシューティング。

Source: https://ailoot.ai/blog/ja/opencode-installation-models/
Canonical: https://ailoot.ai/blog/ja/opencode-installation-models/
Language: ja
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-190
Revision: sha256-79d371f665ad5733f8755aa7a3b33f27d817bc155d06366e79171224c67bd811


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

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



[Ailootの活用方法はドキュメントをご覧ください](https://ailoot.ai/docs/)。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

OpenCodeは、Anomalyチームが開発するオープンソースのAIコーディングエージェント（MITライセンス）です。ターミナルで動作するほか、デスクトップアプリケーション、エディター拡張機能、Web版も利用できます。プロジェクトで行う作業を伝えると、エージェントが自分でファイルを読み、コードを編集し、コマンドを実行します。ツール自体は無料です。クラウドモデルでもローカルモデルでも、使うモデルは自分で接続します。

</div>

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

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

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

<strong>2026年10月4日更新：</strong>チームは、ツールの次期メジャー世代である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とどう違う？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

Claude CodeはAnthropicのモデルだけに対応します。CodexはChatGPTエコシステムに結び付いたOpenAIのエージェントです。OpenCodeはプロバイダーに縛られないオープンなツールです。無料で、ChatGPT PlusやGitHub Copilotのサブスクリプションのほか、ローカルモデルを含む75以上のプロバイダーからモデルを選べます。

</div>

| 特徴 | OpenCode | Claude Code | Codex |
|----|----|----|----|
| コード | オープン、MIT | 非公開 | オープン |
| モデル | 75以上のプロバイダーとローカルモデル | Claudeのみ | OpenAIモデル |
| ツールの料金 | 無料 | サブスクリプションまたはトークン | ChatGPTのサブスクリプションまたはトークン |
| サブスクリプションでの利用 | ChatGPT Plus、GitHub Copilot、GitLab Duo | Claude Pro/Max（自分のサブスクリプション） | ChatGPT（自分のサブスクリプション） |
| 実行場所 | ターミナル、デスクトップ、エディター、ブラウザー | ターミナル、エディター | ターミナル、Web、エディター |
| プロジェクト設定 | AGENTS.md | CLAUDE.md | AGENTS.md |

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

まだツールを選んでいる段階なら、まず[2026年に何を使ってコーディングするか](https://ailoot.ai/blog/ja/ai-coding-tools/)の概要をご覧ください。OpenCodeをすでにインストール済みで、ACP経由でDevin Desktopの他のエージェントと連携したい場合は、[設定ガイド](https://ailoot.ai/blog/ja/codex-claude-agent-opencode-devin-desktop-acp/)をご覧ください。

## OpenCode 2.0で何が変わった？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

2026年10月4日時点で、独自のインストーラーと新しいnpmパッケージ`@opencode/cli`を備えたOpenCode 2.0がopencode.aiで公開されています。この記事でインストールする初代バージョンはなくなったわけではありません。ドキュメントでは独立した`V1`ブランチとして扱われ、積極的にサポートされており、引き続きデフォルトの選択肢です。v2では、開発者が初代バージョンとの互換性を意図的に維持しなかった領域が3つあります。プラグインAPI、サーバープロトコル、ターミナル設定ファイルです。

</div>

第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のレビュー](https://ailoot.ai/blog/ja/zcode-claude-code-alternative/)をご覧ください。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

必要なものは2つです。最新のターミナルエミュレーター（ドキュメントではWezTerm、Alacritty、Ghostty、Kittyを挙げています）と、モデルへのアクセス手段（プロバイダーのAPIキー、対応するサブスクリプション、またはOllama経由のローカルモデル）です。モデルはインストール後に必要になります。初回起動時に接続します。

</div>

インストールが予定どおり進まない可能性がある場所はターミナルだけなので、少し詳しく説明します。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をインストールする方法

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

ターミナルでコマンドを1つ実行します。curl -fsSL <https://opencode.ai/install> \| bash。ドキュメントでは最も簡単な方法として紹介されています。別の方法は、brew install anomalyco/tap/opencode、npm install -g opencode-ai、Arch Linuxではpacmanまたはparuです。

</div>

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

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

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

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

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

    ```bash
    opencode --version
    ```

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

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

```bash
brew install anomalyco/tap/opencode
```

```bash
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`でバージョンを確認してください。アンインストール機能も組み込まれています。

```bash
opencode uninstall
```

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

パフォーマンスと完全な互換性のため、ドキュメントではWSLを推奨しています。Windows Subsystem for Linuxをインストールし、その中で通常のLinuxコマンドを使ってOpenCodeをインストールします。WSLを使わない場合は、Chocolatey（`choco install opencode`）、Scoop（`scoop install opencode`）、npm、またはデスクトップアプリケーションを利用できます。

</div>

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

```powershell
wsl --install
```

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

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

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

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

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

```powershell
choco install opencode
```

```powershell
scoop install opencode
```

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

ターミナルインターフェースで`/connect`と入力し、一覧からプロバイダーを選びます。自分のキーなしで始められるOpenCode Zen、APIキーを使うAnthropicまたはOpenAI、サブスクリプションを使うChatGPT PlusまたはGitHub Copilot、ローカルモデルのOllamaから選べます。キーはauth.jsonファイルに保存されます。`/models`でモデルを指定します。

</div>

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

| 選択肢 | 内容 | 料金 |
|----|----|----|
| OpenCode Zen | OpenCodeチームが審査したモデルアグリゲーター | リクエストごとに支払い、残高をチャージ |
| OpenCode Go | チームが提供するオープンモデルのサブスクリプションプラン | Goは月額\$10、より高い上限のGo Plusは月額\$40 |
| APIキー | Anthropic、OpenAI、Google、DeepSeekなど | プロバイダーに利用料金を支払う |
| サブスクリプション | ChatGPT Plus、GitHub Copilot、GitLab Duo | 支払い済みのものを利用 |
| Ollama / LM Studio | 自分のハードウェア上のローカルモデル | API料金なし。ただし十分な性能のコンピューターが必要 |

ドキュメントでは、初心者は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`設定ファイルでデフォルトモデルを指定します。

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

ollama.comからOllamaをインストールし、`ollama pull`コマンドでモデルをダウンロードします。OllamaはOpenCode用の設定を自動で行えます。手動で設定する場合は、`opencode.json`にローカルサーバーのアドレス<http://localhost:11434/v1>を指定してプロバイダーを追加します。`/models`でモデルを選択します。エージェントがツールを呼び出さない場合は、Ollamaの`num_ctx`を16k～32kに増やします。

</div>

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

```bash
ollama pull qwen3-coder
```

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

```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キー取得ガイド](https://ailoot.ai/blog/ja/qwen-code-api-key/)で説明しています。

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

OpenCode自体は無料です。ソースコードはMITライセンスで公開されています。支払うのはモデルの利用料だけです。APIキーまたはZenによる従量課金、Goのサブスクリプション、すでに利用中のChatGPT PlusまたはCopilotのサブスクリプション、あるいは無料の選択肢として、Ollama経由でローカルモデルにリクエストする方法があります。

</div>

ここで説明する費用はすべてモデルにかかるもので、利用方法は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経由のローカルモデルへのリクエストは無料ですが、十分な速度で動かすには高性能なコンピューターが必要です。



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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

プロジェクトのフォルダーに移動して`opencode`を実行し、`/init`コマンドを使います。エージェントがプロジェクトを調べ、その概要を記したAGENTS.mdファイルを作成します。編集前にTabキーを押してPlanモードに切り替えると、解決策が提案され、変更内容を確認して承認できます。誤った操作は`/undo`で元に戻します。

</div>

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

```bash
cd path/to/project
opencode
```

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

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

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

<figure>
<blockquote>
<p>チームの若手開発者に話すように接すると、うまくいきます。</p>
</blockquote>
<figcaption>— OpenCodeの公式ドキュメント、https://opencode.ai/docs/</figcaption>
</figure>

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

`.opencode/commands`フォルダー内のMarkdownファイルから作るカスタムコマンド、並行タスクやコードの読み取りに使うサブエージェント、外部ツール用のMCPサーバー、ブラウザーで動くWeb版、リモート作業用のサーバーモードがあります。

</div>

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

問題のほとんどは3つに分かれます。`opencode`コマンドが見つからない（新しいターミナルセッションを始めるか、PATHを編集する）、モデルが応答しない（`/connect`と`auth.json`ファイルでキーを確認する）、インターフェースが正しく表示されない（WezTermのような最新のターミナルを使う）です。まず`~/.local/share/opencode/log/`のログを確認してください。

</div>

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

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

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

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

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

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="このセクションの重要なポイント">

重要なポイント

よくある質問への簡単な回答です。ツールとしてのOpenCodeは無料で、支払うのはモデルの利用料だけです。Claude Pro/Maxは`/connect`から接続でき、第三者プラグインの利用は禁止されています。Web版を使えば、スマートフォンからアクセスできます。OpenCodeは`opencode upgrade`コマンドで更新します。

</div>

<div class="section">

### よくある質問

OpenCodeは無料ですか？

はい。ソースコードはMITライセンスで公開されています。モデルには料金がかかることがあります。選択肢については、上記の費用のセクションで説明しています。

Claude Pro/Maxのサブスクリプションを接続できますか？

はい。Anthropicは`/connect`に公式のClaude Pro/Max接続方法を用意しており、ブラウザーで認証できます。プラグイン経由でClaudeのサブスクリプションを使うという古い記事は、現在の情報ではありません。Anthropicはこのようなプラグインを禁じており、バージョン1.3.0からOpenCodeで削除されています。

OpenCodeはスマートフォンで使えますか？

利用できる方法はWeb版です。コンピューターまたはサーバーで`opencode serve`を実行し、スマートフォンのブラウザーから接続します。ネットワークからアクセスする場合は、`OPENCODE_SERVER_PASSWORD`でパスワードを設定する必要があります。

OpenCodeはClaude Codeより優れていますか？

利用するモデルとサブスクリプションによります。Claude CodeはAnthropicのモデルと連携し、OpenCodeは75以上のプロバイダー、オープンソースのコード、ローカルモデルに対応しています。詳しい比較は上の表をご覧ください。

OpenCode 2.0をすぐにインストールすべきですか？

必ずしもそうではありません。ドキュメントでは、標準で現行の初代バージョンを推奨しています。このガイドのコマンドcurl -fsSL https://opencode.ai/install \| bashでインストールするバージョンです。第2バージョンは2026年10月4日から利用できますが、プラグインとサーバーAPIとの連携の仕組みが異なり、コードの一部を書き換える必要があります。

</div>

<div class="section" role="doc-bibliography" aria-label="出典">

### 出典

- [OpenCode、公式ドキュメント](https://opencode.ai/docs/)
- [モデルプロバイダー](https://opencode.ai/docs/providers/)
- [モデルの選択と設定](https://opencode.ai/docs/models/)
- [OpenCode Zen](https://opencode.ai/docs/zen/)
- [エージェントとサブエージェント](https://opencode.ai/docs/agents/)
- [AGENTS.mdルールファイル](https://opencode.ai/docs/rules/)
- [カスタムコマンド](https://opencode.ai/docs/commands/)
- [MCPサーバー](https://opencode.ai/docs/mcp-servers/)
- [WSL経由でWindows上にOpenCodeをインストール](https://opencode.ai/docs/windows-wsl)
- [ターミナルインターフェース](https://opencode.ai/docs/tui/)
- [Web版](https://opencode.ai/docs/web/)
- [トラブルシューティング](https://opencode.ai/docs/troubleshooting/)
- [コマンドライン](https://opencode.ai/docs/cli/)
- [OpenCodeのGitHubリポジトリ](https://github.com/anomalyco/opencode)
- [OpenCode 2.0：バージョン1からの移行](https://opencode.ai/v2/docs/migrate-v1/)
- [OpenCode Go：プランと上限](https://opencode.ai/go)

</div>





[Ailootを開く](https://ailoot.ai/)。

## OpenCode：インストール、モデル、初回起動：よくある質問

### OpenCodeを導入してもモデルが動かないのはなぜですか？

ツールの導入とモデルへのアクセスは別です。/connectでプロバイダーや対応契約を接続するか、ローカルモデルを設定し、/modelsで選んでから、範囲を限定したプロジェクトのタスクを1つ試してください。

### OpenCode 1.xから2.0へ移る前に何を確認しますか？

プラグイン、サーバーAPI連携、ターミナル設定の互換性を確認します。ガイドはこれらを移行時の確認点としています。バイナリを置き換える前に、導入済みバージョンを調べ、設定とセッションを保全してください。


## Ailoot · 企業とそのプロジェクト群

Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。

企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。

Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。
