OpenCode 入門 - モデル非依存のオープンソース AI コーディングエージェント

AI コーディングエージェントというと Claude Code や OpenAI Codex CLI が思い浮かびますが、いずれも特定ベンダーのモデルが軸です。これに対して「どのモデルでも使える」を看板に急速に伸びているのが、オープンソースの OpenCode です。

2026年6月時点で GitHub スターは約17万と、OSS の AI コーディングエージェントとして突出した規模。この記事では、OpenCode とは何か・インストール・設定・エージェントと権限・他ツールとの違いを、公式ドキュメント（opencode.ai）を一次ソースに整理します。

OpenCode とは

公式の定義はシンプルに「The open source AI coding agent（オープンソースの AI コーディングエージェント）」。要点は次のとおりです。

• 開発元: Anomaly（terminal.shop などで知られるチーム。旧称・通称 SST）
• ライセンス: MIT（完全な OSS）
• 実装: TypeScript
• 動作形態: ターミナル（TUI）が中心。ほかにデスクトップアプリ（beta）、IDE 拡張があり、ローカルでサーバを立ててリモートから操作する構成も可能

最大の特徴は次の「モデル非依存」です。

特徴: モデル非依存（プロバイダ・アグノスティック）

OpenCode は models.dev と連携し、75以上の LLM プロバイダに対応します。Anthropic・OpenAI・Google Vertex AI・Amazon Bedrock・Azure OpenAI・Groq・DeepSeek・OpenRouter などのクラウドから、Ollama / LM Studio などのローカルモデルまで、同じツールのまま切り替えられます。

GitHub Copilot ログインや ChatGPT（OpenAI ログイン）経由での利用にも対応します。「特定ベンダーに縛られたくない」「手元のローカルモデルで動かしたい」という要求に応えるのが、Claude Code などとの一番の違いです。

モデルは設定で provider/model 形式の文字列として指定します。

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

インストール

導入方法は豊富です。代表的なものを挙げます（npm パッケージ名は opencode-ai）。

# 汎用インストーラ
curl -fsSL https://opencode.ai/install | bash
 
# npm / bun / pnpm
npm install -g opencode-ai
 
# Homebrew（macOS / Linux）
brew install anomalyco/tap/opencode
 
# Windows（scoop / choco）
scoop install opencode

起動と初期設定は TUI 上で完結します。

cd your-project
opencode      # TUI を起動
/init         # プロジェクトを初期化（AGENTS.md などを生成）
/connect      # 認証（API キーの接続）
/models       # 使用モデルを選択

設定ファイルは opencode.json（または opencode.jsonc）。グローバル（~/.config/opencode/）とプロジェクトルートの両方に置け、複数あればマージされます。先頭に "$schema" を書いておくとエディタで補完が効きます。

エージェントと権限

OpenCode は単発の補完ではなく、エージェントとして動きます。役割の違う複数のエージェントが用意されています。

エージェントは JSON または Markdown でカスタム定義できます。

---
description: Reviews code for quality and best practices
mode: subagent
permission:
  edit: deny
---
You are in code review mode. Focus on code quality...

権限（permission）

ツールごとに allow / ask / deny を設定でき、ワイルドカードや last-match-wins のルールが効きます。.env はデフォルトで読み取り拒否、プロジェクト外操作（external_directory）や同一ツールの反復（doom_loop）はデフォルトで確認、と安全側の初期値です。

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "bash": {
      "*": "ask",
      "git *": "allow",
      "rm *": "deny"
    },
    "edit": { "*": "deny", "docs/*.mdx": "allow" }
  }
}

MCP 連携

MCP（Model Context Protocol）にも対応し、ローカル（コマンド起動）とリモート（HTTP）の両方のサーバを登録できます。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "my-local": {
      "type": "local",
      "command": ["npx", "-y", "my-mcp-command"],
      "enabled": true
    },
    "my-remote": {
      "type": "remote",
      "url": "https://my-mcp-server.com",
      "enabled": true,
      "headers": { "Authorization": "Bearer MY_API_KEY" }
    }
  }
}

直近の動向（2026年）

• バージョンは速いペースで更新中（2026年6月時点で v1.17 系）
• 開発元が Anomaly ブランドへ統一（GitHub org が anomalyco に。Actions を使っている場合は参照先の更新が必要）
• 商用サービスとして、検証済みのオープンソース系コーディングモデルへ定額アクセスできる OpenCode Go（公式表記「$5 first month, then $10/month」）や、モデルをキュレーションする OpenCode Zen を展開（BYOK で自前 API キーを使う無料利用も可能）

Claude Code / Codex CLI との違い

ざっくり言えば、「モデルを選びたい・縛られたくない・ローカルで動かしたい」なら OpenCode、特定ベンダーのモデルと体験に最適化したいなら Claude Code / Codex CLI、という住み分けです。Codex を Claude Code から呼ぶ Codex Plugin のように、複数を併用するのも現実的です。

注意点

• デスクトップアプリは beta。安定運用は TUI が無難
• BYOK のコストは利用モデル次第。モデル非依存ゆえ、各プロバイダの API 課金は別途発生する
• 設定はマージされる。グローバルとプロジェクトの opencode.json が合算される挙動を理解しておく
• バージョンの進みが速い。細かい仕様は公式ドキュメントで都度確認を
• 前述の同名プロジェクト（アーカイブ済み Go 版）との混同に注意

まとめ

• OpenCode は Anomaly（旧 SST）製の MIT ライセンスのオープンソース AI コーディングエージェント。TUI 中心でデスクトップ/IDE でも動く
• 最大の特徴は モデル非依存。models.dev 連携で 75+ プロバイダ＋ローカルモデルを切り替えられる
• 導入は curl / npm install -g opencode-ai / brew などから。設定は opencode.json、モデルは provider/model 形式
• Build/Plan/Explore などのエージェントと、allow/ask/deny の権限、MCP 連携を備える
• Claude Code / Codex CLI との違いは「ベンダー非依存 vs ベンダー最適化」。用途で使い分け・併用する

「AI コーディングエージェントを、自分が選んだモデルで・OSS で回したい」——その要求にまっすぐ応えるのが OpenCode です。まずは opencode を起動し、/models で手元の好きなモデルにつないでみてください。

参考リンク

• OpenCode 公式サイト
• OpenCode Docs
• anomalyco/opencode（GitHub）
• OpenAI Codex CLI 実践入門（当ブログ）
• Codex Plugin for Claude Code（当ブログ）