OpenCodeとは｜使い方・インストールとClaude Codeとの違い（GitHub20万スター超のOSS）

この記事ではOpenCode（anomalyco/opencode）を中心に解説します。Claude Code全般は Claude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き をご覧ください。

OpenCodeとは｜何ができて何を代替するか

OpenCodeは、コードの生成・説明・修正・調査をターミナルから頼めるAIコーディングエージェントです。Claude Codeのようなベンダー専用のCLIと違い、ソースが公開されていて、使うモデルを利用者が選びます。READMEの冒頭は「The open source AI coding agent」の一文で、LICENSE の実体もMITでした。

リポジトリは anomalyco/opencode です。旧名の sst/opencode を git ls-remote で引くと、同じコミット（2026年10月18日時点の e4b2afc）が返りました。「anomalyco」は製品名ではなく組織名です。GitHubのページ表示はスター約21.5万、フォーク約2.9万でした。READMEは名前に “opencode” を含む他のプロジェクトに「公式とは無関係」と明記するよう求めています。似た名前のツールは組織名で見分けます。

できることは次のとおりです。

・モデルの切り替え：provider/model の形で指定する。一覧は models.dev のカタログから作られる
・build／plan：Tabキーで切り替える。planは調べて計画するための読み取り用
・サブエージェント：メッセージに @general と書くと、複数手順の調べものを任せられる
・入口が3つ：全画面のTUI、スクリプトやCI向けの opencode run、デスクトップアプリ（ベータ）
・MCPとスキル：opencode mcp でMCPサーバーを管理し、スキルは .opencode/skills などから読む

OpenCodeのインストール方法｜v1とv2の違い

2026年10月18日時点で、npmには2つのパッケージがあります。READMEが案内するのは2系の @opencode/cli です。

保存先は当サイトの侵害記事で、ダミーのキーを入れて確かめた結果です。ほかは公式の移行ガイド（Migrate from V1）と各版の --help によります。

npmで入れて起動を確かめる手順です。2.0.32 で、掲載のまま動くことを確かめました。

npm i -g @opencode/cli@latest
opencode --version
opencode auth list
opencode models | head -5

キーを何も入れていない状態では、opencode --version が opencode v2.0.32、auth list が No authenticated integrations を返しました。opencode models には opencode/big-pickle など opencode/ で始まる12個が並びました。1系の1.19.3でも同じ12個でした。

npm以外の経路はREADMEにあります。公式スクリプト curl -fsSL https://opencode.ai/install | bash、Windowsの scoop install opencode と choco install opencode、Homebrewの brew install anomalyco/tap/opencode（常に最新）と brew install opencode（公式formula・更新は遅め）です。デスクトップ版は brew install --cask opencode-desktop か、リリースページの .dmg・.exe などから入れます。READMEはデスクトップ版を「BETA」と書いています。

1系と2系を同じ環境に入れない

公式の移行ガイドは「1系と2系はどちらも opencode コマンドを使い、既定では並べて入れられない」と書き、パッケージマネージャーで入れた1系を消してから2系を入れるよう求めています。

並べて動かすと何が起きるかも確かめました。空のホームで先に2系を動かし、同じホームで1系の opencode auth list を実行すると、Database is not empty and has no session table で止まりました。2系が作った opencode.db を1系が読めないためです。逆の順（1系 → 2系）では両方とも動きました。2系に移ったあとで1系の記事の手順を試すときは、別のユーザーか別の HOME で動かします。

初期設定｜モデルの接続・opencode.jsonc・AGENTS.md

公式の手順では、TUIで /connect を実行してプロバイダを選び、キーを入れてモデルを接続します。次に /models で使うモデルを選びます。GitHub Copilotはキーではなく、デバイス認証でログインします。ANTHROPIC_API_KEY などの環境変数に入れたキーも拾われ、1系の auth list では「Environment」欄に出ました。

ローカルで完結させたいときはOllamaです。公式ドキュメントによると、OpenCodeは http://127.0.0.1:11434 を探し、見つかったモデルを接続の手続きなしで /models に足します。LM StudioとvLLMにも同じ自動検出があります。

設定はプロジェクトの opencode.jsonc に書きます。JSONCなのでコメントが書けます。

{
  "$schema": "https://opencode.ai/config.json",
  // 既定のモデル（provider/model）
  "model": "anthropic/claude-sonnet-4-5",
  // git push の前だけは確認を求める
  "permissions": [
    { "action": "shell", "resource": "git push *", "effect": "ask" }
  ]
}

このファイルを置いたディレクトリで opencode debug config を実行すると、読み込まれた設定の場所と中身が出ます（コマンドは次の節に載せました）。全体の設定は ~/.config/opencode/opencode.json(c) に置きます。公式ドキュメントによると、プロジェクトの設定は遠いディレクトリから近いディレクトリの順に重ね、.opencode/ の中の設定が直下のファイルより優先されます。

プロジェクトの決まりごと（ビルドの手順・規約）は AGENTS.md に書きます。Claude Codeから移る人は注意が要ります。 公式ドキュメントは「V2は AGENTS.md だけを認識し、CLAUDE.md を代わりに読まない」と書いています。1系は AGENTS.md が無ければ CLAUDE.md を読んだので、1系のつもりで置いたままにすると決まりごとが効きません。スキルは別で、2系も .claude/skills を互換の置き場所として読みます。

OpenCodeの使い方｜build/planとopencode run

起動はプロジェクトのディレクトリで opencode です。全画面のTUIが開き、Tabキーでbuildとplanを切り替えます。基本は「planで調べて方針を決め、納得してからbuildで書き換える」二段構えです。

2系の opencode debug agents で、空の設定のときのエージェントと既定の権限を見ました。

READMEはplanについて「bashの実行前に確認を求める」と書いています。ところが v2.0.32 の debug agents の一覧には、planの shell に確認の規則がありませんでした。実際に確認なしで走るかは、モデルを動かしていないので未検証です。コマンドの実行を止めたいときは、上の permissions のように自分で規則を書くと確実です。

設定と状態を確かめるコマンドです。掲載のまま動くことを確かめました。

opencode debug paths db
opencode debug config
opencode debug agents | grep -E '"id"'
opencode service status
opencode service stop

2系はコマンドを打つと、ユーザーごとに1つの常駐サーバーを探すか起動し、各クライアントがそこにつなぎます（公式ドキュメント）。service status はそのURL（今回は http://127.0.0.1: の空いたポート）を返し、service stop で止まりました。常駐させたくなければ、コマンドに --standalone を付けるか opencode service set disabled true を実行します。

TUIを開かずに頼むときは opencode run "このリポジトリを説明して" です。--help で、-m（provider/model#variant の形）、--agent、--format json、--file があることを確かめました。CIのステップから呼ぶ使い方を公式は想定しています。モデルからの応答は試していません（未検証）。

OpenCodeは無料？料金と安全性

OpenCode本体は無料です。費用はモデルの接続先で決まります。

opencode/ のモデルは、OpenCodeの運営が出すモデルの窓口（OpenCode Console）の分です。公式ドキュメントは「有料モデルにはキーが要り、無料のチャットモデルはキー無しで呼べる」と書いています。名前に free が付くものには期間限定の扱いがあるので、使う前に opencode models で今の一覧を見てください。

安全性は2点に分けて考えます。

・手元のエージェント：planは編集を拒否し、.env の読み取りは確認が入る。shell の扱いは上の表のとおり自分で規則を書く
・キーの保存：1系は auth.json、2系は opencode.db に、キーが平文で入る。どちらも権限は600。1系から2系に上げても auth.json は消えない

OpenCode Consoleでは侵害が起きています。公式は2026年10月17日（米国時間）のX投稿で、外部プロバイダを連携していたConsole利用者の1.4%に影響すると公表しました。Consoleを使っていた人は、連携していたキーを各社の画面で無効にして作り直します。経緯と手元の確認手順は、記事末尾の「あわせて読みたい」にある侵害の記事にまとめました。

Claude Code・Crush・Aiderとの比較

主なツールを並べます。Crushのスター数は2026年7月時点の記載で、今回は測り直していません。

分かれ目は2つです。1つは、ターミナルとCIで使うか、エディタに組み込むか。もう1つは、モデルを選びたいか、1社のモデルとの統合の深さを取るかです。OpenCodeはターミナル側で、モデルを選びたい人に向きます。Claudeだけを使い、フックや CLAUDE.md の運用を作り込んでいるならClaude Codeのままが楽です。

OpenCodeが向かないのは、更新の速さに付き合えない場合です。2026年10月の時点でGitHubのIssueタブは約3.5千件を示し、1系から2系への移行ではプラグインとサーバーAPIが作り直しになりました。チームで使うなら版を固定し、上げる前に移行ガイドを読みます。

複数のエージェントを協調させたい場合は oh-my-claudecode - Claude Codeで複数エージェントを協調させる統合フレームワーク も候補です。エージェントの基盤ごとの比較は AIエージェントフレームワーク比較2026、Claude Codeの運用は Claude Code ベストプラクティス を参照してください。

参照ソース

• anomalyco/opencode GitHub リポジトリ
• OpenCode v2 docs（Intro・Config・Providers・Agents）
• OpenCode v2 docs: Migrate from V1
• OpenCode v2 docs: Instructions（AGENTS.md）
• OpenCode v1 docs: Rules（CLAUDE.md の扱い）
• npm: @opencode/cli
• npm: opencode-ai
• OpenCode 公式 X の投稿（2026-10-17 米国時間）
• charmbracelet/crush GitHub リポジトリ
• Aider