組織でのClaude Codeのユーザー認証、認可、アクセス制御の設定方法を学びます。
ツールタイプ | 例 | 承認が必要 | 「はい、再度確認しない」の動作 |
---|---|---|---|
読み取り専用 | ファイル読み取り、LS、Grep | いいえ | N/A |
Bashコマンド | シェル実行 | はい | プロジェクトディレクトリとコマンドごとに永続的 |
ファイル変更 | ファイル編集/書き込み | はい | セッション終了まで |
/permissions
でClaude Codeのツール権限を表示・管理できます。このUIはすべての権限ルールとそれらのソースとなるsettings.jsonファイルを一覧表示します。
Tool
またはTool(optional-specifier)
ツール名だけのルールは、そのツールのあらゆる使用にマッチします。例えば、allowルールのリストにBash
を追加すると、Claude CodeがBashツールをユーザー承認なしで使用できるようになります。
defaultMode
として設定できるいくつかの権限モードをサポートしています:
モード | 説明 |
---|---|
default | 標準動作 - 各ツールの初回使用時に権限を求めるプロンプトを表示 |
acceptEdits | セッション中のファイル編集権限を自動的に受諾 |
plan | プランモード - Claudeは分析できるがファイルの変更やコマンドの実行はできない |
bypassPermissions | すべての権限プロンプトをスキップ(安全な環境が必要 - 下記の警告を参照) |
--add-dir <path>
CLIアーギュメントを使用/add-dir
スラッシュコマンドを使用additionalDirectories
に追加Bash(npm run build)
正確なBashコマンドnpm run build
にマッチBash(npm run test:*)
npm run test
で始まるBashコマンドにマッチBash(curl http://site.com/:*)
正確にcurl http://site.com/
で始まるcurlコマンドにマッチ&&
など)を認識するため、Bash(safe-cmd:*)
のような前置マッチルールはsafe-cmd && other-cmd
コマンドの実行権限を与えません:*
はパターンの最後でのみ機能し、任意の継続にマッチしますBash(curl http://github.com/:*)
のようなパターンは多くの方法で回避できます:
curl -X GET http://github.com/...
はマッチしませんcurl https://github.com/...
はマッチしませんcurl -L http://bit.ly/xyz
(githubにリダイレクト)URL=http://github.com && curl $URL
はマッチしませんcurl http://github.com
はマッチしませんWebFetch(domain:github.com)
権限でWebFetchツールを使用Edit
ルールは、ファイルを編集するすべての組み込みツールに適用されます。Claudeは、Grep、Glob、LSなどのファイルを読み取るすべての組み込みツールにRead
ルールを適用するよう最善の努力をします。
ReadとEditルールはどちらもgitignore仕様に従い、4つの異なるパターンタイプがあります:
パターン | 意味 | 例 | マッチ |
---|---|---|---|
//path | ファイルシステムルートからの絶対パス | Read(//Users/alice/secrets/**) | /Users/alice/secrets/** |
~/path | ホームディレクトリからのパス | Read(~/Documents/*.pdf) | /Users/alice/Documents/*.pdf |
/path | 設定ファイルに相対的なパス | Edit(/src/**/*.ts) | <設定ファイルパス>/src/**/*.ts |
path または./path | 現在のディレクトリに相対的なパス | Read(*.env) | <cwd>/*.env |
/Users/alice/file
のようなパターンは絶対パスではありません - 設定ファイルに相対的です!絶対パスには//Users/alice/file
を使用してください。Edit(/docs/**)
- <project>/docs/
での編集(/docs/
ではありません!)Read(~/.zshrc)
- ホームディレクトリの.zshrc
を読み取りEdit(//tmp/scratch.txt)
- 絶対パス/tmp/scratch.txt
を編集Read(src/**)
- <current-directory>/src/
から読み取りWebFetch(domain:example.com)
example.comへのフェッチリクエストにマッチmcp__puppeteer
puppeteer
サーバーが提供する任意のツールにマッチ(Claude Codeで設定された名前)mcp__puppeteer__puppeteer_navigate
puppeteer
サーバーが提供するpuppeteer_navigate
ツールにマッチ*
)をサポートしていません。MCPサーバーからすべてのツールを承認するには:mcp__github
(すべてのGitHubツールを承認)mcp__github__*
(ワイルドカードはサポートされていません)mcp__github__get_issue
mcp__github__list_issues
/Library/Application Support/ClaudeCode/managed-settings.json
/etc/claude-code/managed-settings.json
C:\ProgramData\ClaudeCode\managed-settings.json
.claude/settings.local.json
).claude/settings.json
)~/.claude/settings.json
)apiKeyHelper
設定は、APIキーを返すシェルスクリプトを実行するよう設定できます。apiKeyHelper
は5分後またはHTTP 401レスポンス時に呼び出されます。カスタム更新間隔にはCLAUDE_CODE_API_KEY_HELPER_TTL_MS
環境変数を設定してください。