[changelog] 2.1.71
This commit is contained in:
Shayan Rais
@@ -2,7 +2,7 @@
|
||||
|
||||
|
||||
|
||||
Complete reference of all available command-line flags, subcommands, and environment variables when launching Claude Code from the terminal.
|
||||
Reference for Claude Code startup flags, top-level subcommands, and startup environment variables when launching Claude Code from the terminal.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
@@ -184,15 +184,21 @@ Complete reference of all available command-line flags, subcommands, and environ
|
||||
|
||||
## Subcommands
|
||||
|
||||
These are not flags but top-level subcommands run as `claude <subcommand>`:
|
||||
These are top-level commands run as `claude <subcommand>`:
|
||||
|
||||
| Subcommand | Description |
|
||||
|------------|-------------|
|
||||
| `claude` | Start interactive REPL |
|
||||
| `claude "query"` | Start REPL with initial prompt |
|
||||
| `claude update` | Update to latest version |
|
||||
| `claude mcp` | Configure MCP servers (`add`, `remove`, `list`, `get`, `enable`) |
|
||||
| `claude agents` | List configured agents |
|
||||
| `claude auth` | Manage Claude Code authentication |
|
||||
| `claude doctor` | Run diagnostics from the command line |
|
||||
| `claude install` | Install or switch Claude Code native builds |
|
||||
| `claude mcp` | Configure MCP servers (`add`, `remove`, `list`, `get`, `enable`) |
|
||||
| `claude plugin` | Manage Claude Code plugins |
|
||||
| `claude remote-control` | Manage remote control sessions |
|
||||
| `claude setup-token` | Create a long-lived token for subscription usage |
|
||||
| `claude update` / `claude upgrade` | Update to the latest version |
|
||||
|
||||
---
|
||||
|
||||
@@ -206,7 +212,7 @@ These startup-only environment variables are set in your shell before launching
|
||||
| `CLAUDE_CODE_TMPDIR` | Override temp directory for internal files |
|
||||
| `CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1` | Enable additional directory CLAUDE.md loading |
|
||||
| `DISABLE_AUTOUPDATER=1` | Disable auto-updates |
|
||||
| `CLAUDE_CODE_EFFORT_LEVEL` | Control thinking depth: `low`, `medium`, `high` |
|
||||
| `CLAUDE_CODE_EFFORT_LEVEL` | Control thinking depth — see [Settings Reference](./claude-settings.md#environment-variables-via-env) |
|
||||
| `USE_BUILTIN_RIPGREP=0` | Use system ripgrep instead of built-in (Alpine Linux) |
|
||||
| `CLAUDE_CODE_SIMPLE` | Enable simple mode (Bash + Edit tools only) |
|
||||
| `CLAUDE_BASH_NO_LOGIN=1` | Skip login shell for BashTool |
|
||||
|
||||
@@ -3,7 +3,7 @@
|
||||
<br>
|
||||
[](../implementation/claude-commands-implementation.md)
|
||||
|
||||
Complete reference for Claude Code commands — command definitions, frontmatter fields, and all built-in slash commands.
|
||||
Complete reference for Claude Code commands — command definitions, frontmatter fields, and current built-in slash commands.
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
@@ -113,47 +113,64 @@ Built-in slash commands available in Claude Code's interactive mode:
|
||||
|
||||
| Command | Tag | Description |
|
||||
|---------|-----|-------------|
|
||||
| `/clear` |  | Clear conversation history and start fresh |
|
||||
| `/compact [instructions]` |  | Compress conversation to free context window. Optional instructions focus the compaction |
|
||||
| `/exit` |  | Exit the REPL |
|
||||
| `/fork` |  | Fork the current conversation into a new session |
|
||||
| `/rename <name>` |  | Rename the current session for easier identification |
|
||||
| `/resume [session]` |  | Resume a previous conversation by ID or name, or open the session picker |
|
||||
| `/rewind` |  | Rewind conversation and/or code to an earlier point |
|
||||
| `/teleport` |  | Resume a remote session from claude.ai (subscribers only) |
|
||||
| `/context` |  | Visualize current context usage as a colored grid with token counts |
|
||||
| `/cost` |  | Show token usage statistics and spending for the current session |
|
||||
| `/stats` |  | Visualize daily usage, session history, streaks, and model preferences |
|
||||
| `/usage` |  | Show plan usage limits and rate limit status (subscription plans only) |
|
||||
| `/fast` |  | Toggle fast mode — same Opus 4.6 model with faster output |
|
||||
| `/model` |  | Switch models (haiku, sonnet, opus) and adjust effort level |
|
||||
| `/plan` |  | Enter read-only planning mode — suggests approaches without making changes |
|
||||
| `/init` |  | Initialize a new project with CLAUDE.md guide |
|
||||
| `/memory` |  | View and edit CLAUDE.md memory files (user, project, and local scope) |
|
||||
| `/config` |  | Open the interactive Settings interface with search functionality |
|
||||
| `/keybindings` |  | Customize keyboard shortcuts per context, create chord sequences |
|
||||
| `/permissions` |  | View or update tool permissions |
|
||||
| `/sandbox` |  | Configure sandboxing with dependency status |
|
||||
| `/statusline` |  | Set up Claude Code's status line UI |
|
||||
| `/terminal-setup` |  | Enable shift+enter for newlines in IDE terminals |
|
||||
| `/theme` |  | Change the color theme |
|
||||
| `/vim` |  | Enable vim-style editing mode |
|
||||
| `/add-dir` |  | Add additional working directories to the current session |
|
||||
| `/agents` |  | Manage custom subagents — view, create, edit, delete |
|
||||
| `/hooks` |  | Interactive interface to manage hooks |
|
||||
| `/ide` |  | Connect to IDE integration |
|
||||
| `/mcp` |  | Manage MCP server connections — add, enable, list, get info, OAuth |
|
||||
| `/plugin` |  | Manage plugins — install, uninstall, enable, disable, browse marketplaces |
|
||||
| `/skills` |  | View available skills and their descriptions |
|
||||
| `/debug [description]` |  | Troubleshoot the current session by reading the debug log |
|
||||
| `/bug [description]` |  | Alias for `/feedback` |
|
||||
| `/chrome` |  | Manage Claude in Chrome browser integration |
|
||||
| `/clear` |  | Clear conversation history and start fresh |
|
||||
| `/compact [prompt]` |  | Compress conversation to free context window. Optional prompt focuses the compaction |
|
||||
| `/config` |  | Open the interactive settings interface with search |
|
||||
| `/context` |  | Visualize current context usage as a colored grid with token counts |
|
||||
| `/copy` |  | Copy the last assistant response to the clipboard |
|
||||
| `/cost` |  | Show token usage statistics for the current session |
|
||||
| `/desktop` |  | Connect to or manage the desktop companion app |
|
||||
| `/diff` |  | Review the current git diff in the active repo |
|
||||
| `/doctor` |  | Check the health of your Claude Code installation |
|
||||
| `/feedback` |  | Generate a GitHub issue URL for reporting bugs or feedback |
|
||||
| `/help` |  | Show all available slash commands and usage help |
|
||||
| `/tasks` |  | List and manage background tasks |
|
||||
| `/todos` |  | List current TODO items |
|
||||
| `/copy` |  | Copy the last assistant response to clipboard |
|
||||
| `/exit` |  | Exit the REPL |
|
||||
| `/export [filename]` |  | Export the current conversation to a file or clipboard |
|
||||
| `/extra-usage` |  | Configure pay-as-you-go overflow billing for subscription plans |
|
||||
| `/fast` |  | Toggle fast mode — same Opus 4.6 model with faster output |
|
||||
| `/feedback [description]` |  | Generate a GitHub issue URL for reporting bugs or feedback |
|
||||
| `/fork` |  | Fork the current conversation into a new session |
|
||||
| `/help` |  | Show slash-command help |
|
||||
| `/ide` |  | Connect to IDE integration |
|
||||
| `/init [prompt]` |  | Initialize a new project with a CLAUDE.md guide |
|
||||
| `/install-github-app` |  | Install the GitHub app for PR-linked workflows |
|
||||
| `/install-slack-app` |  | Install the Slack app for notifications and sharing |
|
||||
| `/keybindings` |  | Customize keyboard shortcuts per context and create chord sequences |
|
||||
| `/login` |  | Authenticate with Claude Code via OAuth |
|
||||
| `/logout` |  | Log out from Claude Code |
|
||||
| `/mcp` |  | Manage MCP server connections |
|
||||
| `/memory` |  | View and edit memory files |
|
||||
| `/mobile` |  | Connect to or manage the mobile companion app |
|
||||
| `/model` |  | Switch models (haiku, sonnet, opus) and adjust effort level |
|
||||
| `/output-style` |  | Pick an output style preset |
|
||||
| `/passes [number]` |  | Set the number of review passes for certain workflows |
|
||||
| `/permissions` |  | View or update tool permissions |
|
||||
| `/plan` |  | Enter read-only planning mode — suggests approaches without making changes |
|
||||
| `/pr-comments` |  | Review or reply to pull-request comments |
|
||||
| `/privacy-settings` |  | Manage privacy and telemetry preferences |
|
||||
| `/release-notes` |  | Show recent Claude Code release notes |
|
||||
| `/reload-plugins` |  | Reload installed plugins without restarting |
|
||||
| `/remote-control` |  | Continue the current session from another device |
|
||||
| `/remote-env` |  | Inspect or copy the remote-control environment setup |
|
||||
| `/rename <name>` |  | Rename the current session for easier identification |
|
||||
| `/resume [session]` |  | Resume a previous conversation by ID or name, or open the session picker |
|
||||
| `/review` |  | Review the current code changes |
|
||||
| `/rewind` |  | Rewind conversation and/or code to an earlier point |
|
||||
| `/sandbox` |  | Configure sandboxing with dependency status |
|
||||
| `/security-review` |  | Run a focused security review on current changes |
|
||||
| `/status` |  | Show a concise session status summary |
|
||||
| `/stats` |  | Visualize daily usage, session history, streaks, and model preferences |
|
||||
| `/statusline` |  | Set up Claude Code's status line UI |
|
||||
| `/stickers` |  | Choose sticker packs shown in the UI |
|
||||
| `/tasks` |  | List and manage background tasks |
|
||||
| `/terminal-setup` |  | Enable shift+enter for newlines in IDE terminals |
|
||||
| `/theme` |  | Change the color theme |
|
||||
| `/usage` |  | Show plan usage limits and rate limit status (subscription plans only) |
|
||||
| `/vim` |  | Enable vim-style editing mode |
|
||||
|
||||
Bundled skills such as `/debug` can also appear in the slash-command menu, but they are not built-in commands.
|
||||
|
||||
### Commands in This Repository
|
||||
|
||||
@@ -162,7 +179,9 @@ Custom commands defined in `.claude/commands/` for this project:
|
||||
| Command | Description | Model |
|
||||
|---------|-------------|-------|
|
||||
| [`weather-orchestrator`](../.claude/commands/weather-orchestrator.md) | Fetch weather data for Dubai and create an SVG weather card | haiku |
|
||||
| [`workflows/best-practice/workflow-claude-settings`](../.claude/commands/workflows/best-practice/workflow-claude-settings.md) | Track Claude Code settings report changes and find what needs updating | — |
|
||||
| [`workflows/best-practice/workflow-claude-subagents`](../.claude/commands/workflows/best-practice/workflow-claude-subagents.md) | Track Claude Code subagents report changes and find what needs updating | — |
|
||||
| [`workflows/best-practice/workflow-concepts`](../.claude/commands/workflows/best-practice/workflow-concepts.md) | Update the README CONCEPTS section with the latest Claude Code features and concepts | — |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -66,6 +66,19 @@ MCP servers are configured in `.mcp.json` at the project root (project-scoped) o
|
||||
}
|
||||
```
|
||||
|
||||
Use environment variable expansion for secrets instead of committing API keys in `.mcp.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"remote-api": {
|
||||
"type": "http",
|
||||
"url": "https://mcp.example.com/mcp?token=${MCP_API_TOKEN}"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Settings for MCP Servers
|
||||
|
||||
These settings in `.claude/settings.json` control MCP server approval:
|
||||
|
||||
@@ -1,8 +1,8 @@
|
||||
# Claude Code Settings Reference
|
||||
|
||||
 
|
||||
 
|
||||
|
||||
A comprehensive guide to all available configuration options in Claude Code's `settings.json` files. As of v2.1.69, Claude Code exposes **55+ settings** and **110+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts).
|
||||
A comprehensive guide to all available configuration options in Claude Code's `settings.json` files. As of v2.1.71, Claude Code exposes **55+ settings** and **140+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts).
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
@@ -65,7 +65,7 @@ Claude Code settings use a 5-level user-writable override chain plus an enforced
|
||||
| `skipWebFetchPreflight` | boolean | `false` | Skip WebFetch blocklist check before fetching URLs |
|
||||
| `availableModels` | array | - | Restrict models available to users (managed settings). Each entry has `title`, `modelId`, and optional `effortOptions` |
|
||||
| `fastModePerSessionOptIn` | boolean | `false` | Require users to opt in to fast mode each session |
|
||||
| `teammateMode` | boolean | `false` | Enable teammate mode for multi-agent collaboration |
|
||||
| `teammateMode` | string | `"auto"` | Agent team display mode: `"auto"` (split panes in tmux/iTerm2, in-process otherwise), `"in-process"`, or `"tmux"` |
|
||||
| `includeGitInstructions` | boolean | `true` | Include git-related instructions in system prompt |
|
||||
|
||||
**Example:**
|
||||
@@ -86,7 +86,7 @@ Store plan files in a custom location relative to project root.
|
||||
|
||||
| Key | Type | Default | Description |
|
||||
|-----|------|---------|-------------|
|
||||
| `plansDirectory` | string | `.claude/plans/` | Directory where `/plan` outputs are stored |
|
||||
| `plansDirectory` | string | `~/.claude/plans` | Directory where `/plan` outputs are stored |
|
||||
|
||||
**Example:**
|
||||
```json
|
||||
@@ -188,6 +188,7 @@ Control what tools and operations Claude can perform.
|
||||
| `permissions.additionalDirectories` | array | Extra directories Claude can access |
|
||||
| `permissions.defaultMode` | string | Default permission mode |
|
||||
| `permissions.disableBypassPermissionsMode` | string | Prevent bypass mode activation |
|
||||
| `allowManagedPermissionRulesOnly` | boolean | **(Managed only)** Only managed permission rules apply; user/project `allow`, `ask`, `deny` rules are ignored |
|
||||
|
||||
### Permission Modes
|
||||
|
||||
@@ -328,7 +329,7 @@ Configure bash command sandboxing for security.
|
||||
| `sandbox.filesystem.allowWrite` | array | `[]` | Path prefixes where write is allowed. Prefix: `//` (absolute), `~/` (home), `/` (project root), `./` (cwd) |
|
||||
| `sandbox.filesystem.denyWrite` | array | `[]` | Path prefixes where write is denied |
|
||||
| `sandbox.filesystem.denyRead` | array | `[]` | Path prefixes where read is denied |
|
||||
| `sandbox.enableWeakerNetworkIsolation` | boolean | `false` | Weaker network isolation for environments with limited sandboxing |
|
||||
| `sandbox.enableWeakerNetworkIsolation` | boolean | `false` | (macOS only) Allow access to system TLS trust (`com.apple.trustd.agent`); reduces security |
|
||||
|
||||
**Example:**
|
||||
```json
|
||||
@@ -357,7 +358,7 @@ Configure Claude Code plugins and marketplaces.
|
||||
| Key | Type | Scope | Description |
|
||||
|-----|------|-------|-------------|
|
||||
| `enabledPlugins` | object | Any | Enable/disable specific plugins |
|
||||
| `extraKnownMarketplaces` | object | Any | Add custom plugin marketplaces |
|
||||
| `extraKnownMarketplaces` | object | Project | Add custom plugin marketplaces (team sharing via `.claude/settings.json`) |
|
||||
| `strictKnownMarketplaces` | array | Managed only | Allowlist of permitted marketplaces |
|
||||
| `skippedMarketplaces` | array | Any | Marketplaces user declined to install |
|
||||
| `skippedPlugins` | array | Any | Plugins user declined to install |
|
||||
@@ -607,6 +608,36 @@ Set environment variables for all Claude Code sessions.
|
||||
| `CLAUDE_CODE_PROMPT_CACHING_ENABLED` | Override prompt caching behavior |
|
||||
| `CLAUDE_CODE_DISABLE_TOOLS` | Comma-separated list of tools to disable |
|
||||
| `CLAUDE_CODE_DISABLE_MCP` | Disable all MCP servers (`1` to disable) |
|
||||
| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Max output tokens per response (default: 32000, max: 64000) |
|
||||
| `CLAUDE_CODE_DISABLE_FAST_MODE` | Disable fast mode entirely (`1` to disable) |
|
||||
| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Disable auto memory (`1` to disable) |
|
||||
| `CLAUDE_CODE_USER_EMAIL` | Provide user email synchronously for authentication |
|
||||
| `CLAUDE_CODE_ORGANIZATION_UUID` | Provide organization UUID synchronously for authentication |
|
||||
| `CLAUDE_CONFIG_DIR` | Custom config directory (overrides default `~/.claude`) |
|
||||
| `ANTHROPIC_CUSTOM_HEADERS` | Custom headers for API requests (JSON string) |
|
||||
| `ANTHROPIC_FOUNDRY_API_KEY` | API key for Microsoft Foundry authentication |
|
||||
| `ANTHROPIC_FOUNDRY_BASE_URL` | Base URL for Foundry resource |
|
||||
| `ANTHROPIC_FOUNDRY_RESOURCE` | Foundry resource name |
|
||||
| `AWS_BEARER_TOKEN_BEDROCK` | Bedrock API key for authentication |
|
||||
| `ANTHROPIC_SMALL_FAST_MODEL` | **DEPRECATED** — Use `ANTHROPIC_DEFAULT_HAIKU_MODEL` instead |
|
||||
| `ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION` | AWS region for deprecated Haiku-class model override |
|
||||
| `CLAUDE_CODE_SHELL_PREFIX` | Command prefix prepended to bash commands |
|
||||
| `BASH_DEFAULT_TIMEOUT_MS` | Default bash command timeout in ms |
|
||||
| `CLAUDE_CODE_SKIP_BEDROCK_AUTH` | Skip AWS auth for Bedrock (`1` to skip) |
|
||||
| `CLAUDE_CODE_SKIP_FOUNDRY_AUTH` | Skip Azure auth for Foundry (`1` to skip) |
|
||||
| `CLAUDE_CODE_SKIP_VERTEX_AUTH` | Skip Google auth for Vertex (`1` to skip) |
|
||||
| `CLAUDE_CODE_PROXY_RESOLVES_HOSTS` | Allow proxy to perform DNS resolution |
|
||||
| `CLAUDE_CODE_API_KEY_HELPER_TTL_MS` | Credential refresh interval in ms for `apiKeyHelper` |
|
||||
| `CLAUDE_CODE_CLIENT_CERT` | Client certificate path for mTLS |
|
||||
| `CLAUDE_CODE_CLIENT_KEY` | Client private key path for mTLS |
|
||||
| `CLAUDE_CODE_CLIENT_KEY_PASSPHRASE` | Passphrase for encrypted mTLS key |
|
||||
| `CLAUDE_CODE_PLUGIN_GIT_TIMEOUT_MS` | Plugin marketplace git clone timeout in ms (default: 120000) |
|
||||
| `CLAUDE_CODE_HIDE_ACCOUNT_INFO` | Hide email/org info from UI |
|
||||
| `CLAUDE_CODE_DISABLE_CRON` | Disable scheduled/cron tasks (`1` to disable) |
|
||||
| `DISABLE_INSTALLATION_CHECKS` | Disable installation warnings |
|
||||
| `DISABLE_BUG_COMMAND` | Disable the `/bug` command |
|
||||
| `DISABLE_NON_ESSENTIAL_MODEL_CALLS` | Disable flavor text and non-essential model calls |
|
||||
| `DISABLE_COST_WARNINGS` | Disable cost warning messages |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -147,7 +147,7 @@ Skills defined in `.claude/skills/` for this project:
|
||||
| Skill | User-Invocable | Preloaded Into | Description |
|
||||
|-------|----------------|----------------|-------------|
|
||||
| [`weather-svg-creator`](../.claude/skills/weather-svg-creator/SKILL.md) | Yes | — | Creates SVG weather card and writes output files |
|
||||
| [`weather-fetcher`](../.claude/skills/weather-fetcher/SKILL.md) | No | `weather-agent` | Fetches current temperature from wttr.in API |
|
||||
| [`weather-fetcher`](../.claude/skills/weather-fetcher/SKILL.md) | No | `weather-agent` | Fetches current temperature from Open-Meteo |
|
||||
| [`agent-browser`](../.claude/skills/agent-browser/SKILL.md) | Yes | — | Browser automation CLI for AI agents |
|
||||
| [`presentation/vibe-to-agentic-framework`](../.claude/skills/presentation/vibe-to-agentic-framework/SKILL.md) | Yes | `presentation-curator` | Conceptual framework behind the presentation |
|
||||
| [`presentation/presentation-structure`](../.claude/skills/presentation/presentation-structure/SKILL.md) | Yes | `presentation-curator` | Slide format, weight system, and section structure |
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Sub-agents Best Practice
|
||||
|
||||
<br>
|
||||
<br>
|
||||
[](../implementation/claude-subagents-implementation.md)
|
||||
|
||||
Complete reference for Claude Code subagents — built-in agent types, custom agent definitions, and frontmatter fields.
|
||||
@@ -20,14 +20,14 @@ Complete reference for Claude Code subagents — built-in agent types, custom ag
|
||||
|-------|------|----------|-------------|
|
||||
| `name` | string | Yes | Unique identifier using lowercase letters and hyphens |
|
||||
| `description` | string | Yes | When to invoke. Use `"PROACTIVELY"` for auto-invocation by Claude |
|
||||
| `tools` | string/list | No | Comma-separated allowlist of tools (e.g., `Read, Write, Edit, Bash`). Inherits all tools if omitted. Supports `Task(agent_type)` syntax to restrict spawnable subagents |
|
||||
| `tools` | string/list | No | Comma-separated allowlist of tools (e.g., `Read, Write, Edit, Bash`). Inherits all tools if omitted. Supports `Agent(agent_type)` syntax to restrict spawnable subagents; the older `Task(agent_type)` alias still works |
|
||||
| `disallowedTools` | string/list | No | Tools to deny, removed from inherited or specified list |
|
||||
| `model` | string | No | Model alias: `haiku`, `sonnet`, `opus`, or `inherit` (default: `inherit`) |
|
||||
| `permissionMode` | string | No | Permission mode: `default`, `acceptEdits`, `dontAsk`, `bypassPermissions`, or `plan` |
|
||||
| `maxTurns` | integer | No | Maximum number of agentic turns before the subagent stops |
|
||||
| `skills` | list | No | Skill names to preload into agent context at startup (full content injected, not just made available) |
|
||||
| `mcpServers` | list | No | MCP servers for this subagent — server name strings or inline `{name: config}` objects |
|
||||
| `hooks` | object | No | Lifecycle hooks scoped to this subagent: `PreToolUse`, `PostToolUse`, `Stop` (converted to `SubagentStop` at runtime) |
|
||||
| `hooks` | object | No | Lifecycle hooks scoped to this subagent. All hook events are supported; `PreToolUse`, `PostToolUse`, and `Stop` are the most common |
|
||||
| `memory` | string | No | Persistent memory scope: `user`, `project`, or `local` |
|
||||
| `background` | boolean | No | Set to `true` to always run as a background task (default: `false`) |
|
||||
| `isolation` | string | No | Set to `"worktree"` to run in a temporary git worktree (auto-cleaned if no changes) |
|
||||
@@ -43,22 +43,23 @@ Complete reference for Claude Code subagents — built-in agent types, custom ag
|
||||
| `project` | `.claude/agent-memory/<name>/` | Yes | Yes |
|
||||
| `local` | `.claude/agent-memory-local/<name>/` | No | No |
|
||||
|
||||
See [claude-agent-memory.md](../claude-agent-memory.md) for full details.
|
||||
See [claude-agent-memory.md](../reports/claude-agent-memory.md) for full details.
|
||||
|
||||
---
|
||||
|
||||
## Invocation
|
||||
|
||||
Agents are invoked via the **Task tool**, never via bash commands:
|
||||
Agents are invoked via the **Agent tool** (renamed from Task in v2.1.63; `Task(...)` still works as an alias):
|
||||
|
||||
```
|
||||
Task(subagent_type="agent-name", description="...", prompt="...", model="haiku")
|
||||
Agent(subagent_type="agent-name", description="...", prompt="...", model="haiku")
|
||||
```
|
||||
|
||||
Other invocation and management methods:
|
||||
|
||||
| Method | Description |
|
||||
|--------|-------------|
|
||||
| `--agent <name>` CLI flag | Run Claude Code as a specific agent for the entire session (overrides the `agent` setting) |
|
||||
| `--agents '{...}'` CLI flag | Define session-scoped agents via JSON (accepts `description`, `prompt`, `tools`, `model`, etc.) |
|
||||
| `claude agents` CLI command | List all configured agents grouped by source (added v2.1.51) |
|
||||
| `/agents` interactive command | Create, edit, and manage agents interactively |
|
||||
@@ -86,7 +87,7 @@ Review the code for quality issues and report findings.
|
||||
---
|
||||
name: deploy-manager
|
||||
description: Use this agent PROACTIVELY for deployment pipelines and release management
|
||||
tools: Read, Write, Edit, Bash, Grep, Glob, Task(monitor, rollback)
|
||||
tools: Read, Write, Edit, Bash, Grep, Glob, Agent(monitor, rollback)
|
||||
disallowedTools: NotebookEdit
|
||||
model: sonnet
|
||||
permissionMode: acceptEdits
|
||||
@@ -144,15 +145,15 @@ When multiple subagents share the same name, the higher-priority location wins:
|
||||
|
||||
### Official Claude Agents
|
||||
|
||||
Built-in agent types available via `subagent_type` in the Task tool:
|
||||
Built-in agent types available in current Claude Code installs:
|
||||
|
||||
| Agent | Model | Tools | Description |
|
||||
|-------|-------|-------|-------------|
|
||||
| `general-purpose` | inherit | All | Complex multi-step tasks — the default agent type for research, code search, and autonomous work |
|
||||
| `Explore` | haiku | Read-only (no Write, Edit) | Fast codebase search and exploration — optimized for finding files, searching code, and answering codebase questions |
|
||||
| `Plan` | inherit | Read-only (no Write, Edit) | Pre-planning research in plan mode — explores the codebase and designs implementation approaches before writing code |
|
||||
| `claude-code-guide` | inherit | Glob, Grep, Read, WebFetch, WebSearch | Answers questions about Claude Code features, hooks, slash commands, MCP servers, settings, IDE integrations, and keyboard shortcuts |
|
||||
| `statusline-setup` | inherit | Read, Edit | Configures the user's Claude Code status line setting |
|
||||
| `Bash` | inherit | Bash | Running terminal commands in a separate context |
|
||||
| `statusline-setup` | sonnet | Read, Edit | Configures the user's Claude Code status line setting |
|
||||
|
||||
### Agents in This Repository
|
||||
|
||||
@@ -161,8 +162,10 @@ Custom agents defined in `.claude/agents/` for this project:
|
||||
| Agent | Model | Color | Tools | Skills | Memory |
|
||||
|-------|-------|-------|-------|--------|--------|
|
||||
| [`presentation-curator`](../.claude/agents/presentation-curator.md) | sonnet | magenta | Read, Write, Edit, Grep, Glob | presentation/vibe-to-agentic-framework, presentation/presentation-structure, presentation/presentation-styling | — |
|
||||
| [`weather-agent`](../.claude/agents/weather-agent.md) | sonnet | teal | WebFetch, Read, Write, Edit | weather-fetcher | project |
|
||||
| [`weather-agent`](../.claude/agents/weather-agent.md) | sonnet | green | WebFetch, Read, Write, Edit | weather-fetcher | project |
|
||||
| [`workflow-claude-settings-agent`](../.claude/agents/workflows/best-practice/workflow-claude-settings-agent.md) | opus | yellow | All (inherited) | — | — |
|
||||
| [`workflow-claude-subagents-agent`](../.claude/agents/workflows/best-practice/workflow-claude-subagents-agent.md) | opus | blue | All (inherited) | — | — |
|
||||
| [`workflow-concepts-agent`](../.claude/agents/workflows/best-practice/workflow-concepts-agent.md) | opus | green | All (inherited) | — | — |
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user