OpenCode:リポジトリに合わせて AI コーディングエージェントを設定する
OpenCode は、ターミナル、デスクトップ、Web のインターフェースを持つオープンソースのコーディングエージェントです。有用性は接続するモデルと、提供するリポジトリの情報に左右されます。本記事は 2026 年 11 月 15 日に確認した v2 の文書に基づきます。古いチュートリアルでは設定項目が異なる場合があります。インストールガイドには対応パッケージと /connect コマンドが記載されています。
リポジトリとプロバイダーを接続する
OS に合うリリースをインストールし、プロジェクトのディレクトリで opencode を起動します。/connect でアカウントから利用できるプロバイダーを設定します。クライアントが動作してもモデルの利用が無料になるわけではなく、提供元の課金とデータ処理条件が適用されます。
リポジトリに opencode.jsonc を作り、下記のスキーマを追加します。設定リファレンスは、プロジェクト、グローバル、管理設定の関係を説明しています。設定が効かないときは各階層を確認してください。管理設定がプロジェクトの選択を上書きする場合があります。認証情報はコミット対象のファイルに含めません。
コマンドの実行範囲を明示する
この v2 の例では、シェルコマンドに確認を求め、push を禁止し、プロジェクト外のディレクトリへのアクセス時にも確認します。
{
"$schema": "https://opencode.ai/config.json",
"permissions": [
{ "action": "shell", "resource": "*", "effect": "ask" },
{ "action": "shell", "resource": "git push *", "effect": "deny" },
{ "action": "external_directory", "resource": "*", "effect": "ask" }
]
}
一致する最後の権限ルールが適用されるため、エージェント固有の上書きも確認します。これはツールの権限であり、OS のサンドボックスではありません。アクション名と照合の仕組みは権限リファレンスを参照してください。
具体的な不具合を一つ調べる
フォームが二重送信される場合は Plan で始めます。「送信ハンドラーとネットワーク要求を追跡し、1 回のクリックで 2 回要求が送られる理由と最小の修正案を示して」と依頼します。Plan は通常のプロジェクトファイルの編集を避けますが、シェルコマンドは引き続き権限管理の対象です。実装を担当するのは Build で、違いはエージェントリファレンスに説明があります。
Build には対象ファイルと合格条件を渡します。クリックごとの要求は 1 回、入力検証は現状維持、連続送信には回帰チェックを用意する、という条件です。既存のテスト基盤を使い、実際のコマンド出力を報告させます。もっともらしい説明だけで正しさを判断しないでください。
採用前に結果を確認する
git diff を確認し、関連テストとリポジトリ必須のチェックを実行して、依存関係や生成ファイルの意図しない変更を調べます。クリーンな Git の基準点を残してください。ファイルの取り消しでは、リモート操作やデータベース変更を元に戻せません。同じ不具合でプロバイダーを比較し、レビュー時間、残った失敗、実際の利用料金を記録します。架空のスコアやモデルの挙動が同一という前提に頼らず、選定の根拠を作れます。