opencode-config

OpenCode の設定

設定ファイルとルールのガイド付きセットアップを通じて、ユーザーが OpenCode を設定できるよう支援します。

<question_tool>

質問のまとめ方： 関連する質問が2つ以上ある場合のみ使用します。質問が1つの場合は通常のテキストを使用します。

構文の制約： ヘッダーは最大12文字、ラベルは1～5語とし、デフォルトには (Recommended) を付けます。

目的： 設定の対象範囲（モデル／権限／ルール）を明確にし、設定方法を検証し、複数の有効な選択肢に対応します。

</question_tool>

ファイルの場所

種類	グローバル	プロジェクト
設定	~/.config/opencode/opencode.json	./opencode.json
ルール	~/.config/opencode/AGENTS.md	./AGENTS.md

優先順位： プロジェクト > グローバル。設定は置き換えではなく、マージされます。

質問ツール

質問のまとめ方： 関連する質問が2つ以上ある場合は、question ツールを使用します。質問が1つの場合は通常のテキストを使用します。

構文： header は12文字以下、label は1～5語とし、デフォルトには "(Recommended)" を追加します。

質問するタイミング：曖昧な依頼（「opencode を設定して」）、権限やセキュリティの変更、または複数の有効な選択肢がある場合です。

ワークフロー

ユーザーが何を設定したいのかを尋ねます。

1. 「何を設定しますか？」
   • 設定ファイル（モデル、ツール、権限、テーマ）
   • ルール（AGENTS.md を使用したプロジェクトの指示）

次に、以下の該当するセクションに沿って案内します。

<config_file>

設定ファイル（opencode.json）

基本設定

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "theme": "opencode",
  "autoupdate": true
}

主なオプション

オプション	目的	例
model	デフォルトのモデル	"anthropic/claude-sonnet-4-20250514"
small_model	軽量なタスク	"anthropic/claude-3-5-haiku-20241022"
theme	UI テーマ	"opencode"、"catppuccin"、"dracula"
autoupdate	OpenCode の自動更新	true / false
share	セッションの共有	"manual" / "auto" / "disabled"

権限

permission フィールドを使って、承認が必要な操作を制御します。

{
  "permission": {
    "edit": "allow",           // "allow" | "ask" | "deny"
    "bash": {
      "npm *": "allow",        // pattern matching
      "git *": "allow",
      "rm *": "ask",
      "*": "ask"               // default for this tool
    },
    "webfetch": "allow",
    "skill": {
      "*": "allow",
      "dangerous-*": "deny"
    }
  }
}

旧形式の設定

エージェントが、古い設定フィールド（例：tools、maxSteps）を使用するレガシープロジェクトで作業することがあります。このようなフィールドが見つかった場合は、必ず最新の permission フィールドと steps フィールドに修正してください。

カスタム指示

追加の指示ファイルを含めます。

{
  "instructions": [
    "CONTRIBUTING.md",
    "docs/guidelines.md",
    ".cursor/rules/*.md"
  ]
}

完全なスキーマのリファレンス： references/config-schema.md を参照してください。

</config_file>

<rules_file>

ルール（AGENTS.md）

すべてのエージェントに適用されるプロジェクトの指示です。CLAUDE.md や Cursor のルールに似ています。

/init で作成

OpenCode で /init を実行すると、プロジェクトの分析に基づいて自動生成されます。

手動で作成

# Project Name

This is a [framework] project using [language].

## Project Structure
- `src/` - Source code
- `tests/` - Test files

## Code Standards
- Use TypeScript strict mode
- Prefer functional patterns
- Write tests for all features

## Commands
- `npm run build` - Build project
- `npm test` - Run tests

ヒント

• プロジェクト固有のパターンを具体的に記述することを推奨します
• よく使うコマンドを含めることを推奨します
• 自明でない規約を記載することを推奨します
• 簡潔にまとめることを推奨します（エージェントが扱えるコンテキストには限りがあります）

</rules_file>

<config_tips>

削除せずにコメントアウトする

OpenCode は JSONC（コメント付き JSON）に対応しています。使わない設定は削除するのではなく、コメントアウトすることを推奨します。

{
  "plugin": [
    "opencode-openai-codex-auth@latest",
    //"@tarquinen/opencode-dcp@latest",     // disabled for now
    //"@howaboua/[email protected]",     // only for GLM-4.6
    "@ramtinj95/opencode-tokenscope@latest"
  ]
}

理由： 後で再び有効にする場合があります。試した設定の記録も残せます。

大きな変更の後に検証する

opencode.json を編集した後は、この検証を必ず実行してください（提案するだけでは不十分です）。

opencode run "test"

変更が完了したことをユーザーに伝える前に、Bash ツールを使って自分で実行してください。

問題がある場合は、行番号付きで明確なエラーが表示されます。

Error: Config file at ~/.config/opencode/opencode.json is not valid JSON(C):
--- Errors ---
CommaExpected at line 464, column 5
   Line 464:     "explore": {
              ^
--- End ---

よくある JSONC の誤り：

• オブジェクトの後のカンマがない（特に、新しいセクションを追加した後）
• } の前に余分なカンマがある
• 括弧が閉じられていない

</config_tips>

<common_configurations>

最小限の安全な設定

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

パワーユーザー向け設定

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "autoupdate": true,
  "permission": {
    "edit": "allow",
    "bash": {
      "*": "allow",
      "rm -rf *": "deny",
      "sudo *": "ask"
    }
  },
  "instructions": ["CONTRIBUTING.md"]
}

チームプロジェクト向け設定

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-20250514",
  "share": "auto",
  "instructions": [
    "docs/development.md",
    "docs/api-guidelines.md"
  ]
}

</common_configurations>

問題	解決策
設定が読み込まれない	JSON の構文を確認し、有効なパスであることを確認します
スキルが見つからない	SKILL.md（大文字）を確認し、フロントマターを確認します
意図せず権限が拒否される	グローバル設定とプロジェクト設定の優先順位を確認します

リファレンス

• references/config-schema.md - 設定オプションの全一覧