QR Send

スマホとPCのChrome間で、URLやテキストをQRコード1回のペアリングで送り合える自作Chrome拡張。アカウント不要・無料。

使ってみる →

Claude CodeのBashが突然拒否される:claude -pとAgent SDKはpermission-modeを渡す

AI活用

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を確認してください。

無人実行は、許可を広げるより先に操作を小さくする。これで「設定は合っているのにコマンドだけ動かない」という切り分けがかなり楽になります。

出典: Claude Code Troubleshooting / Permission modes

コメント

タイトルとURLをコピーしました