メインコンテンツまでスキップ

コーディング設定

コーディングは、進行役の Coordinator LLM と、技術的な実行を担う外部 CLI Worker(OpenCode ACP)の 二層構成です。config/config.yml の coding で設定します。環境変数が設定されている場合は YAML より優先されます。

coding:
orchestrator:
provider: openai # openai | ollama | gemini | opencode_go | local
model: gpt-5.6-terra
cli:
opencode_path: /path/to/your/opencode
acp:
turn_timeout_seconds: 7200
opencode_model: opencode-go/muse-spark-1.3-contributor
opencode_models:
- opencode-go/muse-spark-1.3-contributor
設定環境変数既定
coding.orchestrator.providerCODING_ORCHESTRATOR_PROVIDERopenai
coding.orchestrator.modelCODING_ORCHESTRATOR_MODELgpt-5.6-terra
coding.cli.opencode_pathCODING_OPENCODE_CLI_PATHopencode(PATH 上)
coding.acp.turn_timeout_secondsCODING_ACP_TURN_TIMEOUT_SECONDS7200(2時間)
coding.acp.opencode_modelCODING_OPENCODE_MODELopencode-go/muse-spark-1.3-contributor
coding.acp.opencode_modelsCODING_OPENCODE_MODELS(カンマ区切り)opencode_model の 1 件

ターン制限時間とタイムアウト(timed_out)​

  • coding.acp.turn_timeout_seconds(CODING_ACP_TURN_TIMEOUT_SECONDS)で ACP session/prompt の 1 ターンあたりの上限時間を秒数で設定します(既定: 7200秒=2時間)。
  • 制限時間は1回の ACP ターン単位に適用され、HITL ユーザー確認待機や Coordinator による次ターンでは別枠でタイマーが再開されます。
  • 正の数(> 0)のみ受け付け、0以下や非数値は起動時/設定読み込み時に明示的にエラーとなります。変更の反映には Web サービスの再起動が必要です。
  • ユーザーによる明示的な取り消しは cancelling → cancelled となり、時間上限到達時は session/cancel を1回送信して独立した終端状態 timed_out に移行します。
  • timed_out 発生時は実行中ツール呼び出しを interrupted(理由: 時間上限到達)に更新し、failure カテゴリの通知(「時間上限到達」)を配信します。
  • Task Agent の coding_cli 子 run が timed_out となった場合、ユーザー取消ではなく実行失敗として上位 Task に伝播します。

Coordinator の役割​

  • Coordinator は進捗・質問・最終要約だけを扱います。
  • リポジトリ調査・実装・テスト・技術判断は Worker が担います。
  • Coordinator は応答本文に <cli_request> を出力して委譲し、アプリが Worker を実行して結果を次の観測として返します。
  • Coordinator がツール経由で外部 CLI を起動することはなく、バックエンド名は開示されません。

Worker(OpenCode ACP)のモデルと reasoning effort​

  • Worker は opencode acp(stdio)をサブプロセスとして起動します。起動引数はインストール済み CLI のメジャーバージョンに合わせて自動で切り替わるため、v1 系・v2 系のどちらでも設定変更は不要です。
  • 使用モデルは毎ターンの prompt 前に ACP の session/set_config_option(configId: "model")で固定されます。拒否された場合、そのターンは失敗します。
  • モデルが reasoning effort(カテゴリ thought_level)を広告する場合、max → xhigh → high → medium → low の優先順で最初に利用できる値を同じく session/set_config_option で設定します。広告がない、または優先順の値がない場合は OpenCode の既定値で実行し、診断に広告値と未対応理由を記録します。設定が拒否された場合はフォールバックせず、そのターンを失敗させます。
  • セッション作成時・ステータスバーで選択できるモデルは opencode_models の許可リストに限られ、自由入力は拒否されます。

セッションごとのオーケストレーター LLM​

  • オーケストレーター(進行役)のプロバイダーとモデルは 会話設定 ⚙ ダイアログで会話ごとに変更できます。
  • 未設定(「既定を使用」)の場合、そのセッションは coding.orchestrator.provider / coding.orchestrator.model の既定値を使用します。
  • 変更は次回送信(次の run)から反映されます。実行中の run は開始時に固定した値を使い続けます。
  • プロバイダーは対応するもの(openai / gemini / ollama / local / opencode_go)から選択し、モデルは自由入力です。

バックエンド​

コーディングは ACP 一本化(OpenCode のみ) です。 旧 Direct CLI(Codex / OpenCode run)と Codex バックエンドは削除済みで、 既存の Direct CLI / Codex セッションは読み取り専用です。新しい実行には OpenCode ACP の新規セッションが必要です。

トラブルシューティング​

  • Coordinator が応答しない / 委譲しない — coding.orchestrator のプロバイダ・モデルと資格情報を確認します。
  • Worker が起動しない — coding.cli.opencode_path が実行可能な opencode を指しているか、PATH が通っているか確認します。
  • 実行直後に initialize のタイムアウトで失敗する — OpenCode CLI の更新で起動引数が変わった可能性があります。実行結果のエラーメッセージに子プロセスの終了コードと stderr(例: Unrecognized flag)が出る場合は、CLI のバージョンと opencode acp --help の内容を確認してください。
  • モデル変更が反映されない — モデル変更は 次回送信から 適用されます。また許可リスト外のモデルは拒否されます。

次に読む​