Shayan Rais
12 KiB
12 KiB
Commands Best Practice
Complete reference for Claude Code commands — command definitions, frontmatter fields, and current built-in slash commands.
| ← Back to Claude Code Best Practice |  |
Frontmatter Fields
Custom commands are defined in .claude/commands/<name>.md with optional YAML frontmatter.
| Field | Type | Required | Description |
|---|---|---|---|
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]) |
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) |
String Substitutions
Available inside command markdown for dynamic values:
| Variable | Description |
|---|---|
$ARGUMENTS |
All arguments passed when invoking the command |
$ARGUMENTS[N] |
Access a specific argument by 0-based index |
$N |
Shorthand for $ARGUMENTS[N] (e.g., $0, $1) |
${CLAUDE_SESSION_ID} |
Current session identifier |
!`command` |
Dynamic context injection — shell command output replaces the placeholder before Claude sees it |
Invocation
Custom commands are invoked by typing /command-name in Claude Code's interactive mode:
| Method | Description |
|---|---|
/command-name |
Invoke directly from the command menu |
/command-name [args] |
Pass arguments that map to $ARGUMENTS |
| Autocomplete | Type / to see all available commands with descriptions |
| Subdirectories | Commands in subdirectories use /subdir:command-name |
Example: Minimal Command
---
description: Fetch weather data for Dubai and create an SVG weather card
model: haiku
---
Fetch the current temperature for Dubai, UAE and create a visual SVG weather card.
Example: Full-Featured Command (All Fields)
---
description: Fix a GitHub issue by number, following team coding standards
argument-hint: [issue-number]
allowed-tools: Read, Edit, Write, Bash(gh *), Bash(npm test *)
model: sonnet
---
Fix GitHub issue $0 following our coding standards.
## Context
- PR diff: !`gh pr diff`
- Issue details: !`gh issue view $0`
## Steps
1. Read the issue description
2. Understand the requirements
3. Implement the fix
4. Write tests
5. Create a commit
Session: ${CLAUDE_SESSION_ID}
Scope and Priority
When multiple commands share the same name, the higher-priority location wins:
| Location | Scope | Priority |
|---|---|---|
Project (.claude/commands/) |
This project only | 1 (highest) |
Personal (~/.claude/commands/) |
All your projects | 2 |
Plugin (<plugin>/commands/) |
Where plugin is enabled | 3 (lowest) |
Claude Commands
All Commands
Built-in slash commands available in Claude Code's interactive mode:
| Command | Tag | Description |
|---|---|---|
/add-dir |
 |
Add additional working directories to the current session |
/agents |
 |
Manage custom subagents — view, create, edit, delete |
/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 |
/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
Custom commands defined in .claude/commands/ for this project:
| Command | Description | Model |
|---|---|---|
weather-orchestrator |
Fetch weather data for Dubai and create an SVG weather card | haiku |
workflows/best-practice/workflow-claude-settings |
Track Claude Code settings report changes and find what needs updating | — |
workflows/best-practice/workflow-claude-subagents |
Track Claude Code subagents report changes and find what needs updating | — |
workflows/best-practice/workflow-concepts |
Update the README CONCEPTS section with the latest Claude Code features and concepts | — |