MCP on Yanmu

Context7 ガイド：AIコーディングアシスタントに最新ドキュメントを理解させる

Sat, 02 May 2026 19:51:00 +0800

概要

こんな経験はありませんか？AI にコードを書かせたら、たくさん出力したのに実行するとエラーになる。または、ドキュメントに明らかに存在する API なのに、AI が「存在しません」と言う。

AI がバカなのではありません。学習データには賞味期限があるのです。数ヶ月前や一年前のデータで学習している間に、フレームワークは何度もアップデートされています。

Context7 はこの問題を解決します。Upstash チームが開発したもので、質問時に最新の公式ドキュメントを取得し、AI のコンテキストに注入して、現在のバージョンに基づいて回答させます。

使い方は簡単で、プロンプトの末尾に use context7 を追加するだけです。AI に「推測するな、まず最新ドキュメントを確認してから答えて」と伝えるようなものです。

なぜ必要か？

💥 具体例

個人サイトに「トップに戻る」ボタンを追加したいとします。ページをスクロールすると右下にボタンが表示され、クリックすると一番上に戻る、というものです。

AI が古い知識で書いたコード： 数十 KB のサードパーティライブラリを読み込み、それを呼び出すためのコードを大量に書く。機能は実現できますが、たった一つのボタンのためにページが遅くなり、コードが冗長になります。

実際には今はもっと簡単です： モダンブラウザにはスムーズスクロールとスクロール検出が組み込まれています。数行のコードで済み、追加ライブラリは不要です。

AI はこれを知りません。なぜなら数年前の教材で学習したからです。

use context7 を追加すると、Context7 が最新ドキュメントを確認し、ネイティブ機能で十分だと判断します。AI は古いやり方ではなく、より軽量な方法を選びます。

これは、友達にスマホの修理を頼んだとき、3年前の手順を記憶だけで分解しようとするようなものです。ネジの位置は変わっています。最新のチュートリアルを先に見ておけば、壊さずに済みます。

Context7 の有無の違い

	なし	あり
情報源	AI の古い知識（時代遅れの可能性）	公式ドキュメントからリアルタイム取得
API の正確性	よく間違える、または既に存在しない API を使う	現在のバージョンの API を保証
コード品質	数年前の古い書き方の可能性	最新の推奨される書き方
バージョン対応	バージョンを無視して推測	指定したバージョンを検索

🔄 仕組み

数ステップで完了します：

質問する（末尾に use context7 を追加）
    ↓
Context7 が質問対象のコードパッケージを特定
    ↓
GitHub と公式ドキュメントサイトから最新情報を取得
    ↓
最も関連性の高い部分をフィルタリングして AI の「コンテキスト」に注入
    ↓
AI が最新ドキュメントをもとに回答

「コンテキスト」とは、AI が現在の会話で「見える」内容のことです。ドキュメントを注入するのは、テーブルに参考書を広げるようなもので、AI はそれを見ながら回答します。

ドキュメントの出所は？GitHub リポジトリ、公式ドキュメントサイト、そしてプロジェクトメンテナーが作成した llms.txt（AI 向けのドキュメントインデックスファイル）です。

結果を取得した後、Context7 は LLM を使ってインテリジェントに並べ替え、最も関連性の高い部分だけを選び出します。

2つの使い方：

方法	説明
MCP モード（推奨）	一度インストールすれば、AI コーディングアシスタントが自動的に呼び出す。MCP は AI にプラグインを追加するようなもの
CLI 手動モード	ターミナルでコマンドを打って手動でドキュメントを検索

コア機能

スマートマッチング：名前を言えば、探しに行く

AI にあるツールの使い方を尋ねると、Context7 はそのツールの最新マニュアルをネット上で見つける必要があります。しかし、同じ名前のものが複数存在することもあります。

一般的な名前なら自動で認識できます。名前が曖昧で混乱しやすい場合は、誰/何 の形式で正確に指定します：

`1`	`/tailwindlabs/tailwindcss を使って私のウェブページにナビゲーションバーを追加してください。use context7`

tailwindlabs は作者名、tailwindcss はプロジェクト名です。「Apple」を検索するのと同じで、果物なのか携帯なのか——はっきり言えば間違えません。

対応ライブラリ

人気のあるものはすべて収録：React、Next.js、Vue、Tailwind CSS、Express、Prisma、Supabase、TypeScript……完全なリストは context7.com/rankings をご覧ください。

バージョン認識

バージョンによって API は大きく異なることがあります。バージョン番号を直接指定すれば、Context7 が対応するバージョンのドキュメントを検索します：

1
2
3

Vue 3 でカウンターを書いて。use context7
Next.js 14 の Pages Router で API ルートを書いて。use context7
Tailwind CSS v4 でダークモードを設定して。use context7

iPhone 12 の分解チュートリアルを頼めば、誰も iPhone 15 のものを渡しません。

インストール

ワンクリックインストール

`1`	`npx ctx7 setup`

npx は Node.js に付属しているコマンドで、追加インストールは不要です。Node.js をまだインストールしていない場合は、nodejs.org からダウンロードしてインストールしてください。

実行すると以下の処理が行われます：

ブラウザが開いてログイン認証（OAuth）
API Key の生成（あなたの「身分証明書」）
エディタの自動設定

3ステップで完了です。

エディタを指定する場合はパラメータを追加：

1
2
3

npx ctx7 setup --claude      # Claude Code
npx ctx7 setup --cursor      # Cursor
npx ctx7 setup --opencode    # OpenCode

アンインストール：npx ctx7 remove

手動設定

自動インストールが機能しない場合は、手動で MCP Server を追加します：

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "あなたのAPIキー"
      }
    }
  }
}

各ツールの設定ファイルの場所（~ はユーザーディレクトリ、Windows なら C:\Users\ユーザー名）：

ツール	設定場所
Cursor	Settings → MCP、または `~/.cursor/mcp.json`
Claude Code	`~/.claude/settings.json`（グローバル）または `.claude/settings.json`（プロジェクト）
Windsurf	Settings → Cascade → MCP servers
Cline	VS Code 拡張内 MCP Servers → Configure
OpenCode	プロジェクトルート `opencode.json`

API Key は context7.com/dashboard で取得。形式は ctx7sk... で、無料ユーザーにも割り当てがあります。

✅ 動作確認

テストメッセージを送信：

`1`	`ボタン付きのカウンターウェブページを書いて。use context7`

AI がクリーンでモダンなコードを出力し、余分なライブラリを読み込まなければ、正常に動作しています。

使用方法

基本の使い方

プロンプトの末尾に use context7 を追加：

1
2

シンプルな履歴書ウェブページを書いて。use context7
秒数を入力してカウントダウンするツールを書いて。use context7

ライブラリの正確な指定

/owner/repo 形式で名前のマッチングをスキップ：

`1`	`/tailwindlabs/tailwindcss を使って私のページにナビゲーションバーを追加して。use context7`

ライブラリ名に曖昧さがある場合に推奨。

バージョン指定

1
2

Bootstrap 5 ではなく Bootstrap 4 の書き方でカードレイアウトを書いて。use context7
Vue 3 の Composition API で TODO リストを書いて。use context7

複数ライブラリの組み合わせ

`1`	`Bootstrap + Font Awesome でアイコンギャラリーページを作って。use context7`

自動トリガーの設定

毎回 use context7 と手入力したくない場合は、ルールファイルに設定：

→ Cursor .cursorrules に記述：

`1`	`ユーザーの質問がサードパーティのフレームワークやライブラリの API 使用方法に関する場合、自動的に Context7 で最新ドキュメントを検索する。`

→ Claude Code CLAUDE.md に記述：

1
2
3

## ドキュメント検索ルール
- サードパーティのライブラリやフレームワークに関する場合、最初に Context7 で最新ドキュメントを検索する
- Context7 が返した内容に基づいてコードを生成することを優先する

CLI コマンド

AI との会話でしか Context7 を使わないなら、この部分はスキップしても構いません。CLI はターミナルでコマンドを打つのが好きな人向けです。

npm は Node.js に付属のパッケージマネージャー、-g は「グローバルインストール」を意味します。

# CLI のインストール
npm install -g ctx7

# ライブラリの検索
ctx7 library react
ctx7 library nextjs "middleware"

# ドキュメントの取得
ctx7 docs /facebook/react "hooks state management"
ctx7 docs /vercel/next.js "middleware authentication"

# Skills 管理
ctx7 skills search        # Skill を検索
ctx7 skills install       # Skill をインストール
ctx7 skills list          # インストール済みを表示
ctx7 skills remove        # アンインストール

# 認証
ctx7 login                # ログイン
ctx7 whoami               # 状態を確認
ctx7 logout               # ログアウト

❓ よくある質問

AI の内蔵ウェブ検索との違いは？

ウェブ検索ではブログやフォーラムの投稿がヒットしますが、品質はまちまちで、自分で信頼性を判断する必要があります。Context7 は公式ドキュメントのみから情報を取得し、LLM で最も関連性の高い断片をフィルタリングして、AI に直接渡します。

💰 `use context7` でコストが増えますか？

いいえ。ドキュメント検索のステップが増えますが、AI が正確な情報を得られるため、推測や修正の繰り返し、長くて間違ったコードを書くことがなくなります。総合的なトークン消費量はむしろ減ります。

使っているライブラリが未収録の場合は？

context7.com で “Add Docs” をクリックして申請するか、use context7 を付けずに AI を自分の知識だけで回答させます。

インストールしたのに効果がない？

以下を一つずつ確認：

npx ctx7 setup でエラーが出なかったか
MCP 設定ファイルの JSON 形式が正しいか（カンマ一つで失敗します）
API Key が有効か（ctx7sk... で始まります）
エディタを完全に閉じてから開き直したか
MCP リストのステータスが緑色か
質問時に use context7 を書いたか

応答速度に影響しますか？

1〜2秒の待ち時間が増えますが、正確な回答が得られるので修正のやりとりが減ります。エラーが起きてから修正する時間に比べれば、この1〜2秒ははるかに短いです。

まとめ

項目	内容
概要	AI コーディングアシスタントにリアルタイムの最新ドキュメントを提供するプラットフォーム
解決する問題	学習データの古さによる AI の誤ったコード出力
コア原理	公式ドキュメントをリアルタイムに取得し、AI コンテキストに注入
インストール	`npx ctx7 setup` の一行で完了
使用方法	プロンプト末尾に `use context7` を追加
価格	無料枠あり、個人利用に十分
公式サイト	context7.com
GitHub	github.com/upstash/context7

インストールすれば、AI が古い知識でごまかす心配はもうありません。

OpenCode 完全ガイド：オープンソース版 Claude Code のインストール、設定、高度な活用法

Thu, 30 Apr 2026 02:00:15 +0800

📋 目次

一、OpenCodeとは？

OpenCodeは現在最もホットなAIプログラミングツールで、本質的にはオープンソース版のClaude Codeです。Claude Codeのほぼすべてのコア機能を複製し、中国ユーザーによくある速度制限やアカウント停止の問題を解決しました。

Claude Codeとの比較

比較項目	Claude Code	OpenCode
オープンソース	❌ クローズドソース	✅ オープンソース
無料モデル	❌ 有料API必要	✅ 無料モデル内蔵
中国ユーザー向け	⚠️ 速度制限/停止リスク	✅ 制限なし
Skills/MCP	✅ サポート	✅ 完全互換
Session並列	❌	✅ コア機能

コアポジショニング

オープンソース版Claude Code：ほぼ全機能、中国ユーザー向け、速度制限・アカウント停止なし
無料モデル：GLM-4.7、MiniMax-2.1などの無料モデルがそのまますぐ使える
トップクラスモデル接続：AntigravityプラグインでGemini 3 Pro、Claude 4.5 Opusを無料利用；/connectでGPT Codexに接続
キラー機能：Session並列処理、Timelineロールバック、Share共有、Ultra Workマルチエージェント協調
プラグインエコシステム：Oh My Open Code (OMO) — 7つのプログラミングエージェント + 3つのMCP Server + 各種ツール

二、4つのインストール形態

⭐ 1. コマンドライン版（主力おすすめ）

最も安定し、機能が最も充実した使用方法。

# インストール（Node.jsを先にインストールする必要があります）
npm i -g opencode-ai

# 起動
opencode

前提条件：Node.jsのインストールが必要（nodejs.orgから対応OS版をダウンロード）

2. デスクトップクライアント（Beta）

公式サイトからクライアントをダウンロードし、インストール後、プロジェクトフォルダを選択して使用。

⚠️ 現在Betaテスト段階でバグ较多、主力ツールとしての使用は推奨されません。

3. VS Codeプラグイン版

前提条件：コマンドライン版OpenCodeがインストール済み。プラグイン版のコア価値はIDEとのシームレスな統合にあり、AIが直接コードのコンテキストを認識します。

VS Code拡張機能ストアでOpenCodeを検索してインストール
ショートカット Ctrl + Shift + P → open opencodeと入力してEnter
プラグインが左側ウィンドウで開いているコードファイルを自動的に関連付け
コードを選択後 Ctrl + Alt + K でOpenCodeチャットウィンドウに素早く貼り付け

4. クラウド実行環境（GitHub Actions）

オープンソースプロジェクトの自動化されたIssue修正に最適：

プロジェクトをGitHubの公開リポジトリにアップロード
リポジトリにAPI Keyを設定（Settings → Secrets and Variables → Actions）
Issueのコメントに/opencode + 要件説明を入力
GitHub Actionsが自動的にOpenCodeワークフローを実行
完了後、自動的にPull Requestを作成

三、無料モデルの設定

利用可能なモデルを確認

`1`	`/models # 利用可能なすべてのモデルを表示（freeマーク付きは無料で使用可能）`

モデル	特徴
GLM-4.7	プログラミング能力が高い、ゼロ設定
MiniMax-2.1	プログラミング能力が優秀、応答が速い

トップクラスモデルへの接続

方法1：Antigravityプラグイン（Gemini + Claudeを無料接続）

AntigravityはGoogleが提供するAIプログラミングIDEで、Gemini 3 ProとClaude 4.5 Opusを無料で提供しています。

OpenCodeにインストールプロンプトを貼り付け（Antigravity GitHubのトップページからコピー）
AIが自動的にインストールを完了するのを待つ
新しいターミナルを開いてログインコマンドを実行、Google → Antigravityログインを選択
Googleアカウントにログイン、生成されたURLを貼り付け
OpenCodeを再起動、/modelsでGemini 3 ProとClaude 4.5 Opusが表示される

方法2：GPT Codex（OpenAI公式提携）

OpenAIとOpenCodeが公式提携し、ChatGPT Codexに直接接続できます。

`1`	`/connect # OpenAI → GPT Pro → ブラウザログインを選択`

前提条件：ChatGPT Plus以上のサブスクリプションが必要。

方法3：OpenRouter（万能接続）

OpenRouterを通じて、市販されているほぼすべての大規模モデルに接続でき、国内ユーザーも簡単にクレジットを取得できます。

`1`	`/connect # OpenRouter → API Keyを入力を選択`

OpenCodeは75種類のAI接続方法をサポートしており、ほぼすべてのモデルベンダーを網羅しています。

四、コア機能のハイライト

1. 質問による要件明確化

コーディングを始める前に、OpenCodeは一系列の質問をします：

コードサンプルだけでいいですか、それとも完全に実行可能なプログラムが必要ですか？
どの機能が必須ですか？
どのモデルを使用しますか？
環境変数はどのように保存しますか？

この「先に聞いてから行動する」メカニズムにより、手戻りが大幅に減少します。

2. コマンドラインコードDiffインターフェース

OpenCodeのコマンドラインdiff表示は、すべてのコマンドラインプログラミングツールの中で最高とされており、コードの変更が一目瞭然です。

⭐ 3. Session並列処理

これはOpenCodeの最も特徴的な機能です — 複数Sessionの並列実行：

# 最初のタスクを開始（例：タイマー追加）
# タスク実行中に新しいセッションを作成
/new

# 2番目のタスクを開始（例：ブラシの色変更）
# すべてのセッションの状態を確認
/sessions

# セッション間を切り替え
/session <id>

回転シンボルはSessionがバックグラウンドで実行中であることを示します。2つの要件を完全に並列開発できます。

4. Timelineチェックポイントロールバック

`1`	`/timeline # 現在のセッションの完全な会話履歴を表示`

任意の履歴ノードを選択：

Revert：コードとチャットコンテンツをその時点にロールバック
View：当時AIが行った変更を確認

プログラミングの「タイムマシン」のように、大胆に異なるアプローチを試すことができます。

5. Share共有

1
2
3

/share      # 会話履歴をウェブページとして共有
/unshare    # 共有を停止
/export     # 会話履歴をファイルとしてエクスポート

共有後、完全な会話履歴とコード変更プロセスを表示するウェブリンクが生成され、コラボレーションやデモンストレーションに便利です。

五、Skillsスキル移行

OpenCodeはClaude CodeのSkillsディレクトリ構造と完全互換で、移行コストが極めて低いです：

1
2

# ディレクトリ構造の対応関係
.claude/skills/<skill-name>/    →    .opencode/skills/<skill-name>/

操作手順

プロジェクトのルートディレクトリに.opencodeフォルダを作成
.opencodeの下にskillsフォルダを作成
元の.claude/skills/配下のスキルフォルダをそのままコピー
OpenCodeを再起動すると、AIがこれらのSkillsを認識して呼び出す

各Skillはディレクトリ付きの説明書で、AIに特定分野のタスクを完了する方法を伝えます。

六、MCP設定

OpenCodeは2つのMCP（Model Context Protocol）モードをサポートしています：

ローカルMCP（Local）

ローカルコマンドで実行。~/.config/opencode/opencode.jsonで設定：

{
  "mcpServers": {
    "shed-cn": {
      "type": "local",
      "command": "npx",
      "args": ["shed-cn"],
      "enabled": true
    }
  }
}

リモートMCP（Remote）

URLでリモート呼び出し。Context7を例に：

{
  "mcpServers": {
    "context7": {
      "type": "remote",
      "url": "https://context7-mcp-server-url",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      },
      "enabled": true
    }
  }
}

設定完了後、OpenCodeを再起動し、/mcpと入力すると設定済みのMCP Serverを確認できます。

七、Oh My Open Code (OMO) スーパープラグイン ⭐

OMOはOpenCodeで最も人気のあるプログラミングプラグインで、本質的にはツール + MCP + プログラミングエージェントの組み合わせバンドルです。

7つのプログラミングエージェント

エージェント	役割	おすすめモデル
🧠 シーシュポス (Sisyphus)	メインエージェント、計画とオーケストレーション	Claude 4.5 Opus / GPT 5.2
🔮 予言者 (Prophet)	アーキテクチャ設計、コードレビュー	—
📚 司書 (Librarian)	文献調査、ドキュメント検索	—
🔍 探索者 (Explorer)	ウェブ検索	—
🎨 フロントエンドエンジニア	フロントエンド開発	Gemini 3 Pro
📝 ドキュメントライター	ドキュメント生成	—
🖼️ マルチモーダル	画像/PDF理解	—

各エージェントにはその作業に最適な大規模モデルが割り当てられています。作者によると、最適な組み合わせを見つけるために24,000ドル相当のTokenを費やしたとのことです。

3つのMCP Server

Web Search：ウェブ検索
Context7：最新の技術ドキュメントを取得
Grep App：GitHubリポジトリの高速コード検索

統合ツール

LSPアドバンスト版：プログラミング言語の構文とセマンティクスを通じてAIのコード特定を支援
ASTツール：コード構文木を通じた関連検索
LOCツール：マルチモーダル視覚能力で画像、PDFを理解
Delegate Task / Background Task：エージェントのタスク割り当てとバックグラウンドスケジューリング

インストールと使用

設定ファイルの場所：C:¥Users¥<ユーザー名>¥.config¥opencode¥oh-my-opencode.json

OMO GitHubのトップページからinstallで始まるプロンプトをコピー
OpenCodeに貼り付け、設定質問に回答（サブスクリプション状況など）
自動的にインストール完了

2つのコア使用法

① @ で特定エージェントを指定

`1`	`@フロントエンドエンジニアこのページのレスポンシブレイアウトを最適化して`

② Ultra Workモード（魔法の言葉ULW）

`1`	`ULW ペットショップアプリを作成して`

Ultra Workモードでは、シーシュポスがメインエージェントとして以下の処理を行います：

タスクをTodo Listに分解
複数のバックグラウンドタスクを同時並行実行
各エージェントを中央からオーケストレーション
完成したプロジェクトを納品

Ralph Loopモード

AIに長時間ループで作業を強制し、極めて困難なタスクに適しています：

`1`	`/ralph-loop`

例：「最新のSpring Boot 4標準を使用してプロジェクト全体をリファクタリングし、すべてのテストケースがパスするまで」——タスクが完了するまで数時間連続実行可能です。

八、その他の便利機能

`/init` — プロジェクト知識初期化

AIにプロジェクトフォルダ全体を読み込ませ、agents.mdファイルをシステムプロンプトとして生成し、AIがプロジェクトを素早く理解できるようにします。

`/compact` — コンテキスト圧縮

これまでの会話を簡潔な要約にまとめ、モデルのコンテキストウィンドウを解放し、Tokenのオーバーフローを防ぎます。

カスタムコマンド

~/.config/opencode/commands/の下に.mdファイルを作成してカスタムコマンドを定義：

# テスト実行
モード：build
コマンド：npm test
説明：プロジェクトのすべてのテストケースを実行

使用方法：/テスト実行でトリガー。

カスタムエージェント

~/.config/opencode/agents/の下に.mdファイルを作成：

# Code Review Agent
タイプ：subagent
モデル：claude-4.5-opus
説明：コードレビューを専門とし、コード品質、セキュリティ脆弱性、ベストプラクティスをチェックします。

Primary Agent：Tabキーで切り替え、会話で直接使用
Sub Agent：メインエージェントがバックグラウンドで自動スケジューリング

九、まとめとおすすめ

適用シーン

シンARIO	おすすめ度	説明
初心者のAIプログラミング入門	⭐⭐⭐⭐⭐	無料モデル、ゼロコストでスタート
日常開発補助	⭐⭐⭐⭐⭐	Session並列 + Timelineロールバック
複雑なプロジェクト開発	⭐⭐⭐⭐⭐	OMOプラグインマルチエージェント協調
オープンソースプロジェクト保守	⭐⭐⭐⭐	GitHub Actionsクラウド自動化
Skills/MCP練習	⭐⭐⭐⭐⭐	Claude Codeエコシステムと完全互換

十、実践記録：Oh My OpenAgentのインストール

以下は、Oh My OpenAgent（旧Oh My Open Code）のインストールを個人的にテストした完全な会話記録で、環境はWindows + PowerShellです。

環境チェック

1
2

opencode --version
# 出力: 1.14.39

インストールプロセス

OpenCodeの会話で直接AIに伝えます：

“Install and configure oh-my-openagent by following the instructions here: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/refs/heads/dev/docs/guide/installation.md"

AIがまずモデルのサブスクリプション状況を確認します：

サブスクリプション	私の状況
Claude Pro/Max	❌ なし
OpenAI / ChatGPT Plus	❌ なし
Gemini	❌ なし
GitHub Copilot	✅ 学生認証版
OpenCode Zen	✅ 無料利用可
Z.ai Coding Plan	❌ なし
OpenCode Go	❌ なし
Kimi for Coding	❌ なし
Vercel AI Gateway	❌ なし

⚠️ AIは「Without a Claude subscription, the Sisyphus agent might not work idealally」と表示しますが、GitHub Copilotがフォールバックモデルとして自動的に引き継ぎます。

サブスクリプション確認後、AIが自動的にインストールコマンドを実行：

bunx oh-my-openagent install --no-tui \
  --claude=no --openai=no --gemini=no \
  --copilot=yes --opencode-zen=yes \
  --zai-coding-plan=no --opencode-go=no \
  --kimi-for-coding=no --vercel-ai-gateway=no

インストール成功の出力：

[1/4] Checking OpenCode installation...
[OK] OpenCode 1.14.39 detected
[2/4] Adding oh-my-openagent plugin...
[OK] Plugin added -> C:¥Users¥<ユーザー名>¥.config¥opencode¥opencode.json

インストール後の設定ファイル

メイン設定ファイル ~/.config/opencode/opencode.json：

{
  "plugin": [
    "oh-my-openagent@latest"
  ]
}

エージェントモデル設定 ~/.config/opencode/oh-my-openagent.json：

AIがGitHub Copilotサブスクリプションに基づいて自動的にモデルを割り当て：

エージェント	割り当てモデル
Sisyphus（メインエージェント）	`github-copilot/claude-opus-4.7`
Oracle（予言者）	`github-copilot/gpt-5.5` (medium)
その他のエージェント	Copilot利用可能モデルから自動選択

認証設定

インストール完了後、手動でGitHub Copilotを認証する必要があります：

`1`	`opencode auth login`

インタラクティブ手順：

上下キーでGitHub Copilotを選択
Enterキーで確認
ブラウザが自動的に開き、GitHub学生アカウントにログイン
認証完了、ターミナルに認証成功と表示

エージェントモデルを再設定するには？

方法1：AIに直接伝える

“Sisyphusのモデルをclaude-sonnet-4.6に変更して” “Oracleはgpt-5.5を使って”

方法2：設定ファイルを手動編集

~/.config/opencode/oh-my-openagent.jsonの対応するエージェントのmodelフィールドを直接変更。

追加設定：OpenCode Zenをフォールバックとして追加

インストール時に無料のOpenCode Zenを忘れた場合（--opencode-zen=no）、後からOpenCodeの新しい会話でAIに修正してもらいます：

“実は無料のOpenCode Zenもあるんだけど、もうGitHub Copilotにはログインしてるから、修正して”

AIの最初の試みではOpenCode Zenがプライマリに設定され（opencode/claude-opus-4-7）、GitHub Copilotがフォールバックになりました。実際のニーズはその逆です：

“違う、GitHub Copilotをプライマリにして、OpenCode Zenの無料モデルをフォールバックにして”

AIが修正した後の最終設定戦略：

1
2

プライマリモデル: github-copilot/*     （有料、優先使用）
フォールバックモデル: opencode/*       （無料クレジット、Copilot利用不可時に自動切り替え）

主要設定スニペット（Sisyphusを例に）：

{
  "sisyphus": {
    "model": "github-copilot/claude-opus-4-7",
    "fallback_models": [
      { "model": "opencode/claude-opus-4-7" },
      { "model": "opencode/gpt-5.5" }
    ]
  }
}

💡 ヒント：設定要件を説明する際、プライマリ/フォールバックの関係を明確に——「XXをプライマリ、YYをフォールバックに」——と伝え、AIが逆にしないようにしましょう。

使用ヒント

インストール完了後、ターミナルでopencodeと入力して開始：

プロンプトにultraworkまたはulwを含めると自動並列処理がトリガー
Tabを押してPrometheus（プランナー）モードに入
/start-workを実行して完全なオーケストレーションを実行

付録：トラブルシューティング

問題	解決策
`doctor`コマンドタイムアウト（30s）	一部のチェックがハングする場合、`--verbose`を追加してトラブルシューティング、またはスキップしても使用に影響なし
PowerShellでの`if`構文エラー	OpenCodeのbashコマンドはPowerShellで構文変換が必要
Sisyphusの非Claudeモデルでのパフォーマンス低下	既知の制限、Claudeサブスクリプションがあると最良の体験
AIがプライマリ/フォールバックモデルを逆にする	プライマリ/フォールバックの関係を明確に説明：「XXをプライマリ、YYをフォールバックに」、「YYを追加して」だけは言わない

📚 参考元：技術エビ - OpenCode詳細攻略、Oh My OpenAgentインストールガイド

MCP入門ガイド：誰でも理解できるAIの万能プラグ

Mon, 01 Dec 2025 01:46:03 +0800