265 pages for root.
Titles and paths first, then pages whose text carries it. Each row opens that page as this site last read it.
Configure permissions
Claude Code CLI · in the page
agent-sdk/permissions
…ded. On Linux and macOS, Claude Code refuses to start in this mode as root or under `sudo` outside a [recognized sandbox](https://code.claude.com/docs/en/permission-modes.md#skip-all-checks-with-bypas…
Plugins in the SDK
Claude Code CLI · in the page
agent-sdk/plugins
…ins/my-plugin"`) > [!NOTE] > > The path should point to the plugin's root directory: the parent of `skills/`, `agents/`, `hooks/`, `commands/`, or `.claude-plugin/`. ### Reload plugins in a running…
Securely deploying AI agents
Claude Code CLI · in the page
agent-sdk/secure-deployment
…tom profiles can block more | | `--read-only` | Makes the container's root filesystem immutable, preventing the agent from persisting changes | | `--tmpfs /tmp:...` | Provides a writable temporary dir…
Extend agents with skills
Claude Code CLI · in the page
agent-sdk/skills
…aude/skills/` in any parent directory of `<cwd>` up to the repository root are available. The project source also covers `<dir>/.claude/skills/` in each directory you pass through `additionalDirectori…
Agent SDK reference - TypeScript
Claude Code CLI · in the page
agent-sdk/typescript
…ort from `@anthropic-ai/claude-agent-sdk/core` instead of the package root. The `/core` entry requires TypeScript Agent SDK v0.3.282 or later, and its types require TypeScript 5.0 or later. To keep t…
Orchestrate teams of Claude Code sessions
Claude Code CLI · in the page
agent-teams
…ter they finish. ### Investigate with competing hypotheses When the root cause is unclear, a single agent tends to find one plausible explanation and stop looking. The prompt fights this by making t…
Manage multiple agents with agent view
Claude Code CLI · in the page
agent-view
…onversation moved to the background` above the list, and `Esc` at the root of agent view returns to that conversation instead of exiting to the shell, with double `Ctrl+C` remaining the exit; if the c…
Claude Code on Amazon Bedrock
Claude Code CLI · in the page
amazon-bedrock
…uide/command-line-sign-in.html) if you access your AWS account as the root user, as an IAM user, or through federation with IAM. * [Amazon Bedrock API key](#use-an-amazon-bedrock-api-key): authenticat…
Best practices for Claude Code
Claude Code CLI · in the page
best-practices
…m/docs/en/worktrees#copy-gitignored-files-into-worktrees) at the repo root (same syntax as `.gitignore`) and Claude Code copies them into every worktree it creates: ```text .worktreeinclude theme={nu…
Claude Code changelog
Claude Code CLI · in the page
changelog
…local issuer certificate" behind some TLS-inspecting proxies after a root certificate renewal * Fixed very long conversations losing their earlier summary when compaction had to shorten its own reque…
Deploy Claude apps gateway on AWS
Claude Code CLI · in the page
claude-apps-gateway-on-aws
…and trusts via `NODE_EXTRA_CA_CERTS`. Don't append a libpq-style `sslrootcert=` parameter to the URL: the gateway's driver reads only `sslmode` from the query string and would forward `sslrootcert` t…
Explore the .claude directory
Claude Code CLI · in the page
claude-directory
…o works at <C>.claude/CLAUDE.md</C> if you prefer to keep the project root clean</>, <>If your repo already has an <C>AGENTS.md</C> for other coding agents, Claude Code <A href="/docs/en/memory#agents…
Let Claude coordinate ongoing work with Projects
Claude Code CLI · in the page
claude-projects
…AUDE.md`, `.claude/CLAUDE.md`, and `.claude/rules/` at the repository root | Loaded from every repository when the thread starts. `CLAUDE.md` files in subdirectories and [path-specific rules](https://…
claude-tag
Claude Code CLI · in the page
claude-tag
…Variable.woff2)format("woff2");font-weight:100 800;font-display:swap}:root{--font-inter:"Inter";--font-paper-mono:"Paper Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono"…
Configure cloud environments
Claude Code CLI · in the page
cloud-environments
…code.claude.com/docs/en/claude-projects.md) loads only the repository root's `CLAUDE.md`, `.claude/CLAUDE.md`, and `.claude/rules/` files that aren't [path-specific](https://code.claude.com/docs/en/me…
Code Review
Claude Code CLI · in the page
code-review
…d) instead. ### REVIEW\.md `REVIEW.md` is a file at your repository root that tailors Code Review to your repo. The agents in the review pipeline that find and verify findings receive its contents a…
Customize Code Review
Claude Code CLI · in the page
code-review-customize
…what severity, and what to skip. Add `REVIEW.md` at your repository root and merge it. Then [protect your default branch](#which-branch-review-md-is-read-from). > [!NOTE] > > To change how thorough…
Troubleshoot Code Review
Claude Code CLI · in the page
code-review-troubleshooting
…which is not protected against direct pushes."**: the review read the root file only. See [Which branch REVIEW.md is read from](https://code.claude.com/docs/en/code-review-customize.md#which-branch-re…
Common workflows
Claude Code CLI · in the page
common-workflows
…ed to understand its structure quickly. **1. Navigate to the project root directory** ```bash theme={null} cd /path/to/project ``` Replace `/path/to/project` with the path to your project. **2. S…
Communications kit
Claude Code CLI · in the page
communications-kit
…a step backward. It is. One config file (`.mcp.json` at your project root) wires Claude into GitHub, Jira, Linear, or whatever tracker you use. Then "what's the top-priority issue assigned to me?" an…
Explore the context window
Claude Code CLI · in the page
context-window
…notes. The most important file you can create. Lives in your project root, so your whole team gets the same instructions.', tip: 'Keep it under 200 lines. Move reference content to skills or path…
Manage costs effectively
Claude Code CLI · in the page
costs
…can also customize compaction behavior in your CLAUDE.md file at the root of your project: ```markdown theme={null} # Compact instructions When you are using compact, please focus on test output an…
Debug your configuration
Claude Code CLI · in the page
debug-your-config
…, instead of `mcpServers` | Project MCP config goes at the repository root as `.mcp.json`, not inside `.claude/`, with servers under the `mcpServers` key. See [MCP configuration](https://code.claude.c…
Desktop application
Claude Code CLI · in the page
desktop
…branch name, above the prompt box Worktrees are stored in `<project-root>/.claude/worktrees/` by default. To store them in a custom directory instead: * **Local sessions**: set **Worktree location*…
Claude Desktop on Linux (beta)
Claude Code CLI · in the page
desktop-linux
…ll), which selects the package for your architecture. ### Running as root without `--no-sandbox` is not supported If `claude-desktop` exits with this message, you launched it as root. Log in as a re…
Development containers
Claude Code CLI · in the page
devcontainer
…p.md#mcp-installation-scopes) in a `.mcp.json` file at the repository root so they are checked in alongside your dev container configuration. Install any binaries that local stdio servers depend on in…
Environment variables
Claude Code CLI · in the page
env-vars
…/docs/en/permission-modes#remove-item-in-powershell), such as a drive root or your home directory. Claude Code ignores this variable in a settings file's `env` block. Requires Claude Code v2.1.283 or…
Extend Claude Code
Claude Code CLI · in the page
features-overview
…** Claude reads CLAUDE.md files from your working directory up to the root, and discovers nested ones in subdirectories as it accesses those files. See [How CLAUDE.md files load](https://code.claude.c…
Claude Code GitHub Actions
Claude Code CLI · in the page
github-actions
…standards in CLAUDE.md Create a `CLAUDE.md` file in your repository root to define code style guidelines, review criteria, project-specific rules, and preferred patterns. Claude follows these guidel…
Claude Code GitLab CI/CD
Claude Code CLI · in the page
gitlab-ci-cd
…CLAUDE.md configuration Create a `CLAUDE.md` file at the repository root to define coding standards, review criteria, and project-specific rules. Claude reads this file during runs and follows your…
Glossary
Claude Code CLI · in the page
glossary
…s, subagents, rules, and auto memory. A project has `.claude/` at its root; your user-level defaults are at `~/.claude/`. Learn more: [The `.claude` directory](https://code.claude.com/docs/en/claude-…
Run Claude Code programmatically
Claude Code CLI · in the page
headless
…h theme={null} cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt ``` With `--output-format json`, the response payload includes `total_cost_usd` and…
Hooks reference
Claude Code CLI · in the page
hooks
…rectory is added mid-session via `/add-dir` or the SDK `register_repo_root` control request | | `FileChanged` | When a watched file changes on disk. The `matcher` field specifies which filenames to wa…
Automate actions with hooks
Claude Code CLI · in the page
hooks-guide
…s it to Prettier. Add this to `.claude/settings.json` in your project root: ```json theme={null} { "hooks": { "PostToolUse": [ { "matcher": "Edit|Write", "hooks": […
JetBrains IDEs
Claude Code CLI · in the page
jetbrains
…ur IDE, start Claude Code from the same directory as your IDE project root. ## Configuration ### Claude Code settings Configure IDE integration through Claude Code's settings: 1. Run `claude` 2. E…
Set up Claude Code in a monorepo or large codebase
Claude Code CLI · in the page
large-codebases
…| | Load only the conventions for the code you touch, instead of one root file covering every subsystem | Per-directory [CLAUDE.md files](#layer-claude-md-files-by-directory) | | Exclude CLAUDE.md fi…
Deploy managed settings
Claude Code CLI · in the page
managed-settings
…failed: * If the operating system denied the read, for example on a root-only file, every session starts without that source's policies. `/status` and `claude doctor` record the failure, and a run w…
Connect Claude Code to tools via MCP
Claude Code CLI · in the page
mcp
…LAUDE_PROJECT_DIR` in the spawned server's environment to the project root, so your server can resolve project-relative paths without depending on the working directory. This is the same directory hoo…
Connect to MCP servers
Claude Code CLI · in the page
mcp-quickstart
…this project. The default | | `project` | `.mcp.json` in your project root | Everyone who clones the project | | `user` | `~/.claude.json`, under the top-level `mcpServers` key | Only you, all project…
How Claude remembers your project
Claude Code CLI · in the page
memory
…ecked into version control, create a `CLAUDE.local.md` at the project root. It loads alongside `CLAUDE.md` and is treated the same way. Add `CLAUDE.local.md` to your `.gitignore` so it isn't committed…
Model configuration
Claude Code CLI · in the page
model-config
…//code.claude.com/docs/en/goal.md). * **Hand it ambiguous problems**: root-cause investigations, outage debugging, and architecture decisions are where the extra investigation and verification pay off…
Monitoring
Claude Code CLI · in the page
monitoring-usage
…# Span hierarchy Each user prompt starts a `claude_code.interaction` root span. API calls, tool calls, and hook executions are recorded as its children. Tool spans have two child spans of their own:…
Enterprise network configuration
Claude Code CLI · in the page
network-config
…S-inspection proxies work without additional configuration when their root certificate is installed in the OS trust store and the runtime can read it. If such a proxy mishandles gzip-compressed reques…
Output styles
Claude Code CLI · in the page
output-styles
…aude/output-styles/` between the working directory and the repository root. When more than one of these nested directories defines a style with the same name, Claude Code uses the one closest to the w…
Overview
Claude Code CLI · in the page
overview
…m. Claude Code traces the issue through your codebase, identifies the root cause, and implements a fix. See [common workflows](https://code.claude.com/docs/en/common-workflows.md) for more examples.…
Choose a permission mode
Claude Code CLI · in the page
permission-modes
…nvironments.md#sandbox-runtime); on Linux and macOS, run it as a [non-root user](#skip-all-checks-with-bypasspermissions-mode) | Cloud sessions ignore this mode from settings files. In this `-p` run,…
Configure permissions
Claude Code CLI · in the page
permissions
…n, Claude Code saves the rule to `.claude/settings.local.json` at the root of the git repository, resolved through [worktrees](https://code.claude.com/docs/en/worktrees.md) to the main checkout. The r…
Test plugins with evals
Claude Code CLI · in the page
plugin-evals
…ther [requirements](#requirements) * A terminal open at your plugin's root directory, the one containing `plugin.json` or `.claude-plugin/plugin.json` * One skill in the plugin you want to test, and a…
Anthropic's marketplaces
Claude Code CLI · in the page
plugins/anthropic-marketplaces
…y a GitHub repository with a `.claude-plugin/marketplace.json` at its root. Anthropic doesn't review third-party marketplaces, so read [Plugin security and trust](https://code.claude.com/docs/en/plug…
Plugin commands reference
Claude Code CLI · in the page
plugins/cli-reference
…gin eval init [name] [options] ``` Run the command from the plugin's root folder, the directory that holds `.claude-plugin/plugin.json` or the skill's `SKILL.md`. To scaffold the suite in another dir…