# OpenCodeの機能と実践的な使い方 🤖 OpenCodeを「ターミナルで対話するツール」から「プログラムで操れる開発サーバー」へ。SDKとheadlessサーバーを使えば、CIや独自UIにAIコーディングを組み込めます。 🏷️ タイトル: 型安全JSクライアント・headlessサーバー 🔗 URL: 📘 概要 OpenCodeはTUIだけでなく、HTTPで操作できるheadlessサーバーとして起動できます。`@opencode-ai/sdk` という型安全なJavaScript/TypeScriptクライアントから、このサーバーへ接続してセッション作成・プロンプト送信・イベント購読などを行えます。型はサーバーのOpenAPI仕様から自動生成されるため、補完と型チェックがそのまま効きます。 ⚙️ 機能の説明 ・サーバー起動: `opencode serve` でheadlessサーバーを立ち上げます。既定は `127.0.0.1:4096` です。SDKの `createOpencode()` を使えばコードからサーバー起動とクライアント取得を同時に行えます。 ・クライアント接続: 既存サーバーには `createOpencodeClient({ baseUrl: "http://localhost:4096" })` で接続します。 ・主なAPI: セッションの作成/一覧/取得/更新/削除、共有の切替、中断、メッセージのrevert/unrevert。`client.session.prompt()` でプロンプトを送信します。 ・構造化出力: `format: { type: "json_schema", schema: {...} }` を指定すると、JSONスキーマに沿った検証済みJSONを受け取れます。後段の機械処理に最適です。 ・イベント購読: `client.event.subscribe()` でサーバー送信イベントをストリームとして受け取り、長時間処理の進捗を監視できます。 🛠️ 実践的な使い方 コードからは `createOpencode()` でサーバー起動とクライアント取得を同時に行い、`client.session.create()` でセッションを作り、`client.session.prompt()` にテキストと `format` の `json_schema` を渡せば検証済みJSONを受け取れます。終わったら `server.close()` で停止します。 CIに組み込む場合は、コンテキスト注入だけ行ってAI応答を発火させたくない場面で `noReply: true` が便利です。 💡 ユースケース ・社内のレビューBotから `opencode run` ではなくSDK経由で構造化された指摘JSONを取得し、GitHub PRコメントへ整形投稿する。 ・自前のWeb UIやエディタ拡張から `tui` 系APIでプロンプト投入・送信・トースト表示を制御し、独自フロントエンドを構築する。 ・夜間バッチで複数リポジトリへ同一の解析プロンプトを投げ、結果JSONをデータ基盤へ蓄積する。 ⚠️ 注意点 ・SDKのconfigは `opencode.json` を完全に置き換えるのではなく上書きマージする挙動です。意図しない設定の残存に注意してください。 ・構造化出力は検証失敗時にリトライ（既定2回）し、最終的に失敗すると ` に `StructuredOutputError` が入ります。スキーマは小さく焦点を絞ると安定します。 ・`client.session.get()` などは存在しないIDで例外を投げます。必ずtry-catchで囲んでください。 #OpenCode# #AIエージェント#

# OpenCodeの機能と実践的な使い方 🧰 組み込みツールだけでは足りない、社内APIやDBを叩きたい。そんなときはLLMが呼べる「自分専用のツール」を作れます。 🏷️ タイトル: 独自ツール作成 🔗 URL: 📘 概要 カスタムツールは、LLMが会話中に自律的に呼び出せる独自の関数です。read/write/bashといった組み込みツールを拡張し、社内APIアクセスやDBクエリなど、ドメイン固有の操作をエージェントに与えられます。定義はTypeScript/JavaScriptで書きますが、中身では任意の言語を実行できます。 ⚙️ 機能の説明 ・配置場所は2つ。プロジェクト単位なら `.opencode/tools/`、グローバルなら `~/.config/opencode/tools/` です。 ・ファイル名がそのままツール名になります。`database.ts` なら `database` ツールになります。 ・1ファイルから名前付きエクスポートで複数ツールを定義でき、その場合は `<ファイル名>_<エクスポート名>` という名前になります。 ・`@opencode-ai/plugin` の `tool()` ヘルパーで定義します。`description`(LLMへの説明)、`args`(Zodスキーマ)、`execute`(非同期の実装本体)が主要素です。 ・引数はZodで型安全に定義します。`tool.schema` 経由でも、`zod` を直接 import しても構いません。 ・`execute` の第2引数 context から `agent` `sessionID` `messageID` `directory` `worktree` といったセッション情報を受け取れます。 🛠️ 実践的な使い方 最小例として `.opencode/tools/database.ts` に、`tool()` で `description`・Zodの `args`（例: `query`）・非同期の `execute` を定義してデフォルトエクスポートします。 中身は任意言語を呼べます。たとえばcontextの `worktree`（gitルート）からスクリプトのパスを組み立て、`Bun.$` で `python3` を実行すればPythonにも橋渡しできます。 💡 ユースケース 社内の在庫APIや認証付き内部エンドポイントを叩くツールを定義しておけば、エージェントが組み込みツールと同じ感覚で社内データを取得・更新できます。説明文(description)を丁寧に書くほど、LLMが適切なタイミングで呼んでくれます。 ⚠️ 注意点 ・組み込みツールと同名にすると上書きされます。意図して置き換える場合を除き、ユニークな名前を付けてください。組み込みツールを無効化したいだけなら、上書きではなく権限(permission)で `deny` するのが正攻法です。 ・`execute` 内で外部コマンドや社内APIを叩くため、実行権限や秘密情報の扱いには十分注意してください。 #OpenCode# #AIエージェント#

# 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#