983 pages for bash.

Test plugins with evals Claude Code CLI · in the page plugin-evals …d trigger it **1. Create the cases** From the plugin root, run: ```bash theme={null} claude plugin eval init ``` If Claude Code doesn't already trust this directory it first asks `Trust this plugi… Recommend your plugin from your CLI Claude Code CLI · in the page plugins/cli-hints …claude-code-hint />` tag to stderr. Claude Code removes the line from Bash and PowerShell tool output before the model sees the output, then shows the user a one-time install prompt. This page applie… Plugin commands reference Claude Code CLI · in the page plugins/cli-reference …this command, see [Create a plugin](/docs/en/plugins/create.md). ```bash theme={null} claude plugin init <name> [options] ``` `<name>` becomes the directory name under `~/.claude/skills/` and the p… Add components to a plugin Claude Code CLI · in the page plugins/components …xecutables) in place, `hello-plugin` is a command Claude can run: ```bash theme={null} #!/bin/bash echo "hello from my-plugin" ``` The hook in `hooks/hooks.json` runs a script, and this folder is wh… Create a Claude Code plugin Claude Code CLI · in the page plugins/create …, with a `.claude-plugin/` folder inside it to hold the manifest: ```bash theme={null} mkdir -p my-first-plugin/.claude-plugin ``` **2. Write the manifest** The [manifest](/docs/en/plugins/manifest… Create a marketplace Claude Code CLI · in the page plugins/create-marketplace …laude-plugin/` folder, then copy your plugin in under `plugins/`: ```bash theme={null} mkdir -p my-marketplace/.claude-plugin my-marketplace/plugins cp -r my-first-plugin my-marketplace/plugins/ ```… Plugin dependencies Claude Code CLI · in the page plugins/dependencies …/plugins/cli-reference#flags-that-load-a-plugin-for-one-session): ```bash theme={null} claude --plugin-dir ./my-dependency --plugin-dir ./my-plugin ``` The local copy of the dependency satisfies you… Host and maintain a marketplace Claude Code CLI · in the page plugins/host-marketplace …ink /D` from an elevated Command Prompt or enable Developer Mode: ```bash theme={null} ln -s ../../shared-plugin/skills/foo ./skills/foo ``` ## Distribute through organization settings On a Team or… Install and manage plugins Claude Code CLI · in the page plugins/install …d and install from your shell](#add-and-install-from-your-shell). ```bash theme={null} claude plugin install formatter@your-org --scope project ``` The command prints `Successfully installed plugin:… Plugin manifest reference Claude Code CLI · in the page plugins/manifest-reference …a manifest. Run it from your shell against the plugin directory: ```bash theme={null} claude plugin validate ./my-plugin ``` The command reports one of these results: * **`Validation passed`**: th… Measure plugin cost and usage Claude Code CLI · in the page plugins/measure …t has two skills, a command, an agent, a hook, and an MCP server: ```bash theme={null} claude plugin details formatter ``` ```text theme={null} formatter 1.0.0 Description: Formats and lints code… Manage mods for your organization Claude Code CLI · in the page plugins/mods/admin …ur shell, run `claude plugin validate` on the plugin's directory: ```bash theme={null} claude plugin validate ./some-mod ``` The `hooks:` and `calls:` lines in the output describe the mod's code: `… Use the mods API Claude Code CLI · in the page plugins/mods/api …[`$.tool.call`](/docs/en/plugins/mods/reference#mods-api-methods) of Bash with `run_in_background: true`, Monitor, or CronCreate | Resolves with `{ deny: '<tool> was not run: it starts background wor… Create a mod Claude Code CLI · in the page plugins/mods/create …lugin directory** Create the two directories that hold the files: **Bash or Zsh** ```bash theme={null} mkdir -p first-mod/.claude-plugin first-mod/hooks ``` **PowerShell** ```powershell theme={nu… React to events with a mod Claude Code CLI · in the page plugins/mods/events …each tool runs, a dim line such as `● my-mod: Claude is about to use Bash` appears in the transcript, where `my-mod` is your plugin's name. The tool runs as it would without the mod. To act after th… Interface gallery for mods Claude Code CLI · in the page plugins/mods/gallery …shell, start Claude Code from the directory that holds `gallery`: ```bash theme={null} claude --plugin-dir ./gallery ``` At the Claude Code prompt, run `/gallery`. A pane opens with `Plain text` in… Mods overview Claude Code CLI · in the page plugins/mods/overview …urn on [sandboxing](/docs/en/sandboxing.md), the sandbox isolates the Bash commands Claude runs, and a process that a mod starts runs outside it. With [managed settings](/docs/en/settings.md#check-wh… Mods reference Claude Code CLI · in the page plugins/mods/reference …on the event's fields, and the hook, as in `on('tool.call', { tool: 'Bash' }, async ($, e, next) => next(e))`. `on` returns a registration with one method, `.catch(handler)`, which sets the hook's [e… Test a mod Claude Code CLI · in the page plugins/mods/test …s, which the mod's tool.call hook counts await $.tool.call({ tool: 'Bash', command: 'ls' }) await $.tool.call({ tool: 'Read', file_path: 'README.md' }) // Run /tally and check the text its hook… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …`--debug`, or with `--debug-file <path>` to choose where it goes: ```bash theme={null} claude --debug-file ./mod-debug.log --plugin-dir ./first-mod ``` In another terminal, follow the file and filte… Manage Claude Code plugins for your organization Claude Code CLI · in the page plugins/org …etplace and plugins install there instead of `~/.claude/plugins`: ```bash theme={null} CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/your-marketplace CLAUDE_COD… Recommend plugins for your org Claude Code CLI · in the page plugins/relevance …array of strings | Hostnames seen in `http://` or `https://` URLs in Bash commands this session, for example `["registry.terraform.io"]`. Bare lowercase hostname only: no scheme, port, or path. Exact… Plugin security and trust Claude Code CLI · in the page plugins/security …Code adds each enabled plugin's `bin/` directory to the `PATH` of the Bash tool's shell, so Claude's Bash commands can run any executable there. A command that Claude runs with the [PowerShell tool](/… Troubleshoot plugins Claude Code CLI · in the page plugins/troubleshooting …l prompt, and the shell reported that no file named `/plugin` exists. Bash reports `bash: /plugin: No such file or directory`. `/plugin` is a command you type inside a Claude Code session, not at the… How Claude Code uses prompt caching Claude Code CLI · in the page prompt-caching …lding. ### Denying an entire tool If you add a bare tool name like `Bash` or `WebFetch` as a [deny rule](/docs/en/permissions.md#manage-permissions), Claude can't call that tool from your next reque… Quickstart Claude Code CLI · in the page quickstart …ommand. **Native Install (Recommended)** **macOS, Linux, WSL:** ```bash theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` On Windows, your prompt shows `PS C:\` when you're in PowerS… Continue local sessions from any device with Remote Control Claude Code CLI · in the page remote-control …ntrol` command. **Server mode** In your project directory, run: ```bash theme={null} claude remote-control ``` Until you accept Remote Control's one-time confirmation, `claude remote-control` expl… Automate work with scheduled tasks Claude Code CLI · in the page routines …trigger), or the request fails with a `401` authentication error: ```bash theme={null} curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \ -H "Author… Choose a sandbox environment Claude Code CLI · in the page sandbox-environments …onment > Compare Claude Code sandbox options: the built-in sandboxed Bash tool, sandbox runtime, dev containers, Docker, and VMs. Choose the right isolation for your threat model. Isolating Claude C… Run prompts on a schedule Claude Code CLI · in the page scheduled-tasks …e` or `claude --continue`, Claude Code doesn't restart the background Bash commands and monitors that were running when the session ended. If you still need one, ask Claude to start it again. * With [… Security Claude Code CLI · in the page security …-in protections To mitigate risks in agentic systems: * **Sandboxed bash tool**: [Sandbox](/docs/en/sandboxing.md) bash commands with filesystem and network isolation, reducing permission prompts wh… Catch security issues as Claude writes code Claude Code CLI · in the page security-guidance …ing tree during the turn, including changes from Claude's edit tools, Bash commands, and subagents, and sends it to a separate Claude review focused on security. The review runs in the background, so… Customize sessions in self-hosted environments Claude Code CLI · in the page self-hosted-environments-configuration …STED_RUNNER_EXEC_PATH`, at the wrapper when you start the runner: ```bash theme={null} claude self-hosted-runner --environment-secret-file /etc/claude/environment-secret --exec-path /etc/claude/sessi… Deploy self-hosted environments to production Claude Code CLI · in the page self-hosted-environments-deploy …unner-cli-flags), and doesn't cover repository hooks, `.mcp.json`, or Bash rules; see [Permissions and tool approval](/docs/en/self-hosted-environments-configuration.md#permissions-and-tool-approval)… Verify session identity in self-hosted environments Claude Code CLI · in the page self-hosted-environments-identity …hen the creator's `act.sub` subject, `user:<id>` or `agent:<id>`: ```bash theme={null} "$CLAUDE_RUNNER_CLAUDE_BIN" self-hosted-runner decode-token | jq -re '.act.email // .act.sub' ``` Wrappers rece… Self-hosted environments quickstart Claude Code CLI · in the page self-hosted-environments-quickstart ….md#configure-git) states each floor. Confirm the host is ready: ```bash theme={null} claude self-hosted-runner --help ``` A ready host prints the runner's usage text, listing flags such as `--envi… Test self-hosted environments end to end Claude Code CLI · in the page self-hosted-environments-testing …T_ENVIRONMENT_ID` and asserts on a sentinel phrase in each reply. ```bash theme={null} #!/usr/bin/env bash # End-to-end test against a self-hosted environment, using Stop-hook read-back. # Prereqs: `… Configure server-managed settings Claude Code CLI · in the page server-managed-settings …restricts permission rules to those defined in managed settings. The `Bash(curl *)` rule matches `curl` [as Claude writes it](/docs/en/permissions.md#bash-rule-limits), not `/usr/bin/curl` or `sh -c '… Manage sessions Claude Code CLI · in the page sessions …ed](/docs/en/scheduled-tasks.md#limitations) are restored. Background Bash and monitor tasks aren't. * Background work: a [background subagent](/docs/en/sub-agents.md#run-subagents-in-foreground-or-ba… Claude Code settings Claude Code CLI · in the page settings …ermission approvals](/docs/en/permissions#permission-system), such as Bash command approvals, to this file. Because this file is yours rather than the repository's, its permission `allow` rules t… Example settings files Claude Code CLI · in the page settings-example …ifChannel": "terminal_bell", "permissions": { "allow": [ "Bash(git diff *)", "Read(~/.zshrc)" ] }, "autoUpdatesChannel": "stable", "cleanupPeriodDays": 20 } ``` **What eac… All settings Claude Code CLI · in the page settings-reference …en/accessibility.md) | Interface and terminal | User or managed | | [`bashEditDiffEnabled`](#basheditdiffenabled) | Record the [files that changed while a Bash command ran](/docs/en/hooks.md#bash) in… Advanced setup Claude Code CLI · in the page setup …/docs/en/network-config.md#network-access-requirements). * **Shell**: Bash, Zsh, PowerShell, or CMD. * **Location**: [Anthropic supported countries](https://www.anthropic.com/supported-countries) ###… Extend Claude with skills Claude Code CLI · in the page skills …s folder. Personal skills are available across all your projects. ```bash theme={null} mkdir -p ~/.claude/skills/summarize-changes ``` **2. Write SKILL.md** Every skill needs a `SKILL.md` file with… Customize your status line Claude Code CLI · in the page statusline …ant configures all of this for you automatically. These examples use Bash scripts, which work on macOS and Linux. On Windows, see [Windows configuration](#windows-configuration) for PowerShell and Gi… Create custom subagents Claude Code CLI · in the page sub-agents …ple subagents in a single `--agents` call: **macOS, Linux, WSL** ```bash theme={null} claude --agents '{ "code-reviewer": { "description": "Expert code reviewer. Use proactively after code cha… Configure your terminal for Claude Code Claude Code CLI · in the page terminal-config …ux source-file ~/.tmux.conf` to apply them to the running server: ```bash ~/.tmux.conf theme={null} set -g allow-passthrough on set -s extended-keys on set -as terminal-features 'xterm*:extkeys' ```… Tools reference Claude Code CLI · in the page tools-reference …dditional directories](/docs/en/permissions.md#working-directories). `Bash` is marked Yes but runs a built-in set of [read-only commands](/docs/en/permissions.md#read-only-commands) without prompting.… Troubleshoot installation and login Claude Code CLI · in the page troubleshoot-install …ng-installations) | | `zsh: permission denied: /Users/you/.zshrc` or `bash: /home/you/.bashrc: Permission denied` | [Make your shell config file writable](#permission-denied-when-adding-to-your-path)… Troubleshooting Claude Code CLI · in the page troubleshooting …he text remains, print the VTE version from the terminal's shell: ```bash theme={null} echo $VTE_VERSION ``` On a VTE-based terminal, a result below `5300` means a library older than 0.53: update or…