# 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の機能と実践的な使い方 🤖 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#