# OpenCodeの機能と実践的な使い方 🔌 エージェントに「外の世界」へ手を伸ばさせたい。Sentryのエラーやライブラリのドキュメントをそのままツールとして使えるのが、OpenCodeのMCPサーバー連携です。 🏷️ タイトル: 外部ツール接続（ローカル/リモート） 🔗 URL: 📘 概要 MCP（Model Context Protocol）サーバーを設定すると、外部サービスのツールがOpenCodeの組み込みツールと並んでエージェントから自動的に使えるようになります。ローカル（プロセス起動）とリモート（HTTPエンドポイント）の両方に対応します。 ⚙️ 機能の説明 設定は `opencode.json` の `mcp` ブロックに、サーバーごとの識別子で記述します。 ・ローカル: `type: "local"` とし、`command` に起動コマンドの配列、必要なら `environment` で環境変数を渡します。`timeout`（既定5000ms）も指定可能です。 ・リモート: `type: "remote"` とし、`url` を指定。認証は `headers` でBearerトークンを渡すか、OAuthを利用します（401を検知して自動フローも可能）。 各サーバーは `enabled` で個別にオン/オフできます。MCPツールはサーバー名を接頭辞として現れ、`tools` のワイルドカード（`*` や `?`）で全体・エージェント単位に有効/無効を切り替えられます。 🛠️ 実践的な使い方 リモートのSentry連携は、`opencode.json` の `mcp` 配下に `sentry` を作り、`type: "remote"`・`url: ""`・`headers` のBearer認証・`enabled: true` を書くだけです。 ローカルなら `"command": ["npx", "-y", "@/modelcontextprotocol/server-everything"]` のように起動します。ドキュメント検索の Context7（` Grep（` mcp auth <名前>` や `opencode mcp list` で認証・状態確認も可能です。 💡 ユースケース Sentryで本番エラーをエージェントに調査させ、Context7で最新ライブラリの正しい使い方を引き、Grepで他リポジトリの実装例を探す、といった「調査から実装まで」を1つのセッションで完結できます。普段は `enabled: false` にしておき、必要な作業のときだけ有効化する運用が安全です。 ⚠️ 注意点 MCPサーバーはコンテキストを消費します。多くのツールを公開するサーバー（GitHub系など）を有効にすると、トークンが急増しコンテキスト上限を圧迫しがちです。使うサーバーは絞り、APIキー運用なら `oauth: false` で自動OAuthを抑止しましょう。リモートは `timeout` 超過で起動失敗する点にも注意してください。 #OpenCode# #MCP#

# OpenCodeの機能と実践的な使い方 📜 「うちのプロジェクトの作法、毎回説明するの面倒…」を解決するのが `AGENTS.md` です。一度書けば、エージェントが常にそのルールを踏まえて動いてくれます。 🏷️ タイトル: AGENTS.md 🔗 URL: 📘 概要 `AGENTS.md` はOpenCodeにカスタム指示を与えるためのファイルです。プロジェクトの規約・アーキテクチャ・ビルド手順などを書いておくと、その内容がLLMのコンテキストに常時含まれ、エージェントの振る舞いをチームの流儀に合わせられます。 ⚙️ 機能の説明 ルールは2つのレベルで管理できます。 ・プロジェクト単位: リポジトリ直下の `AGENTS.md`。そのディレクトリ配下にのみ適用されます。 ・グローバル単位: `~/.config/opencode/AGENTS.md`。全セッション共通で、個人の好みに向いています。 起動時の探索順は、ローカルの `AGENTS.md` または `CLAUDE.md`（現在地から上位へ遡る）→ グローバルの `~/.config/opencode/AGENTS.md` → Claude Code互換の `~/.claude/CLAUDE.md` の順で、各カテゴリで最初に見つかったものが採用されます。Cursor風の運用にも近く、移行もしやすい設計です。 🛠️ 実践的な使い方 外部のドキュメントを指示として取り込みたい場合は、`opencode.json` の `instructions` に `["CONTRIBUTING.md", "docs/guidelines.md", ".cursor/rules/*.md"]` のようにファイルを列挙します。グロブも使えます。 ゼロから書くのが大変なら `/init` を実行すると、重要なファイルを走査し、必要に応じて質問しながら `AGENTS.md` を自動生成・改善してくれます。生成後はGitにコミットしてチームで共有しましょう。 💡 ユースケース 「コミットメッセージは日本語」「テストは pytest で書く」「この層を直接importしない」といった暗黙知を `AGENTS.md` に明文化しておけば、新メンバーにもエージェントにも同じ前提が伝わり、レビューの手戻りが減ります。モノレポでは `instructions` のグロブでパッケージごとの規約を束ねられます。 ⚠️ 注意点 `AGENTS.md` 内に手書きしたファイル参照は自動では展開されません。複数ファイルを確実に読ませたいときは `opencode.json` の `instructions` を使うのが堅実です。既存の `CLAUDE.md` がある場合は互換として認識されますが、新規は `AGENTS.md` に寄せると整理しやすいでしょう。リモートURL参照は5秒のタイムアウトがある点も覚えておきましょう。 #OpenCode# #AGENTSmd#

# OpenCodeの機能と実践的な使い方 🧰 AIエージェントに「何を許して、何を止めるか」を一行で決められたら安心しませんか。OpenCodeの組み込みツールと権限制御はまさにそれを叶えてくれます。 🏷️ タイトル: 組み込みツール+権限 🔗 URL: 📘 概要 OpenCodeのエージェントは、ファイル編集やシェル実行などを「ツール」を通じて行います。これらは標準で多数組み込まれており、さらに各ツールに対して許可・確認・拒否のポリシーを設定できます。安全性と利便性のバランスを設定ファイルだけで調整できるのが特徴です。 ⚙️ 機能の説明 主な組み込みツールは次のとおりです。 ・`bash`: シェルコマンドの実行（git や npm など） ・`edit`: 既存ファイルの厳密な文字列置換による編集 ・`write`: 新規作成または上書き ・`read`: ファイル読み込み（行範囲指定も可） ・`grep`: 正規表現での検索 ・`glob`: `**/*.js` のようなパターンでのファイル探索 ・`webfetch` / `websearch`: Web取得・検索 ・`lsp` / `apply_patch` / `skill` / `todowrite` / `question` など補助ツール 権限は `permission` フィールドで `allow`（自由実行）・`ask`（毎回確認）・`deny`（禁止）の3状態を指定します。`edit` の権限は `edit`・`write`・`apply_patch` の3つをまとめて支配する点に注意してください。 🛠️ 実践的な使い方 `opencode.json` の `permission` に `"edit": "deny"`、`"bash": "ask"`、`"webfetch": "allow"` と書けば、編集は禁止しつつ bash は都度確認、Web取得は自由、という運用ができます。 MCP由来のツールはワイルドカードでまとめて制御できます。`"mymcp_*": "ask"` のように書けば、そのサーバーの全ツールに確認を要求できます。 💡 ユースケース 本番に近いリポジトリでは `edit` を `deny`、`bash` を `ask` にしておくと、エージェントが計画や調査はできても、勝手にコードを書き換えたり破壊的コマンドを走らせたりしません。逆に使い捨ての検証ブランチでは全許可にして高速に回す、といった切り替えが容易です。 ⚠️ 注意点 標準では全ツールが許可されているため、明示的に絞らないと制限はかかりません。`lsp` ツールは `OPENCODE_EXPERIMENTAL_LSP_TOOL=true`、`websearch`（Exa利用）は `OPENCODE_ENABLE_EXA=1` の環境変数が必要です。`edit` 権限が write/apply_patch まで及ぶ点は見落としがちなので意識しておきましょう。 #OpenCode# #AIエージェント#

OpenCode ZenでGPT-5.6 Luna maxとDeepSeek V4 Flashの廉価オーケストレーション組んでみたけどサンドボックスや自動承認欲しいから、CodexからDeepSeek使う方法あるらしいのでそっちかな。Unity VR開発でDocker Sandboxesとかは使えないし

# OpenCodeの機能と実践的な使い方 🤖 1つのAIに何でも任せる時代は終わり。OpenCodeのエージェント機能なら、計画役・調査役・レビュー役を役割ごとに分け、権限まで細かく絞って安全に協働させられます。 🏷️ タイトル: プライマリ/サブエージェント 🔗 URL: 📘 概要 OpenCodeのエージェントは、直接対話する「プライマリエージェント」と、それらから呼び出される専門の「サブエージェント」に分かれます。役割とツール権限を分離することで、安全かつ効率的にタスクを進められます。 ⚙️ 機能の説明 ・プライマリ: 全ツールにアクセスできる開発用の Build と、編集・bashが既定で「ask」に制限された計画用の Plan があります。`Tab` で切り替えます。 ・サブエージェント: 多段の調査向けの General、読み取り専用でコードベースを探索する Explore、外部ドキュメントや依存関係を調べる Scout が組み込みです。`@/general ...` のように `@` で明示的に呼び出せるほか、プライマリが自動で起動することもあります。 ・カスタム定義: `opencode.json` のJSON、または `.opencode/agents/*.md` のMarkdown（フロントマター）で独自エージェントを定義できます。主な項目は `description`（必須）、`mode`（`primary`/`subagent`/`all`）、`model`、`prompt`、`temperature`、`permission`（`allow`/`deny`/`ask`）、`steps`、`hidden` などです。 🛠️ 実践的な使い方 編集を禁止した「監査専用エージェント」を定義すれば、誤った変更を防ぎつつレビューだけ任せられます。Markdown定義のフロントマターで `mode: subagent`、`permission` の `edit: deny` と `bash: deny` を指定し、本文に「入力検証・認証不備・データ露出・脆弱な依存関係を中心にレビュー」と書くだけです。`permission` の `bash` はグロブで細かく制御できます。 `opencode agent create` を使えば、対話形式で配置場所・目的・権限を選びながらMarkdown定義を生成できます。 💡 ユースケース 大きな機能追加では、まず Explore で関連箇所を読み取り専用で調査させ、Plan で方針を固め、Build で実装し、最後に編集禁止のレビュー用エージェントで点検する、という分業が組めます。 ⚠️ 注意点 ・`permission` の既定はエージェントごとに異なります（Planは編集/bashが ask）。意図せぬ変更を避けるため明示設定が安全です。 ・`bash` 権限はグロブ指定可能で、`"rm *": "deny"` のように危険コマンドを個別に拒否できます。 ・サブエージェントを `@` メニューから隠したい場合は `hidden` を使います。 #OpenCode# #AIAgents#

# OpenCodeの機能と実践的な使い方 ⚡ OpenCodeはTUIだけのツールではありません。`opencode run` を使えば非対話でプロンプトを実行でき、シェルスクリプトやCIパイプラインにAIを直接組み込めます。 🏷️ タイトル: プログラマティック実行 🔗 URL: 📘 概要 OpenCodeのCLIは、既定ではTUIを起動しますが、コマンドとフラグを通じてプログラマティックに動かせます。中心となるのが、プロンプトを一発で実行する `opencode run` です。 ⚙️ 機能の説明 ・`opencode run "..."`: 非対話でプロンプトを実行します。主なフラグは `-m/--model`（`provider/model` 指定）、`--agent`（カスタムエージェント）、`-s/--session`（既存セッション継続）、`-c/--continue`（直近セッション再開）、`-f/--file`（ファイル添付）、`--format`（`json` 等で出力）、`--attach`（起動中サーバーへ接続）です。 ・`serve`: UIなしのヘッドレスAPIサーバーを起動します（`--port`、認証は `OPENCODE_SERVER_PASSWORD`）。 ・`session`: 会話履歴の一覧・削除（`session list --format json`、`session delete `）。 ・`export` / `import`: セッションの書き出し・取り込み（`export --sanitize`）。 ・`models` / `auth` / `agent` / `github` / `mcp` / `stats` / `upgrade`: モデル一覧、認証管理、エージェント作成、GitHub連携、MCP管理、利用量確認、更新。 🛠️ 実践的な使い方 非対話実行をスクリプトに組み込めば、複数ファイルの一括処理やCIでのレビューが自動化できます。例えば `opencode run --format json "この差分をレビューして"` の出力をファイルに保存したり、`opencode serve` を常駐させて各ファイルを `opencode run --attach ... --file` でループ処理したりでき、`--attach` で接続するとレイテンシを抑えられます。 💡 ユースケース CIで変更ファイルだけを `opencode run` に渡してレビューコメントをJSONで受け取り、後続ジョブで集計・通知する、といった機械処理に向きます。`stats` で日次のトークン消費とコストを監視するのも有効です。 ⚠️ 注意点 ・`serve` を外部公開する際は `OPENCODE_SERVER_PASSWORD` による認証を必ず設定してください。 ・`--format json` の出力構造に依存する処理は、バージョン更新時に必ず確認しましょう。 ・`OPENCODE_DISABLE_AUTOUPDATE` などの環境変数で、CI環境での自動更新を抑止できます。 #OpenCode# #CLI#

# OpenCodeの機能と実践的な使い方 ✨ 「まず計画、それから実装」。OpenCodeの基本操作を覚えると、AIに安心して任せながら、いつでも変更を巻き戻せる開発リズムが手に入ります。 🏷️ タイトル: @検索・Plan/Build・画像・/undo・/redo 🔗 URL: 📘 概要 OpenCodeの日々の操作は、ファイル参照・エージェントモードの切替・画像入力・取り消し/やり直しといった少数の基本操作に集約されます。これらを押さえるだけで、対話的なコーディングがスムーズになります。 ⚙️ 機能の説明 ・`@`によるファイル参照: メッセージ内で `@` を入力するとファイル名のあいまい検索（fuzzy search）が起動し、対象ファイルを文脈に含めて質問できます。`!` を先頭に付けるとシェルコマンドを実行し、その出力をツール結果として渡せます。 ・Plan/Buildの切替: Planは編集やbashが「ask（確認）」に制限された計画用モード、Buildは全ツールにアクセスできる実装モードです。`Tab` キーで両者を切り替えます。 ・画像入力: 画像をターミナルにドラッグ&ドロップして、エラー画面やデザインなどを視覚情報として渡せます。 ・`/undo`と`/redo`: `/undo` は直前のメッセージとそれに伴うファイル変更を取り消します。複数回実行でさらに前へ戻れます。`/redo` は取り消した変更をやり直します。 🛠️ 実践的な使い方 1. まずPlanモードで `@/src/api/handler.ts のリファクタ計画を立てて` のように依頼し、計画を確認します。 2. 納得したら `Tab` でBuildに切り替え、実装させます。 3. 結果が思わしくなければ `/undo` で巻き戻し、必要なら `/redo` でやり直します。 具体的には `@/src/payment.ts のバグを調べて` のように `@` で参照し、`Tab` でPlanからBuildへ、`/undo` で取り消し（複数回可）、`/redo` でやり直し、という流れです。 💡 ユースケース 影響範囲の大きいリファクタは、まずPlanで方針を固めてからBuildで実装すると安全です。AIの変更が期待と違っても `/undo` で即座に元に戻せるため、試行錯誤のコストが下がります。 ⚠️ 注意点 ・`/undo` はメッセージ単位での巻き戻しです。手動で加えた変更との混在には注意してください。 ・Planモードでも編集が「ask」で許可される構成だと、確認に応じれば変更され得ます。承認時はよく確認しましょう。 ・画像のドラッグ&ドロップ対応はターミナルエミュレータに依存します。 #OpenCode# #AICoding#