モード
モードは異なるワークフロー向けにopencodeの動作をカスタマイズします。特定のユースケースに対してモデル選択、温度、プロンプト、ツールアクセスを設定できます。
組み込みモード
Build モード
標準的な開発作業のための完全なツールアクセスを持つデフォルトモード。すべてのツールが有効になっています。
Plan モード
計画と分析のために設計された制限付きモード。以下のツールはデフォルトで無効になっています:
writeeditpatchbash
セッション中に Tab キーを使用してモードを切り替えます。
設定オプション
| オプション | 用途 |
|---|---|
model | デフォルトのAIモデルをオーバーライド |
temperature | レスポンスのランダム性(0.0-1.0) |
prompt | ファイル参照によるカスタムシステム指示 |
tools | 特定の機能の有効化/無効化 |
利用可能なツール
bash- シェルコマンドを実行edit- 既存のファイルを編集write- 新しいファイルを作成read- ファイル内容を読み取りgrep- ファイル内容を検索glob- パターンでファイルを検索list- ディレクトリ内容を一覧表示patch- パッチを適用todowrite- TODOリストに書き込みtodoread- TODOリストを読み取りwebfetch- Webコンテンツを取得
設定方法
JSON 設定
opencode.json に追加:
{
"agent": {
"debug": {
"mode": "primary",
"model": "anthropic/claude-sonnet-4",
"temperature": 0.2,
"tools": {
"write": false,
"edit": false
}
}
}
}Markdown 設定
.opencode/mode/(プロジェクトレベル)または ~/.config/opencode/mode/(グローバル)にファイルを作成:
---
description: Debug mode for investigation
mode: primary
temperature: 0.2
tools:
write: false
edit: false
---
You are in debug mode. Focus on investigating issues without making changes.一般的なユースケース
コードレビューモード
{
"agent": {
"review": {
"mode": "primary",
"description": "Reviews code for quality and security",
"tools": {
"write": false,
"edit": false,
"bash": false
}
}
}
}ドキュメントモード
{
"agent": {
"docs": {
"mode": "primary",
"description": "Writes and updates documentation",
"model": "anthropic/claude-sonnet-4",
"temperature": 0.3
}
}
}リファクタリングモード
{
"agent": {
"refactor": {
"mode": "primary",
"description": "Refactors code with careful analysis",
"temperature": 0.1
}
}
}モードの切り替え
- Tab キーを押してプライマリモードを循環
- 設定されたキーバインドで直接アクセス
- モードは変更されるまでセッション内で維持されます