Skip to content

原文(日本語に翻訳)

--agent <name> がビルトインエージェントの permissionMode を尊重するようになった

原文(英語)

--agent <name> now honors the agent definition's permissionMode for built-in agents

概要

--agent <name> フラグでエージェントを指定して起動する際、エージェント定義のフロントマターに記載された permissionMode が正しく適用されるようになった。エージェントごとに適切な権限モードを設定しておくことで、安全で意図した動作を保証できる。

基本的な使い方

エージェント定義ファイルのフロントマターで permissionMode を設定:

yaml
# .claude/agents/safe-agent.md
---
name: safe-agent
description: 安全な読み取り専用エージェント
permissionMode: plan
---

読み取り専用の操作のみを実行するエージェントです。

起動時に自動的に permissionMode: plan が適用される:

bash
claude --agent safe-agent

実践例

各permissionModeの使い分け

モード動作適したユースケース
default危険な操作前に確認を求める一般的な開発作業
acceptEditsファイル操作を自動承認積極的にコードを書くエージェント
plan読み取り専用操作のみ分析・レビュー専用エージェント
bypassPermissionsすべてのツール使用を自動承認完全自動化(慎重に使用)

安全な分析エージェント(planモード)

yaml
# .claude/agents/code-analyzer.md
---
name: code-analyzer
description: コード分析専用(変更なし)
permissionMode: plan
tools: [Read, Grep, Glob]
---

コードを読み込んで分析します。ファイルの変更は一切行いません。
bash
# 安全にコード分析を実行
claude --agent code-analyzer "アーキテクチャの問題点を教えてください"

積極的なコード編集エージェント(acceptEditsモード)

yaml
# .claude/agents/auto-fixer.md
---
name: auto-fixer
description: 自動修正エージェント(ファイル編集を自動承認)
permissionMode: acceptEdits
---

コードの問題を自動的に修正します。
bash
# ファイル編集の確認プロンプトなしで実行
claude --agent auto-fixer "ESLintエラーをすべて修正してください"

完全自動化エージェント(bypassPermissionsモード)

yaml
# .claude/agents/ci-agent.md
---
name: ci-agent
description: CI/CD用完全自動化エージェント
permissionMode: bypassPermissions
---

CI環境での完全自動化実行に使用します。
bash
# CI/CDパイプラインでの使用(権限確認なし)
claude --agent ci-agent --print "テストを実行して結果を報告してください"

注意点

  • bypassPermissions モードはすべての権限確認をスキップするため、本番環境での使用には十分注意が必要
  • permissionMode はエージェント定義のフロントマターで設定するため、ファイルの管理・バージョン管理が容易
  • コマンドライン引数での権限設定よりもエージェント定義が優先される場合がある
  • ビルトインエージェント(Claude Codeに組み込まれたエージェント)でも同様に機能する

関連情報