329 pages for shell.

Hosting the Agent SDK Claude Code CLI · in the page agent-sdk/hosting …Agent SDK spawns and supervises a `claude` CLI subprocess that owns a shell, a working directory, and session files on disk. Hosting it is not like hosting a stateless API wrapper. Every running agent… Modifying system prompts Claude Code CLI · in the page agent-sdk/modifying-system-prompts …tent and environment details such as the working directory, platform, shell, and OS version don't affect the system prompt cache, because Claude Code delivers them in the conversation, not the system… Observability with OpenTelemetry Claude Code CLI · in the page agent-sdk/observability …of two places: * **Process environment:** set the variables in your shell, container, or orchestrator before your application starts. Every `query()` call picks them up automatically with no code ch… Configure permissions Claude Code CLI · in the page agent-sdk/permissions …-mode-acceptedits). * In `plan` mode, Claude Code sends file-edit and shell-write tools to your `canUseTool` callback regardless of allow rules, so write operations can't be auto-approved while planni… Agent SDK reference - Python Claude Code CLI · in the page agent-sdk/python …v/bin/activate pip install claude-agent-sdk ``` For uv, Windows PowerShell, and API key setup, see [Setup in the Agent SDK quickstart](/docs/en/agent-sdk/quickstart#setup). ## Choosing between `quer… Quickstart Claude Code CLI · in the page agent-sdk/quickstart …v/bin/activate pip install claude-agent-sdk ``` On Windows: ```powershell theme={null} py -m venv .venv .venv\Scripts\Activate.ps1 pip install claude-agent-sdk ``` If PowerShell blocks `Activate.ps… Troubleshoot the Agent SDK Claude Code CLI · in the page agent-sdk/troubleshooting …vironment your application runs in. Processes you launch outside your shell, such as from an IDE or a service manager, often run with a different `PATH`. The TypeScript SDK looks for the CLI in its b… Agent SDK reference - TypeScript Claude Code CLI · in the page agent-sdk/typescript …re-approved | "auto"; // A model classifier reviews actions such as shell commands and network requests ``` ### `CanUseTool` Custom permission function type for controlling tool usage. The functi… Orchestrate teams of Claude Code sessions Claude Code CLI · in the page agent-teams …EXPERIMENTAL_AGENT_TEAMS` environment variable to `1`, either in your shell environment or through [settings.json](/docs/en/settings): ```json settings.json theme={null} { "env": { "CLAUDE_CODE… Manage multiple agents with agent view Claude Code CLI · in the page agent-view …you can leave and come back to it. **1. Open agent view** From your shell, run: ```bash theme={null} claude agents ``` If you haven't yet accepted the [workspace trust dialog](/docs/en/permissions… Run agents in parallel Claude Code CLI · in the page agents …command](/docs/en/interactive-mode#background-bash-commands) runs one shell command without blocking the conversation. It doesn't spawn an agent. * A [forked subagent](/docs/en/sub-agents#fork-the-cur… Claude Code on Amazon Bedrock Claude Code CLI · in the page amazon-bedrock …ss key, or temporary credentials with a session token, in the current shell only * [SSO profile](#use-an-sso-profile): sign in through IAM Identity Center in your browser and get temporary credentials… Share session output as artifacts Claude Code CLI · in the page artifacts …ined page. Claude Code wraps the file you publish in an HTML document shell and serves it under a strict Content Security Policy (CSP), which shapes what the page can do. | Constraint | Effect | | :-… Authentication Claude Code CLI · in the page authentication …an [`claude auth login`](/docs/en/cli-reference#cli-commands) in your shell before your first session, or you rebuilt a dev container that keeps your credentials in a [volume](/docs/en/devcontainer#pe… Auto mode classifier request charges Claude Code CLI · in the page auto-mode-classifier-billing …liminate-prompts-with-auto-mode), a classifier checks actions such as shell commands and network requests before they run. Wherever [server-side checks are on](/docs/en/permission-modes#server-side-cl… Configure auto mode Claude Code CLI · in the page auto-mode-config …namespaces, hosts, or containers that count as production, so remote shells and port-forwards into them need your explicit approval * **Protected IaC scopes**: the infrastructure resources whose appl… Claude Code changelog Claude Code CLI · in the page changelog …s set * Fixed `/permissions` > Recently denied not showing the denied shell command, and auto mode's local classifier ignoring an approval from there when it checks a retried command; approving a row… Push events into a running session with channels Claude Code CLI · in the page channels …hannels/telegram/.env`. You can also set `TELEGRAM_BOT_TOKEN` in your shell environment before launching Claude Code. **4. Restart with channels enabled** Exit Claude Code and restart with the chann… Channels reference Claude Code CLI · in the page channels-reference …; when the model gives no description, the field is the constant `Run shell command` and carries zero command detail. Render `input_preview` when you have room. | | `input_preview` | The tool's argume… Use Claude Code with Chrome Claude Code CLI · in the page chrome …wser tools now**: exit and start again with `claude --chrome` in your shell. * **To get browser tools in later sessions**: run `/chrome` at the Claude Code prompt and select [**Enabled by default**](#… Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry Claude Code CLI · in the page claude-apps-gateway …SSWORD: pw, POSTGRES_DB: gateway } healthcheck: test: ["CMD-SHELL", "pg_isready -U gw"] interval: 5s volumes: ["pgdata:/var/lib/postgresql/data"] volumes: { pgdata: } ``` The gate… Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …uire the developer's approval, such as proxy and base-URL variables * shell-execution settings such as `apiKeyHelper` and `statusLine` * the sandbox binary settings `sandbox.bwrapPath`, `sandbox.socat… Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …ateway can push settings to users' machines, including hooks that run shell commands. The check helps keep users from accidentally signing in to a malicious gateway on the public internet. Keep your o… Deploy Claude apps gateway on AWS Claude Code CLI · in the page claude-apps-gateway-on-aws …ent variables Every command on this page reads four values from your shell: `AWS_REGION`, `ACCOUNT_ID`, `VPC_ID`, and `PRIVATE_SUBNETS`. Pick a US region where Bedrock serves the Claude models you n… Use Claude Code in the cloud Claude Code CLI · in the page claude-code-on-the-web …un [`claude auth login`](/docs/en/cli-reference#cli-commands) in your shell to sign in with your claude.ai account, then retry the command. Inside a running session, `/login` does the same. If the err… Explore the .claude directory Claude Code CLI · in the page claude-directory …workspace. The <C>{'${NOTION_TOKEN}'}</C> reference is read from your shell environment when Claude Code starts the server, so the token never lands in the file.</>, example: `{ "mcpServers"… Scan your codebase for vulnerabilities Claude Code CLI · in the page claude-security …wed. **6. Apply the patches you accept** Apply each patch from your shell with `git apply`, in its own pull request. Patches are never applied automatically. You don't have to start from the menu:… CLI reference Claude Code CLI · in the page cli-reference …o a [background session](/docs/en/agent-view#manage-sessions-from-the-shell) in this terminal… Configure cloud environments Claude Code CLI · in the page cloud-environments …his table, ask Claude to run `check-tools` in a cloud session. It's a shell command installed on the session VM, not a command you type with `/`; you ask Claude because [Claude runs all VM commands fo… Read and request reviews on a pull request Claude Code CLI · in the page code-review-pull-requests …command in these steps does. **1. Find the check run ID** From your shell, list the commit's check runs and take the `id` of the `Claude Code Review` run. Replace `OWNER` and `REPO` with your reposi… Commands Claude Code CLI · in the page commands …e what you want, or run without arguments to auto-configure from your shell prompt… Common workflows Claude Code CLI · in the page common-workflows …E_DISABLE_FILE_MENTIONS`](/docs/en/env-vars#variables) to `1` in your shell or in the [`env` block](/docs/en/env-vars#set-variables-in-settings-files) of user settings or [managed settings](/docs/en/m… Communications kit Claude Code CLI · in the page communications-kit …Manual* (the `default` setting value) asks before file edits and most shell commands, *acceptEdits* lets file edits and common filesystem commands flow through while still checking before other shell… Let Claude use your computer from the CLI Claude Code CLI · in the page computer-use …](/docs/en/mcp) for the service, Claude uses that. * If the task is a shell command, Claude uses Bash. * If the task is browser work and you have [Claude in Chrome](/docs/en/chrome) set up, Claude use… Explore the context window Claude Code CLI · in the page context-window …'#6B6964', vis: 'hidden', desc: 'Working directory, platform, shell, OS version, and whether this is a git repo. Git branch, status, and recent commits load as a separate block.', link: nu… Run Claude Code behind a corporate launcher Claude Code CLI · in the page corporate-launcher …of a settings file so the detached background service inherits it. A shell `export` isn't enough: the background service starts on demand, outlives your shell, and never re-reads shell profiles. For… Debug your configuration Claude Code CLI · in the page debug-your-config …ollows. **1. Create an empty directory and change into it** In your shell, with no Claude Code session running, create the directory and move into it: **Bash or Zsh** ```bash theme={null} mkdir -p… Launch sessions from links Claude Code CLI · in the page deep-links …link](#build-a-link), [embed one in a runbook or trigger it from the shell](#examples), and [manage or disable handler registration](#registration-and-supported-platforms) on each platform. ## How d… Desktop application Claude Code CLI · in the page desktop …`auto` | Claude runs without routine prompts; before actions such as shell commands and network requests run, a background classifier checks that they align with your request. Appears when [auto mode… Development containers Claude Code CLI · in the page devcontainer …nes the CLI, the egress firewall, persistent volumes, and a Zsh-based shell. It is provided as a working example rather than a maintained base image; use it to see how the pieces fit together before a… Environment variables Claude Code CLI · in the page env-vars …o: * [Set environment variables](#set-environment-variables) in your shell or in a settings file * [Check which value applies](#precedence) when a behavior can be set more than one way * [Look up the… Error reference Claude Code CLI · in the page errors …| [Command-line errors](#no-available-ports-for-oauth-redirect) | | `Shell command failed for pattern "..."`, from `/security-review` or any skill that injects dynamic context | [Command-line errors]… Extend Claude Code Claude Code CLI · in the page features-overview …ude to apply. | Aspect | Hook | Skill | | - | - | - | | **Runs** | A shell command, HTTP request, MCP tool call, LLM prompt, or subagent | Instructions Claude reads and follows | | **Triggered by** |… Fullscreen rendering Claude Code CLI · in the page fullscreen …to show are clickable. * Clicking also expands the output of a `!` shell command, whether an older truncated result or the live progress row while the command runs. Requires Claude Code v2.1.257 or… Claude Code GitHub Actions Claude Code CLI · in the page github-actions …nt, including a cron schedule. For a plain-text prompt, Claude has no shell or GitHub API access until you grant the tools the prompt needs, with `--allowedTools` in `claude_args` or a [`permissions.a… Glossary Claude Code CLI · in the page glossary …ess; Claude is the model inside it. The harness supplies file access, shell execution, permission gating, memory loading, and the loop that chains actions together. Learn more: [How Claude Code works… Keep Claude working toward a goal Claude Code CLI · in the page goal …### Background work defers evaluation If a subagent or a background shell command is still running when a turn ends, Claude Code skips the evaluation for that turn. It evaluates at the end of the ne… Claude Code on Google Cloud's Agent Platform Claude Code CLI · in the page google-vertex-ai …riables aren't reaching the process. Confirm they are exported in the shell where you launched `claude`, or set them in the `env` block of your [settings file](/docs/en/settings). ## Startup model ch… Run Claude Code programmatically Claude Code CLI · in the page headless …-sdk/typescript#sdkinformationalmessage) in `stream-json` output, and shell commands fail until the directory exists again. ## Examples These examples highlight common CLI patterns. Where a command… Set up Claude Code (local mode) for a HIPAA-ready organization Claude Code CLI · in the page hipaa-setup …run this command in a terminal. It's the same in Bash, Zsh, and PowerShell: ```bash theme={null} claude --version ``` A supported installation prints `2.1.285 (Claude Code)` or a higher number. To…