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 月版本编写,部分命令和功能可能随版本更新而变化。