Claude Codeの​設定と​権限の​基本:Claude認定試験の​全冠(No.08)

本文

エレノア代表の​豊島と​申します。

Claude Codeに、​本番の​環境の​鍵を​書いた​ファイルを​読ませない​設定をしていますか?

本記事は、Architect – Professionalの​出題範囲と​対策(No.07)に​続く連載の​記事です。​今回は、​試験の​準備で​身に​付く知識として、Claude Codeの​設定と​権限の​基本を​ご紹介いたします。​内容は、2026年10月27日​時点の​公式文書に​基づいております。

本記事の​内容

  • 設定ファイルの​置き場所と​優先の​順番
  • 権限の​規則​(allow・​ask・​deny)の​評価の​順番
  • 指示の​ファイルと、​危ない​操作を​止める​フック

設定ファイルの​置き場所と​優先の​順番

Claude Codeの​設定ファイルは​4種類で、​組織の​管理の​設定が​最も​優先されます。​優先の​順番は、​組織の​管理、​コマンドラインの​指定、​プロジェクトの​個人、​プロジェクトの​共有、​ユーザーの​順です。

  • 組織の​管理:managed-settings.jsonなど。​管理者が​配り、​利用者は​上書きできない
  • プロジェクトの​共有:.claude/settings.json。​リポジトリに​含めて​チームで​共有する
  • プロジェクトの​個人:.claude/settings.local.json。​自分だけの​例外を​置く
  • ユーザー:~/.claude/settings.json。​自分のすべての​プロジェクトに​適用される

許可の​一覧のような​配列の​設定は、​上書きされずに​合わせて​使われます。​チームの​決まりは​共有の​設定に、​個人の​例外は​個人の​設定に​書き分けます。

権限の​規則​(allow・​ask・​deny)の​評価の​順番

権限の​規則は、deny(禁止)、ask(確認)、allow(許可)の​順に​評価され、​最初に​当てはまった​規則で​結果が​決まります。​公式文書の​例は、​次のとおりです。

"allow": [
  "Bash(npm run lint)",
  "Bash(npm run test *)"
],
"deny": [
  "Read(./.env)",
  "Read(./.env.*)"
]

この​設定では、​テストの​コマンドは​確認なしで​実行され、.envの​ファイルは​読み取れません。denyの​規則に​当てはまる​操作は、allowの​規則を​書いても​許可されません。

ただし、​規則は​コマンドの​書き方を​照合するもので、​別の​書き方で​実行される​コマンドまでは​止められません。​公式文書は、​確実に​止める​手段として​サンドボックス​(実行できる​範囲を​区切る仕組み)を​挙げています。

権限の​モード

権限の​モードは、​確認の​求め方を​切り替える​設定です。​主な​モードは、​次のとおりです。

  • default:​ファイルの​読み取り以外は、​実行の​前に​確認する
  • acceptEdits:​ファイルの​編集を、​確認なしで​実行する
  • plan:​調査と​計画の​作成だけを​行い、​編集はしない
  • bypassPermissions:​確認をすべて​省く。​コンテナなどの​隔離された​環境でだけ​使う

denyの​規則は、bypassPermissionsを​含むどの​モードでも​有効です。

プロジェクトの​指示の​ファイル

CLAUDE.mdは、Claude Codeに​作業の​決まりを​伝える​指示の​ファイルです。​起動した​フォルダとその​上の​階層の​ファイルがすべて​読み込まれ、​上書きされずに​連結されます。​サブフォルダのCLAUDE.mdは、​その​フォルダの​ファイルを​扱うときに​読み込まれます。

.claude/rules/の​フォルダには、​話題ごとの​規則の​ファイルを​置けます。​ファイルの​先頭にpaths:で​対象の​ファイルを​指定すると、​該当する​ファイルを​扱うときだけ​読み込まれます。

危ない​操作を​止める​フック

フックは、​決まった​時点で​自分の​処理を​実行する​仕組みです。PreToolUseの​フックは、​ツールを​実行する​前に​動き、​操作を​止めることができます。

操作を​止めるには、​フックの​処理を​終了コード​2で​終えます。​終了コード​1では​止まらないため、​公式文書は、​決まりを​強制する​フックには​終了コード​2を​使うよう​求めています。

よくある​質問

CLAUDE.mdに​「削除しない」と​書けば、​削除を​止められますか?

止められません。CLAUDE.mdは​作業の​文脈として​読み込まれるだけで、​強制する​力はございません。​確実に​止めるには、​権限の​denyの​規則か、​フックを​使います。

チームの​設定と​個人の​設定は、​どう​分ければよいですか?

全員で​守る決まりは、​リポジトリに​含める.claude/settings.jsonに​書きます。​自分だけの​例外は.claude/settings.local.jsonに​書きます。

まとめ

  • 設定ファイルは​4種類で、​組織の​管理の​設定が​最も​優先され、​配列の​設定は​合わせて​使われる
  • 権限の​規則は​deny、ask、allowの​順に​評価され、denyはどの​モードでも​有効
  • 指示の​ファイルには​強制する​力がないため、​止めたい​操作は​権限の​規則か​フックで​止める

次回は、​身に​付く知識の​2本目として、Claude APIと​MCPの​仕様を​ご紹介する​予定です。​代表の​Claude認定の​有効期限は、2027年10月23日から​25日です。​エレノアが​設計・​運営している​サービスは、​実績の​ページで​ご紹介しております。Webサイトや​アプリの​制作の​ご相談は、​お問い合わせから​お気軽に​ご連絡ください。

Claude、Claude Codeは、Anthropic, PBCの​商標です。​エレノアは、Anthropic社と​提携している​事業者ではございません。

ブログの​記事一覧