Claude Code Command 指南
概述
Claude Code 提供了丰富的命令系统，帮助开发者更高效地与 AI 助手交互。本文档介绍三种主要的命令类型：
graph TD
A[Claude Code 命令] --> B[内置命令]
A --> C[斜杠命令/技能]
A --> D[Bash 模式]
B --> B1[会话管理]
B --> B2[系统配置]
B --> B3[工具操作]
C --> C1[内置技能]
C --> C2[自定义技能]
D --> D1[直接执行 Shell 命令]
一、内置命令
内置命令是 Claude Code 核心功能的入口，通过 / 前缀调用。以下是常用的内置命令分类说明。
1. 会话管理命令
| 命令 | 说明 |
|---|---|
/help |
显示帮助信息和可用命令列表 |
/clear |
清除对话历史并释放上下文空间（别名：/reset、/new） |
/exit |
退出 Claude Code CLI（别名：/quit） |
/resume [session] |
恢复之前的对话会话（别名：/continue） |
/fork [name] |
在当前点创建对话的分支副本 |
/rename [name] |
重命名当前会话 |
/rewind |
将对话或代码回滚到之前的状态（别名：/checkpoint） |
2. 上下文与配置命令
| 命令 | 说明 |
|---|---|
/config |
打开设置界面，调整主题、模型、输出样式等（别名：/settings） |
/context |
可视化当前上下文使用情况 |
/compact [instructions] |
压缩对话内容，可选指定重点方向 |
/model [model] |
选择或切换 AI 模型 |
/theme |
更改颜色主题 |
/permissions |
查看或更新权限设置（别名：/allowed-tools） |
3. 工作流命令
| 命令 | 说明 |
|---|---|
/init |
初始化项目，创建 CLAUDE.md 指导文件 |
/add-dir <path> |
添加新的工作目录到当前会话 |
/diff |
打开交互式 diff 查看器，显示未提交的更改 |
/copy |
复制最后的助手回复到剪贴板 |
/export [filename] |
导出当前对话为纯文本 |
/doctor |
诊断和验证 Claude Code 安装及设置 |
4. 工具与集成命令
| 命令 | 说明 |
|---|---|
/mcp |
管理 MCP 服务器连接和 OAuth 认证 |
/hooks |
管理工具事件的钩子配置 |
/agents |
管理 Agent 配置 |
/skills |
列出可用的技能 |
/plugin |
管理 Claude Code 插件 |
/ide |
管理 IDE 集成并显示状态 |
5. 账户与使用命令
| 命令 | 说明 |
|---|---|
/login |
登录 Anthropic 账户 |
/logout |
退出登录 |
/cost |
显示 Token 使用统计 |
/usage |
显示计划使用限制和速率限制状态 |
/stats |
可视化每日使用量、会话历史等 |
6. 特殊功能命令
| 命令 | 说明 |
|---|---|
/btw <question> |
提问快速旁注问题，不添加到对话历史 |
/plan |
从提示符直接进入计划模式 |
/vim |
在 Vim 和普通编辑模式之间切换 |
| `/fast [on | off]` |
/sandbox |
切换沙箱模式 |
二、斜杠命令与技能
技能 (Skills) 是扩展 Claude Code 能力的主要方式。创建一个包含 SKILL.md 文件的目录，Claude 就会将其添加到工具箱中。
技能存储位置
| 位置 | 路径 | 适用范围 |
|---|---|---|
| 企业级 | 参见托管设置 | 组织内所有用户 |
| 个人级 | ~/.claude/skills/<skill-name>/SKILL.md |
所有项目 |
| 项目级 | .claude/skills/<skill-name>/SKILL.md |
仅当前项目 |
| 插件级 | <plugin>/skills/<skill-name>/SKILL.md |
启用插件的区域 |
内置技能
Claude Code 自带以下内置技能：
| 技能 | 说明 |
|---|---|
/simplify |
审查最近修改的文件，检查代码复用、质量和效率问题并修复 |
/batch <instruction> |
在代码库中并行编排大规模更改 |
/debug [description] |
通过读取会话调试日志排查当前 Claude Code 会话问题 |
/loop [interval] <prompt> |
按间隔重复运行提示（如 /loop 5m check if the deploy finished） |
/claude-api |
加载 Claude API 参考资料到上下文中 |
创建自定义技能
步骤 1：创建技能目录
bash
mkdir -p ~/.claude/skills/my-skill步骤 2：编写 SKILL.md 文件
yaml
---
name: my-skill
description: 技能描述，Claode 根据此描述决定何时使用该技能
---
# 技能指令
这里写 Claude 执行该技能时应遵循的指令...步骤 3：测试技能
有两种方式可以触发技能：
- 自动触发：说一些与描述匹配的话，如 "这段代码是怎么工作的？"
- 直接调用 ：使用
/skill-name格式，如/my-skill src/auth.ts
技能 Frontmatter 配置
yaml
---
name: skill-name # 显示名称
description: 技能描述 # 推荐配置
argument-hint: [参数提示] # 自动完成时显示的参数提示
disable-model-invocation: true # 阻止 Claude 自动调用
user-invocable: false # 从菜单隐藏
allowed-tools: Read, Grep # 允许的工具列表
context: fork # 在隔离子代理中运行
agent: Explore # 指定子代理类型
---参数传递
技能支持通过占位符接收参数：
| 占位符 | 说明 |
|---|---|
$ARGUMENTS |
所有传入的参数 |
$ARGUMENTS[N] |
按索引访问参数（从 0 开始） |
$N |
$ARGUMENTS[N] 的简写 |
${CLAUDE_SESSION_ID} |
当前会话 ID |
${CLAUDE_SKILL_DIR} |
技能目录路径 |
示例：
yaml
---
name: fix-issue
description: 修复 GitHub issue
disable-model-invocation: true
---
修复 GitHub issue $ARGUMENTS，遵循我们的编码标准。调用：/fix-issue 123 会将 $ARGUMENTS 替换为 123。
调用控制
graph LR
A[技能配置] --> B{disable-model-invocation?}
B -->|是| C[仅用户可调用]
B -->|否| D{user-invocable?}
D -->|true| E[用户和 Claude 都可调用]
D -->|false| F[仅 Claude 可调用]
三、Bash 模式
使用 ! 前缀可以直接执行 Shell 命令，无需通过 Claude 解释或批准：
bash
! npm test
! git status
! ls -la特点：
- 命令及其输出会添加到对话上下文
- 显示实时进度和输出
- 支持
Ctrl+B将长时间运行的命令置于后台 - 按
Escape、Backspace或Ctrl+U（在空提示时）退出
四、键盘快捷键
通用控制
| 快捷键 | 功能 |
|---|---|
Ctrl+C |
取消当前输入或生成 |
Ctrl+D |
退出 Claude Code 会话 |
Ctrl+L |
清除终端屏幕 |
Ctrl+G |
在默认文本编辑器中打开 |
Ctrl+O |
切换详细输出模式 |
Ctrl+R |
反向搜索命令历史 |
Ctrl+T |
切换任务列表 |
Ctrl+B |
将运行中的任务置于后台 |
Esc + Esc |
回滚或总结 |
Up/Down |
导航命令历史 |
/ |
输入命令或技能 |
! |
进入 Bash 模式 |
@ |
触发文件路径自动完成 |
文本编辑
| 快捷键 | 功能 |
|---|---|
Ctrl+K |
删除到行尾 |
Ctrl+U |
删除整行 |
Ctrl+Y |
粘贴删除的文本 |
Alt+B |
向后移动一个词 |
Alt+F |
向前移动一个词 |
多行输入
| 方法 | 快捷键 |
|---|---|
| 快速转义 | \ + Enter |
| macOS 默认 | Option+Enter |
| Shift+Enter | Shift+Enter（iTerm2、WezTerm、Ghostty、Kitty 原生支持） |
| 控制序列 | Ctrl+J |
五、实际使用示例
示例 1：初始化新项目
bash
# 进入项目目录后
/init
# Claude 会分析项目结构并创建 CLAUDE.md 文件示例 2：使用技能批量重构
bash
# 使用内置 batch 技能进行大规模迁移
/batch migrate src/ from React class components to hooks
# Claude 会：
# 1. 研究代码库
# 2. 分解任务为独立单元
# 3. 并行处理每个单元
# 4. 运行测试并创建 PR示例 3：创建自定义技能
场景：创建一个自动修复 GitHub issue 的技能
bash
# 1. 创建技能目录
mkdir -p ~/.claude/skills/fix-issue
# 2. 创建 SKILL.md
cat > ~/.claude/skills/fix-issue/SKILL.md << 'EOF'
---
name: fix-issue
description: 修复指定的 GitHub issue
disable-model-invocation: true
---
修复 GitHub issue #$ARGUMENTS：
1. 使用 `gh issue view $ARGUMENTS` 获取 issue 详情
2. 分析问题并理解需求
3. 实现修复
4. 编写或更新测试
5. 创建 commit 并关联 issue
EOF
# 3. 使用技能
/fix-issue 456示例 4：快速旁注问题
bash
# 在 Claude 处理长时间任务时提问
/btw 那个配置文件叫什么名字来着？
# 问题和答案不会进入对话历史
# 按空格、回车或 Esc 关闭回答示例 5：压缩对话上下文
bash
# 当上下文接近上限时
/compact 重点关注认证相关的修改
# Claude 会压缩对话，但保留指定的重点内容示例 6：使用 Bash 模式快速操作
bash
# 直接执行命令
! npm run build
# 查看状态
! git status
# 输出会被添加到对话上下文中六、常见问题排查
技能未触发
- 检查描述是否包含用户自然会说出的关键词
- 运行
/skills确认技能出现在列表中 - 尝试重新措辞请求以更匹配描述
- 使用
/skill-name直接调用
技能触发过于频繁
- 使描述更加具体
- 添加
disable-model-invocation: true限制为手动调用
Claude 看不到所有技能
技能描述会加载到上下文中。如果技能过多，可能超出字符预算（默认为上下文窗口的 2%，最低 16,000 字符）。
解决方案：
bash
# 检查上下文使用情况
/context
# 或设置环境变量覆盖限制
export SLASH_COMMAND_TOOL_CHAR_BUDGET=20000七、资源链接
提示 ：输入 / 后按 Tab 键可以查看所有可用命令和技能的自动完成列表。