Skip to content

Claude Code 常用命令参考手册

版本:2026 年 5 月 | 适用:Claude Code CLI 及 Cowork 模式


一、斜杠命令 (Slash Commands)

斜杠命令是在对话中输入 / 开头触发的快捷指令,用于执行常见操作。

1.1 对话管理

命令说明使用场景
/help显示帮助信息和可用命令列表忘记命令时快速查阅
/clear清空当前对话历史开启全新话题,释放上下文空间
/compact压缩上下文,保留关键信息对话过长、上下文即将耗尽时
/context查看当前上下文使用情况监控 token 用量

1.2 项目与代码

命令说明使用场景
/init在当前项目根目录生成 CLAUDE.md 文件新项目初始化,让 Claude 了解项目结构
/review审查当前分支的 Pull Request提交前自查代码质量
/security-review对当前分支的变更进行安全审查检查潜在的安全漏洞

1.3 记忆与技能

命令说明使用场景
/memory查看和管理持久化记忆回顾之前存储的偏好和项目信息
/skills列出所有可用技能了解当前可用的专项能力

二、CLI 启动参数

在终端中启动 Claude Code 时常用的命令行参数。

bash
# 基本启动
claude                                    # 在交互模式启动

# 指定工作目录
claude /path/to/project                   # 在指定目录启动

# 直接传入 prompt(非交互模式)
claude "修复 src/utils.py 中的 bug"       # 单次执行后退出
claude --print "解释这个文件的逻辑"        # 打印输出后退出

# 指定模型
claude --model sonnet                     # 使用 Sonnet 模型
claude --model opus                       # 使用 Opus 模型

# 调试模式
claude --debug                            # 输出详细调试信息
claude --verbose                          # 详细日志输出

# 权限控制
claude --allowedTools "Bash,Read,Write"   # 限制允许使用的工具
claude --permission-mode plan             # 计划模式(需人工确认)

常用组合

bash
# 日常开发:在项目中交互式使用
claude

# CI/CD:非交互式执行任务
claude --print "运行测试,如有失败则修复" --allowedTools "Bash,Read,Write,Edit"

# 代码审查:打印结果后退出
claude --print "审查这次变更的安全性" --model opus

三、键盘快捷键

在交互式对话界面中可用的快捷键。

快捷键操作
Ctrl+C中断当前操作 / 取消生成
Ctrl+D退出 Claude Code
Ctrl+L清屏(重新绘制界面)
Ctrl+R搜索对话历史
↑ / ↓在历史命令中导航
Tab自动补全文件路径和命令
Esc退出文件选择器或弹窗
Enter发送消息
Shift+Enter在消息中插入换行

四、会话内交互控制

在对话中直接使用的指令或表达方式,不限于斜杠命令。

4.1 操作确认与中断

"继续" / "go ahead"        → 确认执行待批准的操作
"取消" / "cancel"           → 取消当前操作
"停止" / "stop"             → 停止当前任务
"重试" / "retry"            → 重新执行失败的操作

4.2 输出控制

"简洁一点"                   → 要求更简短的回复
"详细说明"                   → 要求更详细的解释
"用中文回复"                 → 切换输出语言
"用表格展示"                 → 要求表格化输出
"不要使用列表/项目符号"       → 纯段落输出
"只给我代码,不要解释"        → 精简输出格式

4.3 文件操作

"把这个保存为文件"            → 触发文件创建
"只显示内容,不要创建文件"     → 仅输出文本
"修改文件中的第 X 行"         → 精确编辑

五、MCP 工具(Cowork 模式)

Cowork 模式下的常用工具调用。

5.1 文件系统

工具功能示例
request_cowork_directory请求访问用户文件夹授权后可在用户文件系统上读写
present_files以交互卡片形式展示文件展示生成的文件给用户下载
allow_cowork_file_delete请求文件删除权限需要删除文件但权限不足时

5.2 浏览器自动化

工具功能
navigate导航到指定 URL
computer (screenshot/click/type/scroll)截图、点击、输入、滚动
read_page获取页面无障碍树结构
find通过自然语言查找页面元素
get_page_text提取页面文章文本
javascript_tool在页面上下文中执行 JS
read_network_requests查看网络请求
read_console_messages读取浏览器控制台日志

5.3 会话与任务

工具功能
list_sessions列出所有本地会话
read_transcript读取其他会话的对话记录
create_scheduled_task创建定时任务
list_scheduled_tasks查看所有定时任务
update_scheduled_task修改定时任务

六、CLAUDE.md 配置

CLAUDE.md 是项目级别的持久化记忆文件,位于项目根目录,用于记录项目约定和偏好。

markdown
# CLAUDE.md

## 项目概述
这是一个电商平台的后端服务...

## 技术栈
- Python 3.11, FastAPI, PostgreSQL
- 部署在 AWS ECS

## 编码规范
- 使用 Black 格式化,行宽 100
- 类型注解必须完整
- 函数必须有 docstring

## 常用命令
- 测试: `pytest --cov`
- 启动: `uvicorn main:app --reload`
- 迁移: `alembic upgrade head`

通过 /init 命令可以自动生成此文件的框架。


七、记忆系统

Claude 拥有跨会话的持久化记忆,存放在项目的 memory/ 目录中。

记忆类型

类型用途示例
user用户身份、偏好、角色"我是后端工程师,偏好 Python"
project项目相关信息"Q3 上线推迟到 10 月"
feedback用户对工作方式的反馈"不要再在执行摘要中犹豫不决"
reference外部系统指针"性能指标看板在 Looker 而非表格"

管理记忆

"记住:我偏好使用 TypeScript 而不是 JavaScript"
"忘记之前关于项目 A 的所有信息"
"查看你关于我的记忆"

八、实用工作流模式

8.1 代码审查流程

1. /review                        # 触发 PR 审查
2. "重点关注安全漏洞部分"           # 指定审查重点
3. "把发现的严重问题列成清单"       # 控制输出格式

8.2 Bug 修复流程

1. "分析 src/bug.py 中的错误原因"
2. "提出修复方案,但先不要改代码"
3. "同意方案 A,开始修复"
4. "运行相关测试确认修复有效"

8.3 文档生成流程

1. "为整个项目生成 API 文档"
2. "文档以 Markdown 保存到 docs/ 目录"
3. "在每个接口后面加上请求/响应的示例"

九、注意事项

  • 上下文窗口有限:长对话中适时使用 /compact 压缩上下文,避免信息丢失。
  • 文件安全:Claude 默认在隔离沙箱中操作,需要显式授权才能访问用户文件系统。
  • 操作确认:涉及文件修改、删除等破坏性操作时,Claude 会请求确认后方可执行。
  • 并发限制:同一时间只能执行一个任务,多个独立任务需排队。
  • 记忆持久化:跨会话的信息需通过记忆系统存储,否则会话结束后丢失。

本文档基于 Claude Code 2026 年 5 月版本编写,部分命令和功能可能随版本更新而变化。