OpenCodeをインストールしてAIで開発する手順ガイド

目次

• 混ぜてはいけない2つの名前
• ステップバイステップ

  • 1. OpenCode CLIをインストール
  • 2. 動作を確認する
  • 3. プロバイダーを接続
  • 4. 実際のリポジトリに入る
  • 5. 最初のタスクを依頼する
• 何かが失敗したとき
• よくある質問

  • OpenCodeとOpenCode Goは同じものですか？
  • HomebrewやScoopでインストールできますか？
  • 高性能なGPUが必要ですか？
  • 5ドルのクレジットはどうやって手に入れますか？
• まとめ

混ぜてはいけない2つの名前

• OpenCode： CLIです。一度インストールします。フリーソフトウェアで、opencodeとして動きます。
• OpenCode Go： サブスクリプション（初月約5ドル、その後10ドル）で、オープンモデルと使用上限が付きます。接続できるひとつのプロバイダーです。CLIのインストールに必須ではありません。

OpenCodeを今日インストールして、Anthropic、Z.aiなどのAPIを接続することもできます。APIキーを10個管理したくなければ、Goが近道です。

ステップバイステップ

1. OpenCode CLIをインストール

公式のv2ドキュメントにこれらの方法があります。ひとつ選んでください。

npm install -g @opencode/cli

bun install -g --trust @opencode/cli

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

yarn global add @opencode/cli

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

npmパッケージは、プラットフォームのネイティブバイナリをダウンロードするために信頼されたpostinstallスクリプトを使います。だからbunとpnpmは--trust / --allow-buildフラグを求めてくるのです。

同じドキュメントによれば、使ってはいけないものがあります。Homebrew、AUR、Scoop、Chocolatey、そしてミラーから落ちている単体の.exeです。brew install opencodeと書いた2025年のチュートリアルは、v2に対して古くなっています。

Dockerもあります（バージョンタグ付きのghcr.io/anomalyco/opencode）。フローがコンテナならこちらです。初日にはnpmかスクリプトで十分です。

2. 動作を確認する

ターミナルを閉じて開き直します（PATHは更新されないことがあります）。それから次を実行します。

opencode

TUIが開くはずです。command not foundではありません。curlのスクリプトがシェルが読み込まないディレクトリにインストールした場合は、新しいセッションを開くか、.bashrc / .zshrcをsourceします。

GPUは不要です。opencode tuiという魔法のサブコマンドも不要です。引数なしのバイナリがインターフェースを起動します。

3. プロバイダーを接続

TUIの中では、コマンドは次のとおりです。

/connect

ここでプロバイダーを選びます。まともな道は3つです。

• OpenCode Go： 10ドルのプランとオープンモデルが欲しい場合。5ドルのリンクでアカウントを作り、支払い情報を済ませ、/connectからGoを接続します。上限の詳細（5時間 / 週 / 月）は価格の記事にあります。ここで大事なのは、セッションが認証されることだけです。
• Z.ai / GLM： すでにCoding Planを持っているなら、コーディング用エンドポイントでカスタムプロバイダーとして接続します。汎用チャットのキーは混ぜないこと。
• Anthropic、OpenAIなど： /connectでキーを貼ります。OpenCodeには最初からいくつか入っています。

プロバイダーなしのTUIは空の抜け殻です。初日の典型的なエラーは「インストールできない」ではありません。opencodeを開いたのに何も接続していないことです。

4. 実際のリポジトリに入る

cd /path/to/your/project
opencode

エージェントが見るのはそのディレクトリのファイルです。$HOMEで起動すると、ディスク全体に意見を言い始めます。やめましょう。

プロジェクトにすでにAGENTS.mdやopencode.jsonがあれば、それらは尊重されます。なければ後で初期化できます。最初のプロンプトの妨げにはなりません。

5. 最初のタスクを依頼する

信仰心なしで検証できる何かを頼みます。

• 「src/auth.tsは何をしていますか？」
• 「この関数のテストを書いて。他のものには触らないで。」

正しいファイルを編集し、diffに意味があれば、インストールは完了です。そこまで行って初めて、MCP、プラグイン、テーマの話に価値が出てきます。customizeのドキュメントは2日目のためのものです。

何かが失敗したとき

• command not found： PATHです。ターミナルを開き直します。npmのグローバルでは、WindowsのPATHにnpmのプレフィックスが入っていないことがあります。
• npmのpostinstallが止まった： バイナリをダウンロードするスクリプトです。bun/pnpmでは--trust / --allow-buildを渡す必要がありました。
• TUIは開くがモデルが応答しない： インストールではなく/connectの問題です。キーとプロバイダーを確認します。
• Goが昼過ぎに尽きる： CLIのバグではなく使用上限です。それは上限の記事で説明しています。

よくある質問

OpenCodeとOpenCode Goは同じものですか？

いいえ。CLIとモデルのサブスクリプションです。GoなしでCLIを使えます。

HomebrewやScoopでインストールできますか？

v2のドキュメントではNoです。npm/bun/pnpm/yarnかopencode.ai/v2/installのスクリプトを使います。

高性能なGPUが必要ですか？

GoでもクラウドのAPIでも不要です。

5ドルのクレジットはどうやって手に入れますか？

Goのリンクからの登録で。使用上限に適用されます。

まとめ

• CLIはブログのbrewではなく、公式v2の経路でインストールする。
• /connectはみんなが読み飛ばすステップです。
• opencodeはリポジトリの中で起動する。
• Goはオプションで、紹介クレジットで安く試せます。
• 価格と上限は、もう2つの記事にあります。

👉 5ドルクレジットでOpenCode Goを試す

---

頭の中にはエージェントがあるのに、「このマシンで動かす」が残っているなら、必要なのは別の比較記事ではありません。公式ドキュメントがまだ認めているインストール方法です。

— Leandro Valencia