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

公開日: 2026年9月9日

読了時間: 1 min

テーマ: テクノロジー

著者: Leandro Valencia

#opencode#opencode go#CLI#AIエージェント#ターミナル#AIコーディング

OpenCode（CLI）の導入、プロバイダー接続、最初のエージェント実行までを解説。Goは任意で月10ドルから。Go Plusは月40ドル。価格の比較記事ではない。

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

OpenCode： CLIです。一度インストールします。フリーソフトウェアで、opencodeとして動きます。
OpenCode Go： 月10ドルのサブスクリプション（Go Plusは40ドル）で、オープンモデルと使用上限が付きます。接続できるひとつのプロバイダーです。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ドル（またはGo Plusの40ドル）とオープンモデルが欲しい場合。opencode.ai/goでアカウントを作り、支払いを済ませ、/connectからGoを接続します。上限の詳細は価格の記事にあります。ここで大事なのは、セッションが認証されることだけです。
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を渡す必要がありました。
それ以外のインストールエラー： 実行されないpostinstall、存在しないbrew install、WindowsのPATHなど、それぞれの解決方法はOpenCodeのよくあるインストールエラーと解決方法にまとめています。
TUIは開くがモデルが応答しない： インストールではなく/connectの問題です。キーとプロバイダーを確認します。
Goが昼過ぎに尽きる： CLIのバグではなく使用上限です。それは上限の記事で説明しています。

よくある質問

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

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

OpenCode Goはいくらですか？

最初の請求から月10ドルです。Go Plusは月40ドルです。上限の詳細は価格の記事にあります。紹介クレジットはありません。

まとめ

CLIはブログのbrewではなく、公式v2の経路でインストールする。
/connectはみんなが読み飛ばすステップです。
opencodeはリポジトリの中で起動する。
Goは任意です。月10ドル、Go Plusなら40ドル。
価格と上限は、もう2つの記事にあります。

プランが必要なら OpenCode Go にあります。

AIコーディングのツールキットを整えていて、ライセンスやサブスクリプションを払う予定なら、Enebaでは私のリンクで5%割引になります。アフィリエイトリンクなので、あなたは安く買い、私はブログを続ける助けを得られます。チーム用なら、Enebaで安くソフトウェアライセンスを買う方法をこちらで解説しています。5%割引は、リンク経由でアクセスしたうえで、決済時にコード CreaCosas を入力すると適用されます。

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

— Leandro Valencia

Step-by-step guide

OpenCodeをインストール
npm、bun、pnpm、yarnまたは公式のv2スクリプト。HomebrewとScoopは非対応です。
動作を確認する
新しいターミナルを開いてopencodeを実行。TUIが開けばOK、PATHエラーはNGです。
プロバイダーを接続
TUIで/connect。Goは任意。月10ドル、枠が要るならGo Plusは月40ドル。
実際のリポジトリに入る
プロジェクトにcdしてopencodeを再実行。エージェントはそのファイルを扱います。
最初のタスクを依頼する
検証可能で短いタスクを頼みます。正しいファイルを編集すれば準備完了です。

Frequently asked questions

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

いいえ。OpenCodeはCLI/TUI（インストールするプログラム）です。OpenCode Goは月額約10ドルのプランで、そのCLIの*中で*使えるオープンモデルへのアクセスを提供します。Goを支払わずにOpenCodeをインストールし、Anthropic、OpenAIなどのプロバイダーを接続することもできます。