OpenCode on Yanmu

OpenCode + Obsidian：AI駆動のナレッジマネジメントワークフローを構築する

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

📋 目次

一、opencode-obsidianプラグインとは？

opencode-obsidianは、OpenCode AIアシスタントをObsidianウィンドウに直接埋め込むサードパーティコミュニティプラグインです。従来のターミナル統合ソリューションとは異なり、このプラグインはOpenCodeのWebビューを使用して直接埋め込むため、表示されるのは完全なOpenCodeインターフェースであり、ターミナルとObsidianの間を行き来する必要がありません。

コア機能：

🖥️ OpenCodeインターフェースがObsidianのサイドバーやメインエディタに直接埋め込み
🔄 サーバーの自動管理——パネルを開くと起動、閉じると停止
📄 実験的なコンテキスト注入——現在開いているノートと選択テキストを自動的にAIに渡す
⌨️ ショートカット Ctrl/Cmd + Shift + O でパネルを素早く切り替え

適用シーン：

長文コンテンツの要約と精製
執筆、編集、推敲
ナレッジベースの検索と探索
アウトラインと構造化ノートの生成

⚠️ プラグイン作者はOpenCode / Obsidianとは無関係で、これは独立したサードパーティプロジェクトです。現在のバージョンは0.2.1（Beta段階）、デスクトップのみ対応。

二、環境準備

始める前に、以下の準備ができていることを確認してください：

項目	要件	説明
Obsidian	≥ 1.4.0	公式サイトからダウンロード
Node.js	≥ 18+	ダウンロード、OpenCodeのインストールに必要

準備ができたら、以下の手順に従ってください。

三、BRATプラグインのインストール

BRAT（Beta Reviewer’s Auto-update Tool）は、コミュニティプラグインマーケットプレイスにまだ公開されていないBeta版プラグインをインストールするためのObsidianコミュニティプラグインです。opencode-obsidianはまだ正式に公開されていないため、BRATでのインストールが必要です。

ステップ1：コミュニティプラグインマーケットプレイスを開く

Obsidianで順にクリック：設定 → サードパーティプラグイン → 「セーフモード」をオフ → コミュニティプラグインマーケットプレイス

ステップ2：BRATを検索してインストール

コミュニティマーケットプレイスでBRATを検索（正式名称：Obsidian42 - BRAT）、「インストール」→「有効化」をクリック。

💡 BRATはBeta Reviewer’s Auto-update Toolの略で、TfTHackerによって開発されました。Betaプラグインの更新を自動的に検出し、アップグレードを通知します。

四、BRATでopencode-obsidianをインストール

BRATがインストールできたら、それを使ってopencode-obsidianプラグインをインストールできます。

ステップ1：BRAT設定を開く

設定 → サードパーティプラグイン → インストール済みのBRATを見つけ、右側の歯車アイコンをクリックして設定に入ります。

ステップ2：Betaプラグインを追加

BRAT設定ページで、**「Add Beta plugin」**ボタンをクリック。

ステップ3：リポジトリアドレスを入力

ポップアップの入力ボックスに以下を入力：

`1`	`mtymek/opencode-obsidian`

**「Add Plugin」**をクリック。

BRATがGitHubから最新のリリースバージョンを自動的に取得してインストールします。

ステップ4：プラグインを有効化

インストール完了後、設定 → サードパーティプラグイン → 「インストール済みプラグイン」リストでOpenCode-Obsidianを見つけ、スイッチをオンにして有効化します。

✅ 有効化後、Obsidianの左サイドバーにターミナル風のアイコンが表示されます——これがOpenCodeのエントリーポイントです。

自動更新

BRATは定期的にGitHubの新しいバージョンをチェックします。更新があると、Obsidian内で通知が表示され、確認をクリックするだけで自動アップグレードされます。

五、OpenCode CLIのインストール

プラグイン自体は「シェル」に過ぎません——バックグラウンドでopencode serveサービスを起動し、OpenCodeのWebインターフェースをObsidianに埋め込みます。そのため、npmでOpenCode CLIをインストールするだけで十分です。

システムのターミナルを開きます（WindowsはPowerShell、macOS/LinuxはTerminal）：

`1`	`npm i -g opencode-ai`

インストール確認：

1
2

opencode --version
# 期待出力例: 1.14.39

⚠️ Windowsユーザー：プラグインが「Executable not found at ‘opencode’」と表示する場合、本文の第十節にジャンプして解決策を確認してください。

六、プラグイン設定の詳細

プラグインを有効化した後、設定 → サードパーティプラグイン → OpenCode-Obsidianの歯車アイコンから、以下の設定項目を確認できます：

基本設定

設定項目	デフォルト	説明
OpenCode実行ファイルパス	`opencode`	システムPATHで見つからない場合、フルパスを入力
ポート	`14096`	OpenCodeサービスがリッスンするポート番号
ホスト名	`127.0.0.1`	サービスがバインドするアドレス
プロジェクトディレクトリ	（Vaultパスから自動取得）	OpenCodeが操作する作業ディレクトリ
起動タイムアウト	`45000` (45秒)	サービス起動を待つ最大ミリ秒数

インターフェース設定

設定項目	デフォルト	説明
デフォルトビューポジション	`sidebar`	`sidebar` = サイドバー、`main` = メインエディタ
自動起動	`オフ`	Obsidian起動時にOpenCodeサービスを自動起動

コンテキスト注入（実験的）

設定項目	デフォルト	説明
ワークスペースコンテキスト注入	`オフ`	現在のノート情報をOpenCodeに自動転送
最大ノート数	`20`	コンテキストに含まれる最大ノート数
最大選択テキスト長	`2000`	AIに渡す選択テキストの文字数上限

カスタムコマンド

設定項目	デフォルト	説明
カスタムコマンドを使用	`オフ`	有効にするとOpenCode起動コマンドをカスタマイズ可能
カスタムコマンド	（空）	カスタム起動コマンド（第九節を参照）

七、初回使用

OpenCodeパネルを開く

OpenCodeを開く3つの方法：

サイドバーアイコンをクリック：左サイドバーのターミナルアイコンをクリック
ショートカット：Ctrl + Shift + O（macOSはCmd + Shift + O）
コマンドパレット：Ctrl/Cmd + P → Toggle OpenCode panelと入力

初回起動フロー

パネルを開くと、プラグインが自動的に以下を実行：

OpenCode実行ファイルパスを検出
OpenCodeサービスを起動（opencode serve）
埋め込みWebビューにOpenCodeインターフェースを読み込み

起動成功後、完全なOpenCodeダイアログインターフェースが表示され、プロンプトを直接入力できます。

すべてが正常に動作しているか確認

OpenCodeインターフェースで以下を入力：

/help

コマンド一覧が表示されれば、すべて正常です。以下も入力できます：

/models

利用可能なAIモデルを確認。OpenCodeには無料モデル（GLM-4.7、MiniMax-2.1）が内蔵されており、設定不要ですぐ使えます。

ショートカット早見表

ショートカット	機能
`Ctrl/Cmd + Shift + O`	OpenCodeパネルの切り替え

八、コンテキスト注入（実験的機能）

これはopencode-obsidianプラグインの最もユニークな機能の1つ——Obsidianの作業コンテキストをOpenCodeに自動的に渡せます。

有効にする方法

プラグイン設定で、**「ワークスペースコンテキスト注入」**スイッチをオンにします。

注入される内容

有効にすると、プラグインは以下の情報を実行中のOpenCodeインスタンスに自動転送します：

📂 現在開いているノート一覧：どのファイルを編集中か
📝 選択テキスト：ノートでハイライトしたテキスト

使用シーン

テキストを選択してOpenCodeパネルを開き、「この文章を推敲して」と言う——AIはすでにどのテキストかを知っている
複数のノートを同時に開き、AIに「この2つのノートの違いを比較して」と頼む——AIはすでにどのファイルが開いているかを知っている

制限事項

⚠️ これは実験的機能で、現在いくつかの制限があります：

OpenCodeインターフェースで新しいSessionを作成する時、コンテキストは自動注入されない

コンテキスト更新には一定の遅延がある

九、カスタムコマンドモード

デフォルトでは、プラグインはopencode serveコマンドでサービスを起動します。より多くの制御が必要な場合は、カスタムコマンドモードを有効にしてください。

カスタムコマンドが必要な場合

追加のCLI引数が必要な場合
カスタム起動スクリプトを使用する場合
コンテナや仮想環境でOpenCodeを実行する場合
OpenCodeが非標準パスにインストールされている場合

設定手順

プラグイン設定で**「カスタムコマンドを使用」**をオン
**「カスタムコマンド」**入力ボックスに完全なコマンドを入力

コマンドテンプレート

`1`	`opencode serve --port 14096 --hostname 127.0.0.1 --cors app://obsidian.md`

⚠️ 重要な注意事項

ポートとホスト名は設定の値と一致している必要があります
--cors app://obsidian.mdを含める必要があります——さもないとObsidianがOpenCodeのWebインターフェースを埋め込めません

十、よくある質問とトラブルシューティング

❌ OpenCode実行ファイルが見つからない

症状：パネルを開くと「Executable not found at ‘opencode’」と表示されるが、ターミナルでopencodeは正常に動作する。

原因：Electron（Obsidianの基盤フレームワーク）がWindowsでシステムPATH環境変数を完全に継承しない。

解決策：

ターミナルでopencode.cmdのフルパスを検索：

`1`	`where opencode.cmd`

出力されたフルパスをプラグイン設定の「OpenCode実行ファイルパス」に貼り付け、例：

`1`	`C:¥Users¥あなたのユーザー名¥AppData¥Roaming¥npm¥opencode.cmd`

❌ サービス起動タイムアウト

考えられる原因：ネットワークの問題、モデル読み込みの遅さ、ポートが使用中。

解決策：

ポート14096が他のプログラムで使用されていないか確認
ポート番号を変更してみる（例：15096に）
起動タイムアウト時間を増やす

❌ パネルが空白で表示される

考えられる原因：CORS設定が正しくない。

解決策：

カスタムコマンドを使用している場合、コマンドに--cors app://obsidian.mdが含まれていることを確認してください。

❌ パネルを埋め込めない

考えられる原因：OpenCodeのバージョンが古い。

解決策：

`1`	`npm i -g opencode-ai@latest`

❌ 中国語ファイル名の文字化け（Windows）

解決策：PowerShellで実行：

`1`	`chcp 65001`

その後、Obsidianを再起動してください。

❌ プラグイン更新後に再設定が必要

BRATはプラグイン更新時に設定データを保持します。設定が失われている場合は、設定ページを開いて再設定してください。

まとめ

インストールフロー全体を一図でまとめると：

┌──────────────────────────────────────────┐
│        BRATプラグインをインストール         │
│  設定 → コミュニティマーケットプレイス      │
│  → BRATを検索 → インストール              │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│   BRATでopencode-obsidianをインストール    │
│   BRAT設定 → Add Beta plugin              │
│   入力: mtymek/opencode-obsidian          │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│        OpenCode CLIをインストール          │
│   npm i -g opencode-ai                   │
└──────────────────┬───────────────────────┘
                   │
                   ▼
┌──────────────────────────────────────────┐
│      プラグインを有効化して使用開始         │
│   Ctrl+Shift+Oでパネルを開く              │
│   Obsidian内でOpenCodeを直接使用          │
└──────────────────────────────────────────┘

一言まとめ：BRATをインストール → mtymek/opencode-obsidianを検索 → OpenCode CLIをインストール → Ctrl+Shift+Oで始めよう。これだけ簡単です。

📚 参考元：

opencode-obsidian GitHubリポジトリ

BRATプラグインGitHubリポジトリ

OpenCode公式ドキュメント

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インストールガイド

OpenCode 初級者から上級者へ：並列スケジューリングと使用テクニック完全ガイド

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

📋 目次

📌 コアポイントまとめ

機能	一言説明
Session並列	OpenCodeのキラー機能、複数タスクが同時に実行、干渉なし、効率2倍
Ultra Workモード	`ULW`を入力、メインエージェントがタスクを自動分解、サブエージェントを並列配置
@でエージェント指定	フロントエンド得意な人にフロントエンドを、アーキテクチャ得意な人にレビューを
Timelineタイムマシン	いつでも任意の履歴ポイントにロールバック、大胆に試してコストゼロ
Ralph Loop	AIに数時間ループで作業させ、極めて困難なタスクに挑戦

一、Session並列：AIに複数のタスクを同時にやらせる

これは他のAIプログラミングツールと比較したOpenCodeの最大の差別化優位性です。従来のツールは直列処理のみ——1つのタスクが完了してから次のタスクを開始できます。OpenCodeは複数のSessionを同時に開始でき、互いに干渉しません。

基本操作

/new              # 新しいSessionを作成
/sessions         # すべてのSessionの状態を確認（回転シンボル = 実行中）
/session <id>     # 指定のSessionに切り替え
/session prev     # 前のSessionに戻る
``### 実践シナリオ

「お絵かきおたずね」ゲームを開発しており、2つの独立した要件があるとします：

- **要件A**：タイマーを追加、最初のストロークでカウント開始、20秒超過でゲームオーバー
- **要件B**：ブラシの色を調整可能に

#### 従来の方法

Aを完了してからBへ → 要件Bは**5-10分**待たされる。

#### OpenCodeの方法

要件Aを入力、AIが作業開始
/newと入力、新しいSessionを作成
要件Bを入力、AIが作業開始
/sessionsで進捗確認：

Session 1 ◐ タイマーロジック追加中… Session 2 ◐ カラーピッカー追加中…


> 2つの要件が完全に並列開発、総所要時間が**15分から8分に短縮**。

### 注意事項

- ⚠️ Session間は完全に隔離、同一ファイルの変更は競合する可能性、異なるモジュールに割り当てることを推奨
- ⚠️ バックグラウンドSessionは完了を自動通知しない、手動で`/sessions`を確認
- ✅ いつでも`/new`で3つ目、4つ目のSessionを開けます——数に制限なし

---

## 二、Ultra Work：ワンクリックでAIプログラミングチームを召集

Session並列が「マニュアル車」なら、Ultra Workは「**フル自動運転**」です。魔法の言葉を入力すると、AIが自動的にタスクを分割し、最適なエージェントに割り当て、並列実行します。

### トリガーメソッド

プロンプトに以下のいずれかのキーワードを含めます：

ULW ultrawork Ultra Work

1
2


### 仕組み

あなたの要件：ペットショップウェブサイトを作って │ ▼ ┌─────────────────────────────┐ │ シーシュポス（メインエージェント） │ │ 1. タスク分解 → Todo List │ │ 2. サブタスクの割り当て │ └──────┬──────────┬───────────┘ │ │ ┌────▼───┐ ┌───▼────┐ ┌────────▼────┐ │ 予言者 │ │フロント │ │ドキュメント │ │アーキテク│ │UI開発 │ │ライター │ └────────┘ └────────┘ └─────────────┘ │ │ │ └──────────┴────────────┘ │ ▼ プロジェクト完成納品


1. Todo Listに自動分割
2. 3つのバックグラウンドタスクを並列実行
3. メインエージェントが中央からオーケストレーション
4. 最終的に完全なプロジェクトを納品

### いつ使う？

| シナリオ | 適用 | 説明 |
|----------|------|------|
| ゼロから完全なプロジェクト作成 | ✅ 最適 | フロントエンド、バックエンド、ドキュメントを自動分割 |
| マルチモジュール並列開発 | ✅ 最適 | 各エージェントの役割が明確 |
| 単一ファイルの小さな変更 | ❌ 非推奨 | オーバーキルで、かえって遅い |
| シンプルなバグ修正 | ❌ 非推奨 | 通常のチャットの方が速い |

> 💡 複雑度が高いほど、Ultra Workの価値が増します。シンプルなタスクはスケジューリングのオーバーヘッドで遅くなります。

### 実際の効果

Ultra Workモードでペットショップウェブサイトを作成：

- ✅ 画像素材なしで、絵文字を装飾として使用
- ✅ クリーンなインターフェース、スムーズなインタラクション、完全なアニメーション

---

## 三、@でエージェント指定：プロにプロの仕事させる

Oh My OpenAgent（OMO）をインストールすると、**AIプログラミングチーム**が手に入ります。`@`で特定のエージェントを指名できます。

### エージェント能力表

| エージェント | 得意分野 | 最適モデル | 使用例 |
|-------------|----------|-----------|--------|
| 🧠 シーシュポス | 全体計画、タスクスケジューリング | Claude Opus | 複雑な多ステップタスク |
| 🔮 予言者 | アーキテクチャ設計、コードレビュー | GPT 5.5 | プロジェクト構造設計 |
| 🎨 フロントエンドエンジニア | UI開発、ページレイアウト | Gemini 3 Pro | レスポンシブレイアウト最適化 |
| 🔍 探索者 | ウェブ検索、リサーチ | MiniMax | 最新APIドキュメント検索 |
| 📚 司書 | 文献調査、ドキュメント検索 | — | オープンソースプロジェクトのソースコード整理 |
| 📝 ドキュメントライター | README、コメント生成 | — | プロジェクトドキュメント生成 |
| 🖼️ マルチモーダル | 画像/PDF理解 | — | デザインモックからコード作成 |

### 使用例

@フロントエンドエンジニアこのログインページをレスポンシブレイアウトに変えて、モバイルでも良く見えるようにして

@予言者 src/service/ディレクトリのコードをレビューして、潜在的なパフォーマンス問題を見つけて

@探索者 React 19のServer Componentsの最新の使い方を調べて

@ドキュメントライタープロジェクト全体のAPIドキュメントを生成して


### メインエージェントの切り替え

`Tab`キーを押すと現在の会話のメインエージェントを切り替えられます——特定のロールを長時間使用するのに適しています。

---

## 四、Timelineタイムマシン：自由に試して、いつでもロールバック

プログラミングで最も怖いことは？大量のコードを変更して、アプローチが間違っていることに気づき、戻れないこと。**Timelineはあなたのアンドゥボタン**です。

### 基本的な使い方

```bash
/timeline    # 現在のSessionのすべての会話ステップを一覧表示

任意のノードを選択：

Revert：コードとチャットコンテンツをそのポイントにロールバック、何も起こらなかったかのように
View：当時AIが行った変更を確認

実践シナリオ

1
2
3

1. AIにモジュールをリファクタリングさせた → 結果が不満足
2. /timeline → リファクタリング前のノードを選択 → Revert
3. コードがリファクタリング前に戻る、別のアプローチで再挑戦

使用テクニック

🕐 ステージングタスクを完了したら、そのノードを心に留めておく（何回目の会話か）
🕐 大胆にラディカルなアプローチを試す——ワンクリックロールバックでいつでも戻れる
🕐 2つのアプローチを比較：アプローチAにRevert → 結果を確認 → アプローチBにRevert → 比較

これがプログラミング版の「セーブ/ロード」——あらゆる可能性を恐れずに探索できます。

五、Ralph Loop：AIに最後までやり遂げさせる

このモードはAIに継続的にループ作業をさせ、タスクが本当に完了するまで続けます。反復的な改善が必要な難しいタスクに最適です。

起動方法

`1`	`/ralph-loop`

適用シナリオ

"最新のSpring Boot 4標準を使用してプロジェクト全体をリファクタリングし、すべてのテストケースがパスするまで"

"src/配下のすべてのファイルのコード規範を1つずつチェックし、すべての違反項目を修正"

"プロジェクトに完全なユニットテストを追加し、カバレッジが90%に達するまで"

Ultra Workとの違い

比較項目	Ultra Work	Ralph Loop
メカニズム	並列分割、マルチエージェント協調	直列ループ、継続的イテレーション
最適な場面	ゼロからの構築、マルチモジュールプロジェクト	リファクタリング、修正、目標達成タスク
所要時間	数分から十数分	数時間の場合も
終了ポイント	タスク分解完了	終了条件の達成

⚠️ Ralph Loopは長時間実行される場合があります——APIクォータの消費に注意。

六、日常スピードアップのコツ

1. `/compact`でコンテキストを節約

AIとたくさん会話して、コンテキストウィンドウがいっぱいになりかけた時：

`1`	`/compact`

AIがこれまでの会話を要約にまとめ、作業を続けるためのスペースを解放。新しい会話を開いてコンテキストを失う必要はありません。

2. `/init`でAIに新しいプロジェクトを素早く理解させる

新しいプロジェクトに入った時、まずAIにコードを読ませます：

/init

AIがプロジェクト全体をスキャンし、agents.mdをシステムプロンプトとして生成。以降のすべての会話がこの理解に基づくため、効率が大幅に向上。

3. Shareでプログラミングプロセスを共有

1
2
3

/share      # 完全な会話とコード変更を表示する共有リンクを生成
/unshare    # 共有を停止、リンクが無効に
/export     # 会話履歴をファイルとしてエクスポート

適した場面：

同僚にAIでどう問題を解決したかを示す
トラブルシューティングの記録をチームの参考として
ブログ記事の素材として

4. 利用可能なモデルを確認

`1`	`/models # freeマーク付きは無料モデル`

GLM-4.7とMiniMax-2.1はプログラミング能力が良好で、軽量タスクに最適。

5. コードの素早い貼り付け（VS Codeプラグイン）

VS Codeでコードスニペットを選択 → Ctrl + Alt + K → OpenCodeダイアログに直接貼り付け。

コピーペーストの切り替えコストを省き、フロー状態を維持。

七、初心者おすすめワークフロー

┌─────────────────────────────────────────────┐
│                 新しい要件をもらう              │
└──────────────────┬──────────────────────────┘
                   │
                   ▼
          ┌────────────────┐
          │ シンプル？       │
          └───┬────────┬───┘
              │ はい     │ いいえ（複雑/マルチモジュール）
              ▼         ▼
    ┌─────────────┐  ┌─────────────────┐
    │通常のチャット │  │ULWを入力して    │
    │で対応        │  │Ultra Workモード │
    └─────────────┘  │をトリガー       │
                     └────────┬────────┘
                              │
                   ┌──────────▼──────────┐
                   │複数の独立した       │
                   │サブタスクがある？    │
                   └───┬──────────┬──────┘
                       │ はい      │ いいえ
                       ▼           ▼
              ┌─────────────┐ ┌──────────────┐
              │/newで複数    │ │Ultra Workが  │
              │Session並列   │ │自動完了するの │
              └──────┬──────┘ │を待つ         │
                     │        └──────────────┘
                     ▼
              ┌─────────────┐
              │/sessions     │
              │すべての進捗を│
              │確認          │
              └──────┬──────┘
                     │
                     ▼
              ┌─────────────┐
              │方向が違う？   │
              └───┬─────────┘
                  │
                  ▼
              ┌─────────────┐
              │/timeline →   │
              │Revertで戻る  │
              └─────────────┘

一言まとめ

小さなタスクは直接チャット、大きなタスクはULW、並列はSession、間違いはTimelineでロールバック、粘る時はRalph Loop。

八、実際の事例

Oh My OpenAgentのインストール完了後、エージェントモデルの設定を調整——GitHub Copilotをプライマリに、無料のOpenCode Zenをフォールバックにしたいと思いました。

最初の試み

OpenCodeの会話で直接言いました：

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

AIがOpenCode Zenをプライマリに設定——プライマリ/セカンダリの関係が不明確だったため。❌

修正

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

AIがすぐに修正し、oh-my-openagent.jsonを更新、すべてのエージェントがgithub-copilot/*をプライマリ、opencode/*をフォールバックに。✅

💡 教訓：AIに要件を説明する際、プライマリ/フォールバックの関係を必ず明確に——「XXをプライマリ、YYをフォールバックに」、「YYを追加して」だけは言わない。

📚 参考元：OpenCode完全ガイド、Oh My OpenAgent 📅 ノート生成日：2026-05-07

OpenCode on Yanmu

OpenCode + Obsidian：AI駆動のナレッジマネジメントワークフローを構築する

📋 目次

一、opencode-obsidianプラグインとは？

二、環境準備

三、BRATプラグインのインストール

ステップ1：コミュニティプラグインマーケットプレイスを開く

ステップ2：BRATを検索してインストール

四、BRATでopencode-obsidianをインストール

ステップ1：BRAT設定を開く

ステップ2：Betaプラグインを追加

ステップ3：リポジトリアドレスを入力

ステップ4：プラグインを有効化

自動更新

五、OpenCode CLIのインストール

六、プラグイン設定の詳細

基本設定

インターフェース設定

コンテキスト注入（実験的）

カスタムコマンド

七、初回使用

OpenCodeパネルを開く

初回起動フロー

すべてが正常に動作しているか確認

ショートカット早見表

八、コンテキスト注入（実験的機能）

有効にする方法

注入される内容

使用シーン

制限事項

九、カスタムコマンドモード

カスタムコマンドが必要な場合

設定手順

コマンドテンプレート

⚠️ 重要な注意事項

十、よくある質問とトラブルシューティング

❌ OpenCode実行ファイルが見つからない

❌ サービス起動タイムアウト

❌ パネルが空白で表示される

❌ パネルを埋め込めない

❌ 中国語ファイル名の文字化け（Windows）

❌ プラグイン更新後に再設定が必要

まとめ

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

📋 目次

一、OpenCodeとは？

Claude Codeとの比較

コアポジショニング

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

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

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

3. VS Codeプラグイン版

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

三、無料モデルの設定

利用可能なモデルを確認

おすすめ無料モデル

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

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

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

方法3：OpenRouter（万能接続）

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

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

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

⭐ 3. Session並列処理

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

5. Share共有

五、Skillsスキル移行

操作手順

六、MCP設定

ローカルMCP（Local）

リモートMCP（Remote）

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

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

3つのMCP Server

統合ツール

インストールと使用

2つのコア使用法

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

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

Ralph Loopモード

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

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

1. `/compact`でコンテキストを節約

2. `/init`でAIに新しいプロジェクトを素早く理解させる