6
8

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code 6月新機能 — 5段階エージェントと/cdコマンドで自律開発を実現する

6
Last updated at Posted at 2026-06-20

Claude Code の2026年6月アップデートでは、大規模エージェント開発に直結する機能が複数追加されました。本記事では、ネストサブエージェント5段階対応(v2.1.172)/cd コマンド(v2.1.169) を中心に、実際のコードと使用例でどこまで実践的に使えるかを確認します。

TL;DR

  • /cd /path コマンドでセッションを切らずにディレクトリ切り替え可能に
  • Agent ツールが最大5段階のネストに対応し、複雑な自律タスクを階層化できる
  • レート制限ヒット時にフォールバックモデルへ自動切り替えする Auto-retry 改善
  • ~/.aws 設定の自動読み込みで AWS Bedrock 利用が簡素化

/cd コマンド — マルチリポジトリ作業が劇的に楽になる

従来の課題

Claude Code でモノレポや複数リポジトリを跨ぐ作業をするとき、ディレクトリを変えるたびに cd /path && claude で新しいセッションを起動する必要がありました。これではコンテキスト(読み込んだファイル・会話履歴)が毎回リセットされ、前提知識の引き継ぎができません。

/cd の使い方

v2.1.169 以降では、セッション内で /cd コマンドを使ってディレクトリを切り替えられます。

/cd /home/user/frontend

切り替え後も会話コンテキストは維持されます。つまり「バックエンドの実装を確認した上でフロントエンドを修正する」という作業を同一セッションで完結できます。

実際のユースケース

# セッション開始: APIサーバーのソースを読む
/cd /home/user/backend
# "UserController の認証ロジックを教えて" → コンテキスト取得

# フロントエンドへ移動(コンテキストは維持)
/cd /home/user/frontend
# "先ほどのバックエンド認証に合わせて AuthProvider を修正して"

モノレポ構成(packages/api, packages/web, packages/shared)を行き来しながら横断的な修正を行う作業に特に有効です。

キャッシュ保持の仕組み

/cd はセッションが持つ ディレクトリコンテキストのみ を切り替えます。CLAUDE.md の読み込みは切り替え後のパスで再解決されるため、ディレクトリごとに異なるルールを使い分けることも可能です。


ネストサブエージェント5段階 — 大規模自律タスクの設計指針

何が変わったか

Claude Code の Agent ツールで子エージェントを起動すると、その子エージェントがさらに孫エージェントを起動できます。v2.1.172 でこのネストが 最大5段階 まで正式にサポートされました。

バージョン前 v2.1.172 以降
1〜2段ネストは動作不安定 5段まで安定動作
深いネストでコンテキスト消失 各階層でコンテキスト管理
サブエージェント間の依存が難しい 階層型オーケストレーションが可能

5段ネストの設計パターン

実際に動く多階層エージェントの設計例を示します。

# CLAUDE.md ではなく、Python スクリプトから Agent ツールを使う例
# (Claude Code のスキルファイルとして使用)

# Layer 1: オーケストレーター(全体計画)
# Layer 2: フェーズ担当エージェント(収集/分析/実装/レビュー)
# Layer 3: タスク担当エージェント(個別ファイル処理)
# Layer 4: 検証エージェント(品質チェック)
# Layer 5: 修正エージェント(自動修正)

CLAUDE.md でのスキル定義例:

## write-article スキル(階層エージェント版)

Layer 1 (Main): hourly-dispatch から起動
  → Layer 2a (Collector): ニュース収集エージェント
  → Layer 2b (Writer): 記事執筆エージェント
      → Layer 3a (FactChecker): 数値・URL検証
      → Layer 3b (FormatChecker): Zenn フォーマット検証
          → Layer 4 (AutoFixer): 検証エラーを自動修正
              → Layer 5 (Verifier): 修正後の再確認

コンテキスト管理の注意点

各エージェントはプロンプトに渡された情報以外は引き継ぎません。深いネストほどプロンプトが肥大化するため、エージェント間の情報伝達は必要最小限に絞る のが実践的なルールです。

# 悪い例: 親が子に全情報を渡す
Agent(prompt="以下の背景情報300行を読んで処理して:\n{全記事内容}\n{全検証結果}...")

# 良い例: 必要な情報のみを渡す
Agent(prompt="articles/401-foo.md のファクトチェックを実行。
  確認項目: 数値・URL・製品名の3軸。
  結果は JSON で返すこと。")

実装する前に確認すること

  • 各エージェント起動にはトークンと時間のコストがかかる
  • 5段すべてを常用する必要はない。2〜3段で大半のユースケースは対応可能
  • コスト見積もりには tools/sprint_session_metrics.py などで実測すること

Auto-retry とフォールバックモデル — レート制限への対処

従来の問題

Claude API のレート制限(Rate Limit)にヒットすると、Claude Code はエラーを出して処理を停止していました。長時間自動実行するパイプラインでは、夜間に処理が止まったまま翌朝発見するケースが頻発していました。

6月アップデートでの改善

  1. 指数バックオフ付き自動リトライ: レート制限ヒット時に自動で待機・再試行
  2. フォールバックモデル設定: 主モデルが使えない間、軽量モデルへ自動切り替え

Claude Code の settings.json では model キーでメインモデルを指定し、セッション内で /model コマンドを使って動的に切り替えることができます。

// .claude/settings.json の例
{
  "model": "claude-opus-4-8"
}

レート制限ヒット時には、手動で /model claude-haiku-4-5-20251001 と入力するか、
スクリプトレベルで複数モデルを試行する実装が実用的です。

フォールバックモデルを検討する場面の例:

  • Opus 4.8 がレート制限中 → Haiku 4.5 でファイル読み込み・整形タスクを継続
  • Sonnet 4.6 がメンテ中 → Haiku 4.5 でテスト実行・ログ確認を継続

注意点: フォールバックモデルは能力が低いため、重要な判断ロジック(テーマ選定・コードレビュー等)ではなく、機械的なタスク(ファイル変換・フォーマット修正等)にのみ使うことを推奨します。


AWS Bedrock リージョン自動読み込み

設定方法の変化

以前は Claude Code を Bedrock 経由で使う際、環境変数で明示的にリージョンを指定する必要がありました。

# 以前の設定(手動指定が必要だった)
export AWS_REGION=us-east-1
export ANTHROPIC_API_URL=https://bedrock-runtime.us-east-1.amazonaws.com/...

v2.1.172 以降は ~/.aws/config の内容を自動読み込みするため、AWS CLI を普段から使っている環境では追加設定が不要になりました。

# ~/.aws/config が自動で読まれる
[default]
region = ap-northeast-1

[profile production]
region = us-east-1

AWS_PROFILE 環境変数でプロファイルを切り替えることも可能です。


組み合わせユースケース: 自律ブログ執筆パイプライン

上記の機能を組み合わせた実際のパイプラインイメージです。

Claude Code セッション開始(/cd /repos/blog-automation)
  ↓
hourly-dispatch スキル起動
  ↓ Agent(Layer 1: オーケストレーター)
  ├─ /cd /repos/blog-automation/research
  │   Agent(Layer 2: ニュース収集エージェント)
  │     → research/news-YYYY-MM-DD.md 保存
  │
  ├─ /cd /repos/blog-automation/articles
  │   Agent(Layer 2: 執筆エージェント)
  │     Agent(Layer 3: ファクトチェック)
  │       Agent(Layer 4: 自動修正)
  │         Agent(Layer 5: 再検証)
  │
  └─ /cd /repos/blog-automation
      git add / commit / push → PR 作成

このような多段構成が5段ネストで安定動作するようになったことで、長時間・複雑な自律タスクの設計自由度が大幅に向上しました。


まとめ

機能 バージョン 主な効果
/cd コマンド v2.1.169 マルチリポジトリ作業をセッション内で完結
ネストサブエージェント5段階 v2.1.172 複雑な自律タスクを階層化して安定動作
Auto-retry+フォールバック v2.1.x レート制限による夜間停止を防止
AWS Bedrock 自動設定 v2.1.172 ~/.aws/config 読み込みで設定簡素化

Claude Code の自律度が着実に上がっており、特にネストサブエージェントとフォールバックモデルの組み合わせは長時間自動実行のパイプライン安定性に直結します。現在 Claude Code をスケジュール実行で使っている場合は、フォールバックモデル設定を追加するだけで夜間停止リスクを大幅に下げられます。

公式 Changelog: https://code.claude.com/docs/en/changelog.md


参考リンク

6
8
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
6
8

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?