Claude CodeにBashを実行させるための設定は合っているはずなのに、claude -pやAgent SDKから呼び出すとツール実行だけ拒否されることがあります。
設定ファイルを何度も見直して、それでも動かない。これは設定の細かい書き間違いではなく、無人実行の開始モードが原因かもしれません。
対話セッションと無人実行は同じではない
普段のターミナルでClaude Codeを起動し、質問に答えながらBashを実行する場合は、必要に応じて許可を確認できます。
ところがclaude -pやAgent SDKのような非対話実行では、そもそも許可を答える人がいません。公式トラブルシューティングにも、--permission-mode、permissionMode、permission_modeを渡していない非対話実行では、ツール呼び出しが拒否されることがあると書かれています。
まずpermission-modeを明示する
CLIから実行しているなら、起動時に許可モードを明示します。
claude -p "テストを実行して結果をまとめて" --permission-mode acceptEdits
許可モードの名前を適当に決めないことが大事です。自分の作業に必要な範囲を確認して、公式のPermission modesにある値を使ってください。
読み取りだけの処理なら、書き込みを許可するモードを選ぶ必要はありません。逆にテスト実行やファイル更新をさせるなら、許可が足りないモードでは途中で止まります。
Agent SDKでは設定名が違う
Agent SDKから呼び出す場合は、CLIの--permission-modeをそのまま書くのではなく、SDK側のオプション名を使います。
const result = await query({
prompt: "テストを実行して結果をまとめて",
options: {
permissionMode: "acceptEdits"
}
});
別の設定ファイルやラッパーを挟む場合は、さらにpermission_modeという名前へ変換されることもあります。ここは「CLIでは動くのにSDKでは動かない」原因になりやすいところです。
Bashだけ拒否される時の切り分け
では、どこまで動いているかを小さく確認してみましょう。
claude -p "現在のディレクトリ名だけ表示して" --permission-mode default
このような簡単な処理でもツール呼び出しが拒否されるなら、Bashのコマンド内容より先に起動モードを疑います。
permission-modeを指定しても拒否される場合は、設定ファイル、管理者ポリシー、利用しているSDKとClaude Codeのバージョンを確認します。許可モードを指定したからといって、組織ポリシーを無視できるわけではありません。
無人実行では「許可を待たない」設計にする
無人のタスクで対話用の許可確認を残すと、処理は人が答えるまで進みません。設定を広げて解決するのではなく、実行する操作を先に絞り、その範囲に合ったpermission-modeを明示するのが安全です。
私は無人タスクを作る時、まず読み取りだけのコマンドで動作を確認します。その後に必要な書き込みやテスト実行を一つずつ足します。最初から何でも許可すると、どの操作で止まったのか分からなくなります。
まとめ
claude -pやAgent SDKでBashが突然拒否される時は、設定ファイルだけを見直しても解決しないことがあります。
非対話実行では、CLIなら--permission-mode、SDKならpermissionMode、ラッパーの設定ならpermission_modeを確認してください。
無人実行は、許可を広げるより先に操作を小さくする。これで「設定は合っているのにコマンドだけ動かない」という切り分けがかなり楽になります。

コメント