OpenCodeがインストールできない：よくあるエラーと直し方

目次

• 最初に：インストールのエラーか、接続のエラーか
• エラー1：error: opencode-ai's postinstall script was not run.
• エラー2：brew install opencode が動かない
• エラー3：command not found: opencode
• エラー4：Ubuntuに入れたのにパッケージが見つからない
• エラー5：v1からv2へ移行したい
• エラー6：インストーラーが権限を要求する、またはEACCESで失敗する
• エラー7：TUIは開くのにモデルが応答しない
• エラー8：動いていたのに午後の途中で止まった
• エラー9：2回インストールしたら挙動がおかしくなった
• 手早いチェックリスト
• さらに読む

最初に：インストールのエラーか、接続のエラーか

この切り分けが数時間を節約します。ほとんどの人がやりません。

TUIが開くなら、ターミナルにOpenCodeのインターフェースが見えるなら、インストールは成功しています。そこから先の問題はすべて設定です。APIキー、プロバイダー、クォータ。何も再インストールしないでください。

コマンドが存在しない、またはインストーラーが異常終了する場合だけが、本当のインストールの問題です。以下を読んでください。

エラー1：error: opencode-ai's postinstall script was not run.

最も検索されるエラーで、人が混同する2つの原因があります。

原因A：パッケージマネージャーがスクリプトをブロックした。 npmパッケージは、プラットフォーム用のネイティブバイナリをダウンロードするために、信頼済みのpostinstallスクリプトを使います。bunとpnpmは、明示的な許可がないとpostinstallスクリプトを実行しません。セキュリティ上の設計です。フラグを付けないままどちらかでインストールすると、パッケージは半分だけ入った状態になります。存在するのに、バイナリがない。

# bun
bun install -g --trust @opencode/cli

# pnpm
pnpm add -g --allow-build=@opencode/cli @opencode/cli

原因B：古いパッケージを使っている。 エラーの中の名前を見てください。opencode-ai。これが旧パッケージです。v2は@opencode/cliです。2025年のチュートリアルに従ったなら、間違ったほうを入れています。

npm uninstall -g opencode-ai
npm install -g @opencode/cli

持っていないと思っても、アンインストールを実行してください。2つのパッケージがPATH上の同じopencodeコマンドを登録すると、原因からは想像もつかない形のエラーが発生します。

エラー2：brew install opencode が動かない

動かないのは、存在しないからです。v2のドキュメントは明示しています。Homebrew、AUR、Scoop、Chocolateyは非対応だと。

brew install anomalyco/tap/opencodeを検索して何も見つからなかったとしても、tapが落ちているのではありません。公式チャネルではないのです。ミラーサイトから入手したバラの.exeも同じ扱いです。

実際に機能するチャネルはこれです。

経路	コマンド
npm	npm install -g @opencode/cli
bun	bun install -g --trust @opencode/cli
pnpm	pnpm add -g --allow-build=@opencode/cli @opencode/cli
yarn	yarn global add @opencode/cli
公式スクリプト	curl -fsSL https://opencode.ai/v2/install | bash
Docker	バージョンタグ付きの ghcr.io/anomalyco/opencode

OpenCodeにbrew installを勧めてくるチュートリアルは、2025年のものか非公式ソースです。現在のリストはOpenCodeのドキュメントにあります。

エラー3：command not found: opencode

ほとんどの場合、インストールのせいではありません。PATHのせいです。

1. 新しいターミナルを開く。 curlスクリプトで入れた場合、現在のセッションにはディレクトリが読み込まれていないことがあります。
2. ターミナルを閉じたくないなら、シェルを読み込み直します。source ~/.bashrc か source ~/.zshrc。
3. バイナリがどこに入ったかを確認します。npm bin -g がnpmのグローバルディレクトリを表示します。そのディレクトリが$PATHになければ、追加してください。

Windowsではこのエラーがさらに起きがちです。Nodeのインストール時に、npmのグローバルプレフィックスがシステムのPATHに入らないことがあるからです。これはNode側の問題で、OpenCodeのせいではありません。一度直せば、他のグローバルパッケージもすべて直ります。

エラー4：Ubuntuに入れたのにパッケージが見つからない

aptやsnapのパッケージは存在しません。LinuxではmacOSとまったく同じ方法で入れます。npm/bun/pnpm/yarn経由か、v2の公式スクリプトです。

Ubuntuでcurlスクリプトを使ってコマンドが出てこないなら、エラー3に戻ってください。PATHの問題です。スクリプトは専用のディレクトリにインストールするので、シェルがその場所を知っている必要があります。

エラー5：v1からv2へ移行したい

バージョンの跳ね上げでパッケージ名が変わり、それがアップグレードを壊します。旧パッケージにnpm update -gを実行してもv2には到達しません。レジストリ上で別パッケージだからです。

npm uninstall -g opencode-ai
npm install -g @opencode/cli
opencode --version

最後にバージョンを確認してください。まだ旧バージョンを報告するなら、別のPATHディレクトリに孤児になったバイナリがあります。which -a opencodeで見つけて、本来あるべきでないものを削除してください。

エラー6：インストーラーが権限を要求する、またはEACCESで失敗する

LinuxとmacOSでのグローバルnpmの古典的問題です。グローバルディレクトリの所有者がrootで、あなたのユーザーは書き込めません。

誘惑的な間違った解決策がsudo npm install -gです。動きますが、homeの中にroot所有のファイルを残し、あとで問題を起こします。正しい解決策は、npmのプレフィックスを自分のhome内のディレクトリに変更するか、nvm、fnm、voltaのようなNodeバージョンマネージャーを使うことです。すべてhomeの下に入るので、問題が根こそぎなくなります。

エラー7：TUIは開くのにモデルが応答しない

冒頭の警告を繰り返します。ここで無意味に再インストールする人が最も多いからです。これはインストールエラーではありません。

TUI内で/connectを実行してください。APIキーが正しいか、選択したプロバイダーが支払い先と一致しているかを確認します。Z.aiのCoding Planを使うなら、エンドポイントが重要です。Anthropic互換とOpenAI互換の2つがあり、間違えるとプランのクォータが一切減りません。詳細はZ.ai Coding Plan：Base URLとAPIキーの設定方法で扱っています。

エラー8：動いていたのに午後の途中で止まった

これもバグではありません。プランの利用上限です。

OpenCode Goは単一の月間クォータではなく、時間窓ごとに上限を適用します。午後に使い切ったなら、月間ではなく5時間窓の上限に当たったのです。正確な数字と内訳はOpenCode Go：料金、利用上限、2026年に契約する価値はあるかにあります。

エラー9：2回インストールしたら挙動がおかしくなった

症状：コマンドがインストールしたのと違うバージョンを報告する、設定の変更が効かない。

which -a opencode

このコマンドは、バイナリが存在するすべてのパスを列挙します。2つ以上返ってきたら、競合するインストールがあります。典型的にはnpm由来とcurlスクリプト由来の1つずつ、あるいは昔のbrewの試みの残骸です。要らないものを削除し、1つだけ残してください。

手早いチェックリスト

上を読みたくない人のための、診断の順序です。

1. TUIは開くか？ → 問題はインストールではなく/connect。
2. which -a opencode → 2つ以上出たら掃除する。
3. npm uninstall -g opencode-ai → 旧パッケージを削除。
4. npm install -g @opencode/cli → v2を入れる。
5. 新しいターミナル → PATHを疑う。
6. bunかpnpmなら → --trustか--allow-buildを付ける。
7. brewは絶対に使わない。

さらに読む

• 完全なチュートリアル：OpenCodeをインストールしてAIで開発する手順ガイド
• 問題がクォータなら：OpenCode Go：料金、利用上限、2026年に契約する価値はあるか
• 問題がエンドポイントなら：Z.ai Coding Plan：Base URLとAPIキーの設定方法