Example settings files changedsettings-example
Nearest release: v2.1.282, published 7 hours before upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Upstream edited this page at 24 Sep 2026 23:34 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 24 Sep 2026 23:37 UTC.
Upstream edited
Recorded here
Lines+2added
Lines−14removed
From line
92
where the diff opens
First seen
21 Aug 2026
this site's first read of the page
Recorded edits9to this page, all time
The whole hunk
from line 92, old and new numbered
/
from line 92
9292 A team's shared settings
9393</h2>
9494
95One team's shared settings, committed to the repository so everyone who clones it gets the same permissions, hooks, telemetry, and plugin marketplace. Save a file like this at `.claude/settings.json` at the top of the repository. What to know before you commit one:
95One team's shared settings, committed to the repository so everyone who clones it gets the same permissions, hooks, and plugin marketplace. Save a file like this at `.claude/settings.json` at the top of the repository. What to know before you commit one:
9696
9797* **Cloud sessions read it too.** A [cloud session](/docs/en/settings#settings-in-cloud-sessions) starts from a clone of the repository, so the committed file applies there as well.
98* **Telemetry goes in managed or personal settings.** Claude Code ignores the [OpenTelemetry exporter variables](/docs/en/settings-reference#variables-claude-code-ignores-in-env) in a repository's settings files, apart from some values that turn telemetry off. Set them in [managed settings](/docs/en/monitoring-usage#administrator-configuration) for your organization, or in each person's `~/.claude/settings.json`.
9899* **Allow rules wait for trust.** Allow rules and `extraKnownMarketplaces` entries take effect after each person [trusts this folder itself](/docs/en/permissions#project-allow-rules-and-workspace-trust), not only a parent folder; deny and ask rules apply in every session, trusted or not.
99100* **The hook is a script in the repo.** This file's hook runs `.claude/hooks/block-rm.sh`; [How a hook resolves](/docs/en/hooks#how-a-hook-resolves) walks through writing it.
100101* **Rules match the command and path as written.** `Bash(git push *)` doesn't match [`git -C . push`](/docs/en/permissions#bash-rule-limits). `Read(./.env)` on its own stops the file tools and commands that name the file, such as `cat .env`, but not [`grep -r` run over the directory](/docs/en/permissions#read-and-edit); the `sandbox` block in this file closes that gap, because the sandbox [adds your `Read` deny paths](/docs/en/settings-reference#sandbox-filesystem-denyread) to what every sandboxed command can't read.
from line 119
118119 "Read(./secrets/**)"
119120 ]
120121 },
121 "env": {
122 "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
123 "OTEL_METRICS_EXPORTER": "otlp",
124 "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
125 "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"
126 },
127122 "hooks": {
128123 "PreToolUse": [
129124 {
from line 182
187182 "Read(./.env.*)",
188183 "Read(./secrets/**)"
189184 ]
190 },
191 // Send OpenTelemetry metrics to the team's collector over gRPC; replace the endpoint with your collector's URL
192 "env": {
193 "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
194 "OTEL_METRICS_EXPORTER": "otlp",
195 "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
196 "OTEL_EXPORTER_OTLP_ENDPOINT": "http://collector.example.com:4317"
197185 },
198186 // Before every Bash command, run a script in the repo that can block it
199187 "hooks": {
No line in this hunk matches that.