クライアント連携上級者向け更新日

Claude Code の自動化設定:確認と待ち時間を減らす

permissions.defaultMode を auto に設定し、さらに Bash のタイムアウトとワークスペースディレクトリを設定しておくと、Claude Code が大半のツール呼び出しを自分で判断し、本当に判断が必要な場面でだけ止まるようになります。本ページでは ~/.claude/settings.json にそのままコピーして使える設定を示し、各項目がどのような実務上の問題を解決するのかを説明します。

設定が影響するのはクライアントの動作だけで、モデルの性能、課金ルール、API Key の権限は変わりません。クライアントをまだインストールしていない場合は、先に Claude Code インストールガイド に沿ってインストールとキーの設定を済ませ、その後で本ページに戻って使い勝手を調整してください。

まず「引っかかり」を三つに分けて考える

つらいのは確認を何度も求められることだと考えられがちですが、実際に調べてみると、時間がかかる原因は多くの場合ほかの三か所にあります。設定を全部まとめて写すより、まず原因を特定してから変更するほうが効果的です。

症状実際の原因対応する設定
コマンドごとに数秒待たされる自動モードの判定が毎回実行されるallow ルールでよく使うコマンドの判定を省く
コマンドの途中でタイムアウトになるBash の既定タイムアウトは 120 秒、上限は 600 秒BASH_DEFAULT_TIMEOUT_MS
プロジェクト外のファイルを読むときに再度確認されるパスが作業ディレクトリ内にないadditionalDirectories

このうち最初の項目がとくに重要です。allow ルールに一致したツール呼び出しは判定フローに入らないため、ルールを追加すると確認の回数と待ち時間の両方が減ります。最も効果の高い調整です。

設定早見表

次の内容を ~/.claude/settings.json に書き込みます。<山括弧> で囲まれた部分は自分の値に置き換えてください。設定ファイルは // コメントを受け付けます。お使いのバージョンが受け付けない場合は、コメントを削除して純粋な JSON として保存してください。

json
{
  "permissions": {
    "defaultMode": "auto",
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(git log *)"
    ],
    "deny": [
      "Read(//home/<ユーザー名>/.ssh/**)"
    ],
    "ask": [
      "Bash(git push --force*)",
      "Bash(git reset --hard*)",
      "Bash(rm -rf*)"
    ],
    "additionalDirectories": [
      "/home/<ユーザー名>/deploy"
    ]
  },
  "env": {
    "BASH_DEFAULT_TIMEOUT_MS": "300000",
    "BASH_MAX_TIMEOUT_MS": "1800000"
  }
}

当サイトの Claude Code 接続を使う場合、env の ANTHROPIC_AUTH_TOKEN、ANTHROPIC_BASE_URL、モデル変数は DeepSeek 接続ガイド または該当モデルのページに従って設定してください。本ページの BASH_* の項目とは混同しないでください。

項目ごとの説明

permissions.defaultMode を auto にすると、新しいセッションはそのまま自動モードで開始され、ツール呼び出しごとの許可・拒否をクライアントが判断します。対話画面で Shift + Tab を押して切り替えることも、起動時に claude --permission-mode auto を指定することもできます。

permissions.allow は狭いものから広いものまで指定できます。たとえば Bash(git status)、Bash(go test *) です。広いルールには代償がある点に注意してください。Bash(bash *)、Bash(ssh *)、Bash(curl *) のような書き方は「任意のコマンド実行を許可する」のに近い効果があり、判定も完全に省略されます。広いルールが本当に必要な場合は、必ず deny または ask で補ってください。

permissions.deny と permissions.ask の優先順位は deny が ask より高く、ask が allow より高いため、広い allow ルールを上書きできます。deny は無条件の拒否、ask は allow に一致しても必ず確認を求める設定です。認証情報のディレクトリは deny に、破壊的なコマンドは ask に入れることをおすすめします。

additionalDirectories は、作業ディレクトリの外にありながら頻繁に読み書きするパスを登録するための設定です。登録がない場合、ワークスペース外のファイルを初めて読むときに追加の確認が入ります。

BASH_DEFAULT_TIMEOUT_MS と BASH_MAX_TIMEOUT_MS の既定値はそれぞれ 120 秒と 600 秒です。コンパイル、ビルド、複数マシンにまたがる操作は上限に達しやすく、タイムアウトすると処理を最初からやり直すことになります。例では 5 分と 30 分に緩めています。実際の作業時間に合わせて調整してください。

安全ルールを判定より確実にする

自動モードの判断はモデルが行うため、確率的な結論にすぎません。一方、フック(hook)は決定的なルールです。これまでに経験した問題をフックとして書いておけば、モデルが毎回それを思い出すことに頼らずに済みます。

フックスクリプトは単純な取り決めに従います。終了コード 0 は許可、終了コード 2 はブロックして標準エラーの内容をモデルに返します。スクリプトは決してクラッシュしてはいけません。一度の例外ですべてのコマンドが止まってしまうため、全体を例外処理で包み、そのうえで許可するようにしてください。

python
#!/usr/bin/env python3
"""コマンド実行前チェック:0 で許可、2 でブロックして理由を返します。"""
import json, re, sys


def main():
    try:
        payload = json.load(sys.stdin)
        if payload.get("tool_name") != "Bash":
            sys.exit(0)
        cmd = (payload.get("tool_input") or {}).get("command") or ""
        if re.search(r"\brm\s+-rf\s+/(\s|$)", cmd):
            sys.stderr.write("BLOCKED: ルートディレクトリの削除を拒否しました\n")
            sys.exit(2)
    except SystemExit:
        raise
    except Exception:
        pass
    sys.exit(0)


if __name__ == "__main__":
    main()

保存したら、settings.json に絶対パスを登録します。

json
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [{ "type": "command", "command": "/绝对路径/guard-bash.py" }]
      }
    ]
  }
}

フックに書くのに適した典型的な場面は、ルートディレクトリの削除やワイルドカードによる削除、本番データベースに対する削除・全消去のステートメント実行、コマンドラインへのキーの直接記述です。

変更が反映されたか確認する

変更後は一時的なセッションで確認します。作業中のセッションを変更する必要はありません。

bash
claude --permission-mode auto --debug-file /tmp/cc.debug -p 'echo hi'
grep -E 'verifyAutoModeGateAccess|Skipping auto mode classifier|classifier_request_finished' /tmp/cc.debug

canEnterAuto=true は自動モードが利用可能であることを示します。Skipping auto mode classifier が現れていれば、そのコマンドは allow ルールに一致して判定が省略されたことを意味します。durationMs の値は、まだルールでカバーされていないコマンドによって生じた待ち時間です。

よくある二つの誤解

一つ目は、自動モードは安全境界ではないという点です。その判断は設定したモデル上で実行されます。利便性のための機能と考え、安全性は deny、ask のルールとフックに委ねてください。

二つ目は、標準外のモデル名がコンテキスト圧縮に影響するという点です。クライアントがモデル名を認識できないと、警告を表示したうえで想定したウィンドウサイズで自動圧縮を実行します。実際のウィンドウがもっと小さいと圧縮がなかなか発動せず、最終的にリクエストが失敗することがあります。対処法は CLAUDE_CODE_MAX_CONTEXT_TOKENS を設定するか、modelPicker の該当行に behavesAs を追加して実際のウィンドウ値を入れることです。誤った値を入れるのは、入れないより悪い結果になります。

おすすめの調整順序

まず defaultMode と Bash のタイムアウトだけを追加し、一週間ほど使ってみてください。次に /permissions で拒否された記録を確認し、頻度が高く安全なコマンドを allow に追加します。そのあと deny と ask で補い、フックと広いルールは最後に検討します。一度に変更すると問題の出どころが分かりにくくなります。段階的に調整すれば、どの項目が実際に待ち時間を解消したのかが明確になります。

設定後も認証や接続のエラーが頻発する場合は 接続と復旧 を参照してください。アカウント、残高、使用量については 料金・残高・使用量 を参照してください。