# Claude Agent SDKの便利だけど知られていない機能
🌍 コードを変更せずに計画だけ立ててほしい?planモードなら読み取り専用でClaudeが分析・提案します!
Claude Agent SDKのplanモードは、ソースファイルを一切編集せず、読み取り専用ツールだけでコードを探索し、変更計画を立てるモードです。
📌 タイトル:plan モード(読み取り専用のみ実行)
🔗 URL:
🧩 概要
`permission_mode="plan"` を設定すると、Claudeは読み取り専用ツール(Read、Grep、Globなど)と読み取り専用のシェルコマンドだけを使ってコードベースを探索します。Edit、Write、Bashでの書き込み操作は実行されません。要件の明確化が必要な場合は `AskUserQuestion` を使ってユーザーに質問することもあります。コードレビューや変更提案を安全に行いたい場面で最適です。
🛠 使い方
```python
# Python - コードレビュー用のplanモード
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="認証モジュールのセキュリティ問題を分析し、改善計画を提案してください",
options=ClaudeAgentOptions(
permission_mode="plan", # 読み取り専用で分析
),
):
if hasattr(message, "result"):
print(message.result)
```
```typescript
// TypeScript
for await (const message of query({
prompt: "Analyze security issues in the auth module and propose a fix plan",
options: {
permissionMode: "plan" // Read-only analysis
}
})) {
if ("result" in message) console.log(message.result);
}
```
🏗 本番システムへの組み込み方
・プルリクエストの自動レビューで、コードを変更せず問題点と改善案だけを提示します
・新しいコードベースの調査・理解フェーズで安全に探索できます
・変更を実行する前の「計画フェーズ」として、人間が計画を確認してから実行モードに切り替える運用ができます
・`set_permission_mode()` と組み合わせて、計画承認後に `acceptEdits` に切り替えるワークフローが構築できます
💡 ユースケース
📋 コードレビューで変更提案だけを生成し、実際の変更は人間が判断する
🔍 大規模コードベースのアーキテクチャ分析を安全に行う
📝 リファクタリング計画を立てて、チームで合意してから実行する
⚠️ 注意点
・読み取り専用のシェルコマンドは実行される場合があります
・`AskUserQuestion` が発生する可能性があるため、完全な無人実行にはdontAskモードの方が適しています
・計画結果を実行に移す場合は、新しいセッションまたは権限モードの動的変更が必要です
✨ 「まず計画、次に実行」のワークフローはエンジニアリングの基本です。planモードで安全に分析し、納得してから変更を実行しましょう!
#
ClaudeAgentSDK# #
AIAgent#