Claude Code Command 指南Claude Code Command 指南概述 Claude Code

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：创建技能目录

mkdir -p ~/.claude/skills/my-skill

步骤 2：编写 SKILL.md 文件

---
name: my-skill
description: 技能描述，Claode 根据此描述决定何时使用该技能
---

# 技能指令

这里写 Claude 执行该技能时应遵循的指令...

步骤 3：测试技能

有两种方式可以触发技能：

自动触发：说一些与描述匹配的话，如 "这段代码是怎么工作的？"
直接调用：使用 /skill-name 格式，如 /my-skill src/auth.ts

技能 Frontmatter 配置

---
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}`	技能目录路径

示例：

---
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 解释或批准：

! 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：初始化新项目

# 进入项目目录后
/init

# Claude 会分析项目结构并创建 CLAUDE.md 文件

示例 2：使用技能批量重构

# 使用内置 batch 技能进行大规模迁移
/batch migrate src/ from React class components to hooks

# Claude 会：
# 1. 研究代码库
# 2. 分解任务为独立单元
# 3. 并行处理每个单元
# 4. 运行测试并创建 PR

示例 3：创建自定义技能

场景：创建一个自动修复 GitHub issue 的技能

# 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：快速旁注问题

# 在 Claude 处理长时间任务时提问
/btw 那个配置文件叫什么名字来着？

# 问题和答案不会进入对话历史
# 按空格、回车或 Esc 关闭回答

示例 5：压缩对话上下文

# 当上下文接近上限时
/compact 重点关注认证相关的修改

# Claude 会压缩对话，但保留指定的重点内容

示例 6：使用 Bash 模式快速操作

# 直接执行命令
! npm run build

# 查看状态
! git status

# 输出会被添加到对话上下文中

六、常见问题排查

技能未触发

检查描述是否包含用户自然会说出的关键词
运行 /skills 确认技能出现在列表中
尝试重新措辞请求以更匹配描述
使用 /skill-name 直接调用

技能触发过于频繁

使描述更加具体
添加 disable-model-invocation: true 限制为手动调用

Claude 看不到所有技能

技能描述会加载到上下文中。如果技能过多，可能超出字符预算（默认为上下文窗口的 2%，最低 16,000 字符）。

解决方案：

# 检查上下文使用情况
/context

# 或设置环境变量覆盖限制
export SLASH_COMMAND_TOOL_CHAR_BUDGET=20000

七、资源链接

提示：输入 / 后按 Tab 键可以查看所有可用命令和技能的自动完成列表。