582 pages for environment.

Desktop application Claude Code CLI · in the page desktop …. ## Start a session Before you send your first message, choose the environment, project folder, permission mode, and model in the row under the prompt box: * **Environment**: use the environment s… Claude Desktop on Linux (beta) Claude Code CLI · in the page desktop-linux …`sudo usermod -aG kvm $USER`, then log out and back in. Some desktop environments grant the logged-in user access to `/dev/kvm` without the group, but Cowork also needs `/dev/vhost-vsock`, which only… Get started with the desktop app Claude Code CLI · in the page desktop-quickstart …en, choose a project and give Claude something to do. **1. Choose an environment and folder** In the [row under the prompt box](https://code.claude.com/docs/en/desktop.md#start-a-session), click the… Claude Code Desktop in WSL Claude Code CLI · in the page desktop-wsl …tribution, using its Linux toolchain and native Linux paths, the same environment your project targets. Use a WSL session when your repository lives inside the distribution's filesystem. Working on t… Development containers Claude Code CLI · in the page devcontainer …rs > Run Claude Code inside a dev container for consistent, isolated environments across your team. A [development container](https://containers.dev/), or dev container, lets you define an identical… Error reference Claude Code CLI · in the page errors …request-header-value) | | `Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable` | [Authentication](#invalid-request-header-value) | | `Invalid request header from the environment · Fix the… Speed up responses with fast mode Claude Code CLI · in the page fast-mode …or a [self-hosted runner](https://code.claude.com/docs/en/self-hosted-environments). Requires Claude Code v2.1.271 or later in the session's environment. Type `/fast on` in the session to turn fast m… Fullscreen rendering Claude Code CLI · in the page fullscreen …itch or save anything. You can also set the `CLAUDE_CODE_NO_FLICKER` environment variable before starting Claude Code: ```bash theme={null} CLAUDE_CODE_NO_FLICKER=1 claude ``` For how the [`tui`](h… Run Claude Code through a gateway Claude Code CLI · in the page gateways …h model answers**: pick the model with the `/model` command or [model environment variables](https://code.claude.com/docs/en/model-config.md#setting-your-model). The gateway decides where requests go,… Claude Code with GitHub Enterprise Server Claude Code CLI · in the page github-enterprise-server …cts you to your GHES instance to create the app in one click. If your environment blocks the redirect flow, an [alternative manual setup](#manual-setup) is available. **1. Open Git providers settings… Claude Code GitLab CI/CD Claude Code CLI · in the page gitlab-ci-cd …e Code. 2. **Provider abstraction**: Use the provider that fits your environment: * Claude API (SaaS) * Amazon Bedrock (IAM-based access, cross-region options) * Google Cloud's Agent Platfor… Glossary Claude Code CLI · in the page glossary …d) ### Agentic harness The tools, context management, and execution environment that turn a language model into a capable coding agent. Claude Code is the harness; Claude is the model inside it. The… Keep Claude working toward a goal Claude Code CLI · in the page goal …IC_DEFAULT_HAIKU_MODEL`](https://code.claude.com/docs/en/model-config#environment-variables). > [!WARNING] > > Claude Code reads `ANTHROPIC_DEFAULT_HAIKU_MODEL` everywhere it uses the small fast mode… Claude Code on Google Cloud's Agent Platform Claude Code CLI · in the page google-vertex-ai …`gcloud`, a service account key file, or credentials already in your environment. The wizard asks for your project and region, verifies which Claude models your project can invoke, and lets you pin t… Run Claude Code programmatically Claude Code CLI · in the page headless …ystem keychain. For the Anthropic API, set `ANTHROPIC_API_KEY` in the environment, with a key created in the [Claude Console](https://platform.claude.com), or supply an `apiKeyHelper` in the `--settin… Set up Claude Code (local mode) for a HIPAA-ready organization Claude Code CLI · in the page hipaa-setup …ing point. Your organization is responsible for deciding what its own environment needs and for confirming that its configuration meets those needs. The following sample sets four keys that you could… Hooks reference Claude Code CLI · in the page hooks …for example when Claude executes a `cd` command. Useful for reactive environment management with tools like direnv | | `DirectoryAdded` | When a working directory is added mid-session via `/add-dir`… Automate actions with hooks Claude Code CLI · in the page hooks-guide …g [CLAUDE.md](https://code.claude.com/docs/en/memory.md) instead. For environment variables, see [`CLAUDE_ENV_FILE`](https://code.claude.com/docs/en/hooks#persist-environment-variables) in the referen… How Claude Code works Claude Code CLI · in the page how-claude-code-works …erent from inline code assistants that only see the current file. ## Environments and interfaces The [agentic loop](#the-agentic-loop), [tools](#tools), and capabilities are the same everywhere you… Interactive mode Claude Code CLI · in the page interactive-mode …nd stops at its timeout. To change the timeout, set the [Bash timeout environment variables](https://code.claude.com/docs/en/tools-reference.md#timeout-and-output-limits). **Key features:** * Output… Customize keyboard shortcuts Claude Code CLI · in the page keybindings …CODE_BS_AS_CTRL_BACKSPACE`](https://code.claude.com/docs/en/env-vars) environment variable | | Caps Lock | Not delivered to terminal applications | ## Terminal conflicts Some shortcuts may conflict… Set up Claude Code in a monorepo or large codebase Claude Code CLI · in the page large-codebases …er | Never | | `--add-dir` flag or `/add-dir` command | Only with the environment variable below | Yes | To load CLAUDE.md and rules files from a directory added with `--add-dir` or `/add-dir`, set t… Legal and compliance Claude Code CLI · in the page legal-and-compliance …er credentials — for example, configuring an API key in a development environment, secrets manager, or machine image for use by the customer's own authorized users — provided the resulting usage is bi… Connect Claude Code to an LLM gateway Claude Code CLI · in the page llm-gateway-connect …To authenticate Claude Code to the gateway, set your credential in an environment variable. Which variable depends on what your gateway team told you: | Set the credential in | Use when | | :- | :- |… Claude Code gateway compatibility guide Claude Code CLI · in the page llm-gateway-protocol …DISCOVERY=1`](https://code.claude.com/docs/en/env-vars), in their own environment or through managed settings. Discovery is off by default so that gateways backed by a shared API key don't surface eve… Roll out an LLM gateway for your organization Claude Code CLI · in the page llm-gateway-rollout …per-developer usage attribution and individual offboarding work. The environment variable that holds the key depends on which header the gateway reads. For a gateway that checks credentials in the `A… Control MCP server access for your organization Claude Code CLI · in the page managed-mcp …instead: * [`${VAR}` expansion](https://code.claude.com/docs/en/mcp#environment-variable-expansion-in-mcp-json) to read secrets from each user's environment. * [OAuth or per-user headers](https://co… Deploy managed settings Claude Code CLI · in the page managed-settings …d local files. * **Cloud sessions**: a session in an Anthropic-hosted environment doesn't read a device's MDM profile or file, so policy for it has to come from server-managed settings. A session in a… Connect Claude Code to tools via MCP Claude Code CLI · in the page mcp …ripts. Claude Code sets `CLAUDE_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. Thi… Connect to MCP servers Claude Code CLI · in the page mcp-quickstart …t carries over from your setup](https://code.claude.com/docs/en/cloud-environments.md#what-carries-over-from-your-setup). * **Claude.ai**: connectors you add at [claude.ai/customize/connectors](https:… How Claude remembers your project Claude Code CLI · in the page memory …interactive multi-phase flow instead, set the `CLAUDE_CODE_NEW_INIT` environment variable to `1` before you run `/init`. Set it in your shell or in the `env` block of a settings file, as shown in [Se… Claude Code on Microsoft Foundry Claude Code CLI · in the page microsoft-foundry …key Copy a key from the Microsoft Foundry portal, then set it as an environment variable: 1. Go to your resource in the Microsoft Foundry portal 2. Open the **Endpoints and keys** section 3. Copy *… Claude Code on mobile Claude Code CLI · in the page mobile …or review comments as they arrive. To connect GitHub and set up your environment, follow the [cloud quickstart](https://code.claude.com/docs/en/web-quickstart.md), and see [Use Claude Code in the clo… Model configuration Claude Code CLI · in the page model-config …l model name, for example `claude-opus-5-5`, or set the corresponding environment variable like `ANTHROPIC_DEFAULT_OPUS_MODEL`. > [!NOTE] > > Sonnet 5.5 requires Claude Code v2.1.284 or later, and Op… Monitoring Claude Code CLI · in the page monitoring-usage …claude/opentelemetry). ## Quick start Configure OpenTelemetry using environment variables: ```bash theme={null} # 1. Enable telemetry export CLAUDE_CODE_ENABLE_TELEMETRY=1 # 2. Choose exporters (b… Enterprise network configuration Claude Code CLI · in the page network-config …erprise network configuration > Configure Claude Code for enterprise environments with proxy servers, custom Certificate Authorities (CA), and mutual Transport Layer Security (mTLS) authentication.… Overview Claude Code CLI · in the page overview …pts you to log in on first use. If you've set the `ANTHROPIC_API_KEY` environment variable and you approve the key when Claude Code asks whether to use it, Claude Code skips the login prompt. [Continu… Choose a permission mode Claude Code CLI · in the page permission-modes …outer [isolation boundaries](https://code.claude.com/docs/en/sandbox-environments.md) decide what an action can reach once it runs. Each row below pairs a goal with the flags or settings that get you… Configure permissions Claude Code CLI · in the page permissions …h-bypasspermissions-mode) still apply. Only use this mode in isolated environments like containers or VMs where Claude Code can't cause damage. To prevent `bypassPermissions` or `auto` mode from bein… Platforms and integrations Claude Code CLI · in the page platforms …ax, and Ultra plans | PRs and reviews from team chat | | [Self-hosted environments](https://code.claude.com/docs/en/self-hosted-environments) | Start a [cloud session](https://code.claude.com/docs/en/… Test plugins with evals Claude Code CLI · in the page plugin-evals …atter fields](#prompt-md-fields) covers the model, timeout, tags, and environment variables. Each file under `graders/` is one check applied after the run. Open `evals/first-case/graders/criteria.md`… Recommend your plugin from your CLI Claude Code CLI · in the page plugins/cli-hints …de itself starts. Use it when you can require v2.1.172 or later The [environment variables reference](https://code.claude.com/docs/en/env-vars.md) has the details. The following examples gate on `CL… Plugin commands reference Claude Code CLI · in the page plugins/cli-reference …laude -p`, Claude Code replies that `/plugin` isn't available in this environment. For which surfaces have `/plugin`, how to install without it, and what each panel tab shows, see [Install and manage… Add components to a plugin Claude Code CLI · in the page plugins/components …hooting.md#failed-to-load-hooks-from-and-hooks-that-dont-fire). #### Environment, quoting, and matching MCP tools The hook's environment, the quoting of `${CLAUDE_PLUGIN_ROOT}`, and matchers for the… Create a Claude Code plugin Claude Code CLI · in the page plugins/create …disk with `--plugin-dir`, from a URL with `--plugin-url`, or from an environment variable when you can't add a flag. Each plugin loads for that session only, and nothing is written to your settings f… Host and maintain a marketplace Claude Code CLI · in the page plugins/host-marketplace …tate. If a user sets `GITHUB_TOKEN` or another provider token in the environment, that alone doesn't authenticate the background check. A token takes effect through a credential helper, such as the `… Install and manage plugins Claude Code CLI · in the page plugins/install …d session > > A [cloud session](https://code.claude.com/docs/en/cloud-environments.md), including [the browser at claude.ai/code](https://code.claude.com/docs/en/claude-code-on-the-web.md), has no plu… Plugin loading reference Claude Code CLI · in the page plugins/loading …/product/cowork)**: Claude Code downloads them into the session's own environment when the session starts * **Terminal sessions**: each time you start Claude Code, it syncs once in the background, dow… Plugin manifest reference Claude Code CLI · in the page plugins/manifest-reference …ith its type and default, accepted path forms, and the userConfig and environment variable schemas. A plugin manifest is the `plugin.json` file in a plugin's `.claude-plugin/` directory. It carries t… Measure plugin cost and usage Claude Code CLI · in the page plugins/measure …e.claude.com/docs/en/monitoring-usage#common-configuration-variables) environment variable to `1` on the machines that export telemetry, for example in the `env` block of the same [managed settings](h…