権限の設定

​

権限がどのように評価されるか

• permissionMode: 'bypassPermissions'。これは permission モードステップに到達するすべての呼び出しを自動承認します。ただし、どのモードも自動承認しないアクション は除きます。
• "Read" などの各裸の allowedTools エントリ。これはコールバックが相談される前にそのツール全体を自動承認します。ただし、どのモードも自動承認しないアクション および ネットワークパスからの読み取り は除きます。

• Hooks： ツールリクエストを許可、拒否、または変更するカスタムコードを実行します。実行を Hook で制御する を参照してください。
• canUseTool コールバック： 前のステップで呼び出しが解決されない場合、実行時にユーザーの承認をプロンプトします。承認とユーザー入力を処理する を参照してください。

​

許可ルールと拒否ルール

const options = {
  allowedTools: ["Read", "Glob", "Grep"],
  permissionMode: "dontAsk"
};

​

権限モード

• セッションの 設定ファイル から permissions.defaultMode が適用される場合
• それ以外の場合は、自動モード である可能性がある組み込みデフォルト

​

利用可能なモード

​

権限モードを設定する

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    async for message in query(
        prompt="Help me refactor this code",
        options=ClaudeAgentOptions(
            permission_mode="default",  # Set the mode here
        ),
    ):
        if hasattr(message, "result"):
            print(message.result)


asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";

async function main() {
  for await (const message of query({
    prompt: "Help me refactor this code",
    options: {
      permissionMode: "default" // Set the mode here
    }
  })) {
    if ("result" in message) {
      console.log(message.result);
    }
  }
}

main();

import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions


async def main():
    async with ClaudeSDKClient(
        options=ClaudeAgentOptions(
            permission_mode="default",  # Start in default mode
        )
    ) as client:
        await client.query("Help me refactor this code")

        # Change mode dynamically mid-session
        await client.set_permission_mode("acceptEdits")

        # Process messages with the new permission mode
        async for message in client.receive_response():
            if hasattr(message, "result"):
                print(message.result)


asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";

async function main() {
  const q = query({
    prompt: "Help me refactor this code",
    options: {
      permissionMode: "default" // Start in default mode
    }
  });

  // Change mode dynamically mid-session
  await q.setPermissionMode("acceptEdits");

  // Process messages with the new permission mode
  for await (const message of q) {
    if ("result" in message) {
      console.log(message.result);
    }
  }
}

main();

​

モードの詳細

​

編集受け入れモード（acceptEdits）

• ファイル編集（Edit、Write ツール）
• ファイルシステムコマンド：mkdir、touch、rm、rmdir、mv、cp、sed

• そのスコープ外のパスで作業する
• 保護されたパスに書き込む
• rm または rmdir で 重要なパス を削除する

​

質問しないモード（dontAsk）

​

権限バイパスモード（bypassPermissions）

​

計画モード（plan）

​

auto モード（auto）

• 表示される内容：subtype が status で、permissionMode が "default" に設定された system メッセージです。TypeScript SDK ではこれを SDKStatusMessage として型付けしています。それ以降、承認が必要で許可ルールに一致しないコールは canUseTool コールバックに到達します。
• auto モードに戻すには：サポートされているモデルに切り替えてから、set_permission_mode("auto") または setPermissionMode("auto") を呼び出します。この呼び出しを行わずにモデルを元に戻した場合、セッションは default モードのままです。サポートされていないモデルがアクティブな間は、この呼び出しは Cannot set permission mode to auto: auto mode unavailable for this model で失敗します。

​

関連リソース

• 承認とユーザー入力の処理：インタラクティブな承認プロンプトと確認質問
• Hooks ガイド：エージェントライフサイクルの重要なポイントでカスタムコードを実行
• 権限ルール：settings.json の宣言的な許可/拒否ルール