原文(日本語に翻訳)
--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に組み込まれたエージェント)でも同様に機能する