English 中文 العربية 日本語 Português

OpenCode: OpenCode Agent Mode

最終更新：2026-08-31

--- title: OpenCodeエージェント（Agent） description: OpenCodeのエージェントシステムを深く理解する。内蔵エージェント、カスタムエージェント、メインエージェントとサブエージェントの設定と使用を含む order: 13 lang: ja

エージェントはOpenCodeの専門化されたAIアシスタントで、それぞれ独立したプロンプト、モデル、ツール、権限を設定可能です。

1. 学習内容

2. エージェントのタイプ

タイプ 説明 切り替え方法
メインエージェント（primary） 直接インタラクションするメインアシスタント Tabキー
サブエージェント（subagent） メインエージェントから呼ばれる専門アシスタント @エージェント名または自動呼び出し

3. 内蔵エージェント

エージェント タイプ 説明
Build メイン デフォルトのメインエージェント、全ツール有効
Plan メイン 分析・計画専用、edit/bashはaskに設定
General サブ 全ツール権限あり、ファイル修正可能
Explore サブ 読み取り専用、ファイル修正不可

システムエージェント（非表示）：Compaction、Title、Summary

4. エージェントの切り替えと呼び出し

5. カスタムエージェント設定

JSON設定：

JSON 
{
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices",
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-4-20250514",
      "prompt": "You are a code reviewer. Focus on security and performance.",
      "tools": { "write": false, "edit": false }
    }
  }
}

Markdownファイル：

~/.config/opencode/agents/（グローバル）または.opencode/agents/（プロジェクト）に配置。ファイル名がエージェント名になります。

6. 設定オプション

オプション 説明
description エージェント機能の説明（必須）
mode primary / subagent / all
model モデル指定（provider/model-id）
prompt システムプロンプト、{file:./path}対応
temperature 出力のランダム性（0.0-1.0）
steps 最大イテレーション数
tools ツールアクセス権限
permission きめ細かい権限制御
hidden @メニューから非表示
color UI表示色
disable エージェントを無効化

7. クイック作成

BASH 
opencode agent create

インタラクティブなガイド付きエージェント作成。

❓ FAQ

Q BuildではなくPlanエージェントを使うべき時は？
A AIに分析とアドバイスを求めるが、ファイルを修正してほしくない場合。Planのedit/bash権限はaskに設定されているため、直接実行しない。
Q サブエージェントはサブエージェントを呼び出せますか？
A はい、Taskツール経由で可能。ただし循環呼び出しは避けること。permission.taskで制御可能。

📖 まとめ

📝 練習問題

  1. 基本問題：TUIでTabキーを使ってBuildとPlanエージェントを切り替え、違いを体験してください。

  2. 応用問題：読み取り専用のコードレビューエージェントを作成し、低いtemperatureと適切なツール権限を設定してください。

  3. チャレンジ問題：メインエージェント＋複数サブエージェントを含むエージェント体系を設計し、完全なプロジェクト開発フローに対応してください。

Web-Tutorial.com

Web-Tutorial 技術チーム

複数の開発者によって共同維持されているプログラミングチュートリアルプラットフォーム。各チュートリアルは専門分野の開発者が執筆・レビューしています。正確で信頼性の高いコンテンツを目指しています — 問題を見つけた場合はお知らせください。

100%