Claude Code命令速查手册
一、最高频：每天必用
1.1 启动与进入会话[高频]
| 命令 | 说明 |
|---|
claude | 在当前目录启动交互式会话 |
claude -c | 继续当前目录上一次的会话 |
claude -p "提示词" | 非交互（管道 / 脚本）模式，输出结果后退出 |
claude --resume | 交互式选择历史会话恢复（或-r "会话ID/名称"直达） |
claude "你的提示词" | 带初始提示直接启动并执行 |
管道用法示例：cat error.log \| claude -p "分析这个报错并给出修复建议"
1.2 上下文引用（@ 与 !）[高频]
在对话输入框中直接使用，无需斜杠前缀。
| 符号 | 说明 |
|---|
@文件路径 | 引用指定文件内容到上下文 |
@文件夹路径 | 引用整个目录（Claude 会读取目录内文件） |
@url | 抓取并引用网页内容 |
!命令 | Bash 模式：直接执行 Shell 命令并把输出加入上下文（如!git status、!ls -la） |
#开头 | 记忆快捷：将内容写入CLAUDE.md（会提示选择文件） |
示例：
@src/main.py 帮我分析这个文件的入口逻辑 @https://docs.example.com/api 根据这个文档生成 SDK !find . -name "*.py" | head -20
1.3 上下文与费用管理[高频]
| 命令 | 说明 |
|---|
/clear | 清除当前对话上下文，开始全新会话（同时清空本目录命令历史） |
/compact | 压缩当前对话历史，保留关键信息，减少 token 占用 |
/cost | 查看当前会话的 token 消耗与费用统计 |
/status | 查看当前会话状态（模型、目录、token 用量等） |
会话过长 → 用/compact保信息；切换任务 → 用/clear防混淆；大文件 → 用@引用而非直接粘贴。
1.4 最高频快捷键[高频]
| 快捷键 | 说明 |
|---|
Enter | 发送消息 |
Shift + Enter | 换行（部分终端需先执行/terminal-setup；macOS 默认Option + Enter） |
Ctrl + C | 中断当前操作 / 生成；连按两次退出 Claude Code |
Ctrl + D | 退出 Claude Code（EOF 信号） |
Tab | 自动补全文件路径 / 斜杠命令 |
↑/↓ | 浏览历史输入记录（按目录独立保存） |
Ctrl + R | 反向模糊搜索历史输入（类似 bash 的 reverse-i-search） |
Ctrl + L | 清屏（不清除上下文） |
Esc | 取消当前输入 / 关闭自动补全 / 中断回复 |
更完整的快捷键见第四章。
二、高频：开发工作流
2.1 提交与代码审查[高频]
| 命令 | 说明 |
|---|
/commit | 自动分析变更并生成规范 commit message 后提交（遵循 git 安全协议） |
/review | 对代码变更进行审查（Git diff） |
/init | 在项目根目录生成CLAUDE.md项目说明文件 |
审查指定文件：@src/api.py 审查这个文件的安全性和性能问题
审查最近提交：!git diff HEAD~1后让 Claude 检查安全问题
2.2 配置与切换[中频]
| 命令 | 说明 |
|---|
/config | 打开配置面板，查看和修改设置 |
/model | 切换使用的模型（Sonnet / Opus / Haiku） |
/theme | 切换界面主题（light / dark） |
/permissions | 管理工具权限设置（查看允许列表） |
/mcp | 查看 MCP Server 连接状态与管理 |
/add-dir <路径> | 添加额外目录到工作上下文中 |
/ls | 列出当前工作目录的文件 |
三、中频：安装、配置与权限（终端 / Shell）
3.1 安装 / 更新 / 版本[中频]
| 命令 | 说明 |
|---|
npm install -g @anthropic-ai/claude-code | 全局安装 Claude Code |
npm update -g @anthropic-ai/claude-code | 更新到最新版本 |
claude update | 更新到最新版本（CLI 内置命令） |
claude --version | 查看当前版本 |
claude auth login | 登录 Anthropic 账号（--console用 Console 计费，--sso强制 SSO） |
claude auth status | 查看登录状态（JSON；--text可读输出） |
3.2 配置管理（claude config）[中频]
| 命令 | 说明 |
|---|
claude config list | 列出所有配置 |
claude config get <key> | 获取配置项 |
claude config set <key> <value> | 设置配置项 |
claude config set theme dark | 设置主题为暗色 |
claude config set --global apiKey <XXX> | 全局设置 API Key |
3.3 权限与安全（启动参数）[低频]
| 参数 | 说明 |
|---|
--allowedTools "Tool" | 预放行指定工具（如"Read"、"Bash(git log:*)"），无需逐次确认 |
--disallowedTools "Tool" | 显式拒绝指定工具 |
--permission-mode <mode> | 以指定权限模式启动：default/plan/acceptEdits/auto/bypassPermissions |
--dangerously-skip-permissions | 跳过所有权限确认（仅限可信环境，等同bypassPermissions） |
四、完整快捷键速查表（REPL 交互界面）
适用于claude启动后的终端交互界面。Mac 上部分Ctrl组合以⌘为准；REPL 快捷键跨平台一致。
4.1 输入与发送
| 快捷键 | 说明 |
|---|
Enter | 发送消息 / 确认操作 |
Shift + Enter | 多行输入内换行（不发送） |
\+Enter | 换行（所有终端通用） |
Esc | 取消当前输入 / 关闭自动补全 |
Tab | 接受补全建议（文件路径、斜杠命令） |
↑/↓ | 在补全建议中上下移动 |
4.2 会话控制 / 中断 / 退出
| 快捷键 | 说明 |
|---|
Ctrl + C | 取消当前输入或中断正在运行的任务；连按两次退出 |
Ctrl + D | 退出 Claude Code |
Ctrl + L | 清屏（保留会话上下文） |
Ctrl + O | 切换详细输出（显示工具调用与执行细节） |
Esc+Esc | 回退到历史检查点，恢复代码 / 对话到之前状态 |
Ctrl + Z | 将 REPL 挂到后台（用fg恢复） |
4.3 历史与导航
| 快捷键 | 说明 |
|---|
↑/↓ | 浏览历史输入记录（按工作目录独立保存） |
Ctrl + R | 反向模糊搜索历史输入；再按Ctrl + R切换更早上一条 |
Ctrl + A | 光标移到行首 |
Ctrl + E | 光标移到行尾 |
Ctrl + K | 删除光标到行尾 |
Ctrl + U | 删除整行 |
Ctrl + W | 删除前一个单词 |
4.4 权限与模式切换
| 快捷键 | 说明 |
|---|
Shift + Tab | 循环切换权限模式：Normal → Auto-Accept → Plan（最常用快捷键之一） |
Alt + M | 同上（Windows 未开启 VT 模式、Node 版本较低时的替代） |
Tab | 部分版本下切换扩展思考（Thinking on/off） |
Ctrl + P（⌘P） | 打开模型选择器，切换模型并调整推理强度（部分版本） |
4.5 任务与后台
| 快捷键 | 说明 |
|---|
Ctrl + T | 切换任务列表浮层（跟踪多步任务进度） |
Ctrl + B | 将当前 Bash 任务转入后台（tmux 需连按两次） |
Ctrl + G | 在外部编辑器打开当前提示词（适合长输入） |
Ctrl + S | 暂存当前提示词，稍后继续 |
4.6 粘贴与图片
| 快捷键 | 说明 |
|---|
Ctrl + V | 粘贴（macOS / Linux） |
Alt + V | 粘贴图片（Windows） |
4.7 任务执行中的确认
当 Claude 展示差异并询问「Apply?」时，通常只需输入首字母 +Enter：
| 按键 | 说明 |
|---|
y+Enter | 批准本次变更 |
n+Enter | 拒绝，要求替代方案 |
e+Enter | 在编辑器中打开变更后再决定 |
a+Enter | 批准本任务剩余全部变更（跳过逐个确认） |
q+Enter | 退出当前任务，拒绝所有待定变更 |
4.8 Vim 模式快捷键（启用/vim后）
| 快捷键 | 说明 | 模式 |
|---|
i/a/o | 进入插入（前 / 后 / 下方新行） | NORMAL → INSERT |
I/A/O | 行首 / 行尾 / 上方新行插入 | NORMAL → INSERT |
Esc | 回到普通模式 | INSERT → NORMAL |
h j k l | 左 / 下 / 上 / 右移动 | NORMAL |
w/b | 下一词 / 上一词 | NORMAL |
0/$ | 行首 / 行尾 | NORMAL |
dd | 删除当前行 | NORMAL |
yy | 复制当前行 | NORMAL |
p | 粘贴 | NORMAL |
:w | 保存（发送消息） | NORMAL |
:q | 退出 | NORMAL |
五、中低频：其余斜杠命令
| 命令 | 频率 | 说明 |
|---|
/help | [中频] | 查看所有可用命令及帮助信息 |
/doctor | [低频] | 诊断安装环境，检查配置问题（这是斜杠命令，原文档写作claude doctor不准确） |
/vim | [低频] | 切换 Vim 编辑模式 |
/bug | [低频] | 报告 Bug |
/terminal-setup | [低频] | 配置终端集成（绑定Shift + Enter换行等） |
/agents | [低频] | 列出已配置的子代理（subagents） |
/plugin | [低频] | 管理 Claude Code 插件 |
claude setup-token | [低频] | 生成长期有效的 OAuth Token（用于 CI / 脚本） |
六、CLAUDE.md 项目配置文件
在项目根目录创建CLAUDE.md，Claude Code 启动时会自动读取。
6.1 常用配置内容
# 项目说明 ## 技术栈 - 语言：Python 3.12 - 框架：FastAPI - 数据库：PostgreSQL ## 代码规范 - 使用 Black 格式化 - 类型注解必须完整 - 函数必须有 docstring ## 禁止事项 - 不要修改 config/ 目录下的配置文件 - 不要直接操作生产数据库
6.2 配置层级
| 文件位置 | 作用范围 |
|---|
~/.claude/CLAUDE.md | 全局，所有项目生效 |
项目根目录/CLAUDE.md | 当前项目 |
子目录/CLAUDE.md | 特定子目录 |
七、实用技巧与工作流
7.1 上下文管理
- 会话过长：
/compact压缩上下文，保留关键信息 - 切换任务：
/clear清除上下文，避免混淆 - 大文件处理：用
@文件路径引用而非直接粘贴，减少 token 消耗
7.2 Git 集成
# 查看变更并审查 !git diff HEAD~1 审查最近的提交变更，检查是否有安全问题 # 生成分支说明 !git log --oneline main..feature-branch 为这个 feature 分支生成 PR 描述
7.3 调试与诊断
/status # 查看会话状态 /cost # 查看费用 /doctor # 诊断安装与配置（注意是斜杠命令）
7.4 批量文件处理
# 引用整个目录批量操作 @src/components/ 给所有组件添加 TypeScript 类型声明 # 管道模式批量处理 !find . -name "*.py" -type f | head -20 分析这些 Python 文件的 import 依赖关系
7.5 导出历史会话
# 安装导出工具 pipx install claude-conversation-extractor # 导出全部会话 claude-extract --all --detailed --output ~/claude-markdown-exports
八、环境变量
| 变量名 | 说明 |
|---|
ANTHROPIC_API_KEY | Anthropic API 密钥 |
CLAUDE_CODE_USE_BEDROCK | 使用 AWS Bedrock 作为后端 |
CLAUDE_CODE_USE_VERTEX | 使用 Google Vertex AI 作为后端 |
CLAUDE_MODEL | 默认使用的模型 |
MAX_THINKING_TOKENS | 思考模式最大 token 数 |
DISABLE_PROMPT_CACHING | 禁用提示缓存 |
CLAUDE_CODE_MAX_OUTPUT_TOKENS | 最大输出 token 数 |
备注：命令可能随版本更新变化，建议定期执行/help查看最新可用命令。完整文档参考：https://docs.anthropic.com/en/docs/claude-code
![]()