claude-code-best-practice/best-practice/claude-commands.md

Commands Best Practice

Claude Code commands — frontmatter fields and official built-in slash commands.

← Back to Claude Code Best Practice

---

Frontmatter Fields (13)

Field	Type	Required	Description
name	string	No	Display name and /slash-command identifier. Defaults to the directory name if omitted
description	string	Recommended	What the command does. Shown in autocomplete and used by Claude for auto-discovery
argument-hint	string	No	Hint shown during autocomplete (e.g., [issue-number], [filename])
disable-model-invocation	boolean	No	Set true to prevent Claude from automatically invoking this command
user-invocable	boolean	No	Set false to hide from the / menu — command becomes background knowledge only
paths	string/list	No	Glob patterns that limit when this skill is activated. Accepts a comma-separated string or a YAML list. When set, Claude loads the skill automatically only when working with files matching the patterns
allowed-tools	string	No	Tools allowed without permission prompts when this command is active
model	string	No	Model to use when this command runs (e.g., haiku, sonnet, opus)
effort	string	No	Override the model effort level when invoked (low, medium, high, max)
context	string	No	Set to fork to run the command in an isolated subagent context
agent	string	No	Subagent type when context: fork is set (default: general-purpose)
shell	string	No	Shell for !`command` blocks — accepts bash (default) or powershell. Requires CLAUDE_CODE_USE_POWERSHELL_TOOL=1
hooks	object	No	Lifecycle hooks scoped to this command

---

(69)

#	Command	Tag	Description
1	/login		Sign in to your Anthropic account
2	/logout		Sign out from your Anthropic account
3	/setup-bedrock		Configure Amazon Bedrock authentication, region, and model pins through an interactive wizard. Only visible when CLAUDE_CODE_USE_BEDROCK=1 is set. First-time Bedrock users can also access this wizard from the login screen
4	/setup-vertex		Configure Google Vertex AI authentication, project, region, and model pins through an interactive wizard. Only visible when CLAUDE_CODE_USE_VERTEX=1 is set. First-time Vertex AI users can also access this wizard from the login screen
5	/upgrade		Open the upgrade page to switch to a higher plan tier
6	/color [color|default]		Set the prompt bar color for the current session. Available colors: red, blue, green, yellow, purple, orange, pink, cyan. Use default to reset
7	/config		Open the Settings interface to adjust theme, model, output style, and other preferences. Alias: /settings
8	/keybindings		Open or create your keybindings configuration file
9	/permissions		Manage allow, ask, and deny rules for tool permissions. Opens an interactive dialog where you can view rules by scope, add or remove rules, manage working directories, and review recent auto mode denials. Alias: /allowed-tools
10	/privacy-settings		View and update your privacy settings. Only available for Pro and Max plan subscribers
11	/sandbox		Toggle sandbox mode. Available on supported platforms only
12	/statusline		Configure Claude Code's status line. Describe what you want, or run without arguments to auto-configure from your shell prompt
13	/stickers		Order Claude Code stickers
14	/terminal-setup		Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Alacritty, or Warp
15	/theme		Change the color theme. Includes light and dark variants, colorblind-accessible (daltonized) themes, and ANSI themes that use your terminal's color palette
16	/voice		Toggle push-to-talk voice dictation. Requires a Claude.ai account
17	/context		Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings
18	/cost		Show token usage statistics. See cost tracking guide for subscription-specific details
19	/extra-usage		Configure extra usage to keep working when rate limits are hit
20	/insights		Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points
21	/stats		Visualize daily usage, session history, streaks, and model preferences
22	/status		Open the Settings interface (Status tab) showing version, model, account, and connectivity. Works while Claude is responding, without waiting for the current response to finish
23	/usage		Show plan usage limits and rate limit status
24	/doctor		Diagnose and verify your Claude Code installation and settings
25	/feedback [report]		Submit feedback about Claude Code. Alias: /bug
26	/help		Show help and available commands
27	/powerup		Discover Claude Code features through quick interactive lessons with animated demos
28	/release-notes		View the changelog in an interactive version picker. Select a specific version to see its release notes, or choose to show all versions
29	/tasks		List and manage background tasks. Alias: /bashes
30	/copy [N]		Copy the last assistant response to clipboard. Pass a number N to copy the Nth-latest response: /copy 2 copies the second-to-last. When code blocks are present, shows an interactive picker to select individual blocks or the full response. Press w in the picker to write the selection to a file instead of the clipboard, which is useful over SSH
31	/export [filename]		Export the current conversation as plain text. With a filename, writes directly to that file. Without, opens a dialog to copy to clipboard or save to a file
32	/agents		Manage agent configurations
33	/chrome		Configure Claude in Chrome settings
34	/hooks		View hook configurations for tool events
35	/ide		Manage IDE integrations and show status
36	/mcp		Manage MCP server connections and OAuth authentication
37	/plugin		Manage Claude Code plugins
38	/reload-plugins		Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors
39	/skills		List available skills
40	/memory		Edit CLAUDE.md memory files, enable or disable auto-memory, and view auto-memory entries
41	/effort [low|medium|high|max|auto]		Set the model effort level. low, medium, and high persist across sessions. max applies to the current session only and requires Opus 4.6. auto resets to the model default. Without an argument, shows the current level. Takes effect immediately without waiting for the current response to finish
42	/fast [on|off]		Toggle fast mode on or off
43	/model [model]		Select or change the AI model. For models that support it, use left/right arrows to adjust effort level. The change takes effect immediately without waiting for the current response to finish
44	/passes		Share a free week of Claude Code with friends. Only visible if your account is eligible
45	/plan [description]		Enter plan mode directly from the prompt. Pass an optional description to enter plan mode and immediately start with that task, for example /plan fix the auth bug
46	/ultraplan <prompt>		Draft a plan in an ultraplan session, review it in your browser, then execute remotely or send it back to your terminal
47	/add-dir <path>		Add a working directory for file access during the current session. Most .claude/ configuration is not discovered from the added directory
48	/diff		Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use left/right arrows to switch between the current git diff and individual Claude turns, and up/down to browse files
49	/init		Initialize project with a CLAUDE.md guide. Set CLAUDE_CODE_NEW_INIT=1 for an interactive flow that also walks through skills, hooks, and personal memory files
50	/review		Deprecated. Install the code-review plugin instead: claude plugin install code-review@claude-plugins-official
51	/security-review		Analyze pending changes on the current branch for security vulnerabilities. Reviews the git diff and identifies risks like injection, auth issues, and data exposure
52	/autofix-pr [prompt]		Spawn a Claude Code on the web session that watches the current branch's PR and pushes fixes when CI fails or reviewers leave comments. Detects the open PR from your checked-out branch with gh pr view; to watch a different PR, check out its branch first. Requires the gh CLI and access to Claude Code on the web
53	/desktop		Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: /app
54	/install-github-app		Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration
55	/install-slack-app		Install the Claude Slack app. Opens a browser to complete the OAuth flow
56	/mobile		Show QR code to download the Claude mobile app. Aliases: /ios, /android
57	/remote-control		Make this session available for remote control from claude.ai. Alias: /rc
58	/remote-env		Configure the default remote environment for web sessions started with --remote
59	/schedule [description]		Create, update, list, or run Cloud scheduled tasks. Claude walks you through the setup conversationally
60	/teleport		Pull a Claude Code on the web session into this terminal: opens a picker, then fetches the branch and conversation. Also available as /tp. Requires a claude.ai subscription
61	/web-setup		Connect your GitHub account to Claude Code on the web using your local gh CLI credentials. /schedule prompts for this automatically if GitHub is not connected
62	/branch [name]		Create a branch of the current conversation at this point. Alias: /fork
63	/btw <question>		Ask a quick side question without adding to the conversation
64	/clear		Clear conversation history and free up context. Aliases: /reset, /new
65	/compact [instructions]		Compact conversation with optional focus instructions
66	/exit		Exit the CLI. Alias: /quit
67	/rename [name]		Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history
68	/resume [session]		Resume a conversation by ID or name, or open the session picker. Alias: /continue
69	/rewind		Rewind the conversation and/or code to a previous point, or summarize from a selected message. See checkpointing. Alias: /checkpoint

Bundled skills such as /debug can also appear in the slash-command menu, but they are not built-in commands.

---

Sources

• Claude Code Slash Commands
• Claude Code Interactive Mode
• Claude Code CHANGELOG