Claude Code 内置命令参考指南

前言

Claude Code 提供了丰富的内置命令(slash commands),涵盖项目管理、代码审查、MCP 集成、子代理等多个方面。本文详细介绍所有内置命令的用法,特别关注 Agent 与 MCP 相关功能。

命令概览

在 Claude Code 中输入 / 即可看到所有可用命令。下面按功能分类说明。

Agent 与子代理

/agents — 管理子代理配置

查看和配置子代理(subagent)。子代理是运行在独立上下文中的专业 AI 助手,拥有独立的工具访问权限和系统提示词。

1
2
# 查看所有配置的子代理
/agents

配置示例(.claude/agents/ 目录下):

1
2
3
4
5
6
7
8
{
"description": "When Claude should delegate to this subagent",
"prompt": "Instructions for the subagent",
"model": "haiku",
"tools": ["Read", "Glob", "Grep"],
"mcpServers": ["github"],
"permissionMode": "plan"
}

子代理主要用途:

  • 保持上下文分离 — 保持探索和实现各自独立
  • 限制工具访问 — 控制子代理能使用哪些工具
  • 复用配置 — 通过用户级子代理实现
  • 专门化行为 — 通过专注的系统提示词
  • 控制成本 — 路由到更快/更便宜的模型(如 Haiku)

CLI 命令:claude agents

通过终端查看子代理:

1
claude agents

Agent 相关配置字段

字段 说明
description 何时应委托给此子代理
prompt 子代理的指令
model 使用的模型(default/sonnet/opus/haiku)
tools 子代理可访问的工具
allowedAgents 限制哪些主代理可以启动此子代理
mcpServers 作用域到此子代理的 MCP 服务器
permissionMode 权限模式(default/acceptEdits/plan)
skills 预加载到子代理的技能
memoryEnabled 启用持久化内存

MCP(Model Context Protocol)

/mcp — 管理 MCP 服务器

连接和管理 MCP 服务器。MCP 是一种让 AI 与外部工具和服务交互的协议。

1
2
# 启动 MCP 配置
/mcp

MCP 服务器类型

类型 说明
Remote HTTP Server 连接基于 HTTP 的 MCP 服务器
Remote SSE Server 连接 Server-Sent Events MCP 服务器
Local stdio Server 通过 stdio 运行本地 MCP 服务器

MCP 安装作用域

作用域 说明
Local 仅当前项目可用
Project 项目级别(.mcp.json
User 全局用户级别

MCP 核心特性

  • 动态工具更新 — 工具出现/消失无需重启
  • 推送消息与频道 — 实时通知
  • 插件提供的 MCP 服务器 — 通过插件扩展
  • MCP 资源 — 引用文件内容和数据
  • MCP 提示词作为命令 — 格式:/mcp__<server>__<prompt>
  • 工具搜索 — 通过 MCP 工具搜索扩展

CLI 命令:claude mcp

1
2
# 配置 MCP 服务器
claude mcp

计划与执行

/plan — 进入计划模式

直接进入计划模式,用于安全地分析代码而不进行编辑。

1
2
/plan                          # 进入计划模式
/plan fix the auth bug # 带描述进入计划模式

使用场景:

  • 分析复杂代码结构
  • 设计实现方案
  • 在不修改代码的情况下思考问题

/compact — 压缩对话

压缩对话历史,并可传入聚焦指令。

1
2
/compact                       # 压缩对话
/compact focus on auth # 压缩并聚焦于认证相关

/rewind — 回溯对话/代码

回溯到之前的某个状态(别名:/checkpoint)。

1
2
/rewind                        # 查看可用回溯点
/rewind 5 # 回溯 5 条消息

权限与安全

/permissions — 管理工具权限

配置工具权限规则(别名:/allowed-tools)。

1
2
3
/permissions                   # 查看当前权限配置
/permissions allow Read # 允许 Read 工具
/permissions deny Bash # 拒绝 Bash 工具

权限模式:

  • allow — 自动允许
  • ask — 每次询问(默认)
  • deny — 自动拒绝

/security-review — 安全审查

分析当前分支的待提交更改,检查安全漏洞(注入、认证问题、数据泄露)。

1
/security-review

/sandbox — 切换沙盒模式

切换沙盒模式,限制文件系统和网络访问。

1
/sandbox

项目管理

/init — 初始化项目

在当前目录初始化带有 CLAUDE.md 引导的项目。

1
/init

/diff — 查看变更

打开交互式差异查看器,查看未提交的更改。

1
/diff

/branch — 创建分支(别名:/fork

创建当前对话的分支/分支。

1
/branch new-feature            # 创建新分支

/resume — 恢复会话(别名:/continue

按 ID 或名称恢复之前的对话。

1
2
/resume my-session             # 按名称恢复
/resume abc123 # 按 ID 恢复

开发者工具

/hooks — 查看钩子配置

查看已配置的钩子事件。

1
/hooks

/terminal-setup — 配置终端

为 VS Code、Alacritty、Warp 等配置终端快捷键。

1
/terminal-setup

/keybindings — 打开/创建快捷键配置

1
/keybindings

/ide — 管理 IDE 集成

1
/ide

系统与配置

/config — 打开设置界面(别名:/settings

1
/config

/status — 查看状态

查看版本、模型、账户信息。

1
/status

/model — 选择模型

1
2
3
/model sonnet                  # 切换到 Sonnet
/model opus # 切换到 Opus
/model haiku # 切换到 Haiku

/effort — 设置模型努力级别

1
2
3
4
5
/effort low                    # 低努力,快速响应
/effort medium # 中等
/effort high # 高努力,深入分析
/effort max # 最大努力
/effort auto # 自动(默认)

/fast — 切换快速模式

1
2
/fast on                       # 开启快速模式
/fast off # 关闭快速模式

/doctor — 诊断安装

诊断和验证 Claude Code 安装状态。

1
/doctor

对话管理

/clear — 清除对话(别名:/reset, /new

1
/clear                         # 清除当前对话

/export — 导出对话

1
2
/export                        # 导出为纯文本
/export my-conversation # 导出为指定文件名

/copy — 复制响应

1
2
/copy                          # 复制最后一条响应
/copy 3 # 复制倒数第 3 条响应

/btw — 快速提问

在不添加到对话历史的情况下快速提问。

1
/btw what does this function do?

/color — 设置提示条颜色

1
2
3
/color                         # 查看可用颜色
/color blue # 设置为蓝色
/color default # 恢复默认

/theme — 更改主题

1
/theme

/rename — 重命名会话

1
/rename new-name                # 重命名当前会话

统计与监控

/cost — 显示令牌使用统计

1
/cost

/usage — 显示计划使用限制

1
/usage

/stats — 可视化每日使用情况

1
/stats

/insights — 生成分析报告

分析你的 Claude Code 使用会话。

1
/insights

技能与插件

/skills — 列出可用技能

1
/skills

内置技能包括:

技能 用途
/simplify 审查更改的代码,复用、质量、效率
/batch 并行研究并执行大规模更改
/debug 启用调试日志并诊断问题
/loop 按间隔重复运行命令

/plugin — 管理插件

1
2
/plugin                        # 查看已安装插件
/plugin install <name> # 安装插件

/reload-plugins — 重载插件

1
/reload-plugins

云端功能

/schedule — 管理云端计划任务

创建、更新、列出和运行云端计划任务。

1
2
/schedule                      # 查看计划任务
/schedule "描述" # 创建新任务

/remote-control — 远程控制(别名:/rc

claude.ai 启用远程控制。

1
/remote-control

/remote-env — 配置远程环境

为 Web 会话配置默认远程环境。

1
/remote-env

其他命令

命令 说明
/help 显示帮助
/login 登录 Anthropic 账户
/logout 登出账户
/exit / /quit 退出 CLI
/add-dir 添加工作目录
/context 可视化当前上下文使用
/add-dir 添加工作目录
/feedback 提交反馈(别名:/bug
/insights 生成会话分析报告
/install-github-app 设置 GitHub Actions 应用
/install-slack-app 安装 Slack 应用
/mobile 显示移动端下载二维码(别名:/ios, /android
/powerup 通过互动课程发现功能
/privacy-settings 查看/更新隐私设置(Pro/Max)
/release-notes 查看更新日志
/tasks 列出后台任务(别名:/bashes
/upgrade 打开升级页面
/voice 切换语音听写
/extra-usage 配置额外使用量
/desktop 切换到桌面应用

交互模式快捷键

常规控制

快捷键 动作
Ctrl+C 取消当前输入或生成
Ctrl+D 退出会话
Ctrl+G / Ctrl+X Ctrl+E 在默认文本编辑器中打开
Ctrl+L 重绘屏幕
Ctrl+O 切换详细输出
Ctrl+R 反向搜索命令历史
Ctrl+B 后台运行任务
Ctrl+T 切换任务列表
Esc+Esc 回溯或总结
Shift+Tab 循环切换权限模式
Option+P / Alt+P 切换模型
Option+T 切换扩展思考
Option+O 切换快速模式

文本编辑

快捷键 动作
Ctrl+K 删除到行尾
Ctrl+U 从光标删除到行首
Ctrl+Y 粘贴删除的文本
Alt+B / Alt+F 光标向前/后移动一个单词

命令前缀

前缀 动作
/ 在开头 命令或技能
! 在开头 直接执行 Bash
@ 文件路径提及

CLI 命令参考

命令 说明
claude 启动交互式会话
claude "query" 带初始提示启动
claude -p "query" 通过 SDK 查询后退出
claude -c 继续最近的对话
claude -r "<session>" "query" 按 ID 或名称恢复会话
claude update 更新到最新版本
claude auth login/logout/status 认证管理
claude agents 列出配置的子代理
claude mcp 配置 MCP 服务器
claude plugin 管理插件
claude remote-control 启动远程控制服务器

参考链接

结语

Claude Code 的内置命令系统非常强大,熟练掌握这些命令可以大幅提升开发效率。特别是 Agent 和 MCP 功能,为构建专业化的 AI 编程工作流提供了坚实基础。


如有问题,欢迎留言交流!