Dynamic Workflowsを安全に動かす設定例｜
Claude CodeのUltracode・Hooks・Subagentsの始め方

Claude CodeのDynamic Workflowsは、AIに大きな仕事を任せるための強力な仕組みです。公式ドキュメントでは、Claudeがタスクに合わせてworkflow scriptを書き、ランタイムがバックグラウンドでsubagentsを動かす仕組みだと説明されています。

ただし、仕事で使うときに大事なのは「何体まで動かせるか」だけではありません。どの権限を渡すか、どこで止めるか、誰が確認するか。この記事では、Dynamic Workflowsを安全に試すための設定例を、初心者向けに整理します。

Dynamic Workflowsは「AIの作業手順をコード化する」仕組み

Dynamic Workflowsを一言でいうと、AIに任せる作業手順をClaudeがJavaScriptのworkflowとして組み立て、複数のsubagentsに分担させる仕組みです。人間が毎回「次はこれ、次はこれ」と指示する代わりに、作業の分岐や繰り返しをworkflow側が持ちます。

公式ドキュメントでは、1回のrunで合計1,000 agentsまで、同時実行は最大16 agentsまでと説明されています。ただしこれは上限です。普段から最大値を狙うより、まずは人が確認しやすい調査やレビューで試す方が安全です。

まず確認する前提設定は4つ

Dynamic Workflowsは、古いClaude Codeでは表示されない場合があります。まずはバージョン、設定画面、effort、進捗確認の4点を見ます。

claude update
claude

# Claude Code内で確認
/config
/effort ultracode
/workflows

Project設定例：最初は権限を狭くする

自律運用で最初に決めたいのは「AIに何を許可し、何を許可しないか」です。Claude Codeのsettingsは、User、Project、Localなどのscopeに分かれています。チームで共有する設定はProject、個人PCだけの設定はLocalに分けると扱いやすくなります。

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "permissions": {
    "allow": [
      "Read(./**)",
      "Bash(npm run build)",
      "Bash(npm run test *)",
      "Bash(git status *)",
      "Bash(git diff *)"
    ],
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Bash(rm -rf *)",
      "Bash(git push *)"
    ]
  }
}

この例は考え方を示すものです。実際のプロジェクトでは、使っているpackage manager、テストコマンド、デプロイ方法に合わせて調整します。迷ったら、最初はread-onlyに近い設定から始めるのが安全です。

Subagents設定例：調査係とレビュアーを分ける

Subagentsは、役割別のAI担当者です。公式ドキュメントでは、それぞれが別のcontext、system prompt、tool access、permissionsを持てると説明されています。Dynamic Workflowsでは、この役割分担が効いてきます。

---
name: reviewer
description: 変更後の差分を批判的に確認し、リスク・テスト漏れ・権限の広げすぎを指摘するレビュアー。
---

あなたは敵対的レビュアーです。
成果を褒める前に、壊れそうな点、根拠不足、テスト不足、秘密情報の混入を探してください。
最後に「人間が確認する項目」を3つ出してください。

初心者は、まずClaude Codeの /agents 画面から作るのがわかりやすいです。Markdownファイルを直接書く場合も、最初は「調査だけ」「レビューだけ」のように狭い役割にします。

Hooks設定例：自動化より先に「止める・知らせる・整える」

Hooksは、Claude Codeの特定のタイミングで自動処理を走らせる仕組みです。編集後にformatterを走らせる、通知を出す、危険な操作の前に止める。こうした決まりきった処理は、AIの判断に任せるよりhook化した方が安定します。

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npm run format --if-present"
          }
        ]
      }
    ]
  }
}

初心者は3段階で始める

Dynamic Workflowsは、いきなり本番の大規模修正に使うより、結果を人が確認しやすい仕事から始める方が向いています。まずは「壊しても戻せる」「読めば正誤がわかる」作業に限定します。

この順番なら、AIが何をしているかを追いやすくなります。調査で使い方に慣れ、レビューで観点を育て、最後に小さな修正へ進む。これだけでも、自律運用の失敗はかなり減ります。

慎重に扱いたい作業を先に決めておく

AIに任せる範囲を広げるほど、「やらないこと」の設定が大切になります。特に本番反映、顧客情報、金額、契約、削除操作は、AIの自律判断だけで進めない方が安全です。

i-Styleでは、AIに任せること自体よりも、AIが安全に動ける仕事場を整えることが先だと見ています。モデルの性能が上がるほど、権限、確認、停止条件の設計が大切になります。

よくある質問

まとめ

• check_circleDynamic Workflowsは、AIの作業手順をworkflowとして動かす仕組みです
• check_circleUltracodeは重い仕事向けで、普段使いではなく使い分けが必要です
• check_circlesettingsでは、まず秘密情報と本番反映を守る権限設計をします
• check_circleSubagentsは役割分担、Hooksは自動チェックとして使い分けます
• check_circle最初は調査、レビュー、小さな修正の順に始めると安全です