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 -201.3 上下文与费用管理[高频]命令说明/clear清除当前对话上下文开始全新会话同时清空本目录命令历史/compact压缩当前对话历史保留关键信息减少 token 占用/cost查看当前会话的 token 消耗与费用统计/status查看当前会话状态模型、目录、token 用量等会话过长 → 用/compact保信息切换任务 → 用/clear防混淆大文件 → 用引用而非直接粘贴。1.4 最高频快捷键[高频]快捷键说明Enter发送消息Shift Enter换行部分终端需先执行/terminal-setupmacOS 默认Option EnterCtrl C中断当前操作 / 生成连按两次退出 Claude CodeCtrl D退出 Claude CodeEOF 信号Tab自动补全文件路径 / 斜杠命令↑/↓浏览历史输入记录按目录独立保存Ctrl R反向模糊搜索历史输入类似 bash 的 reverse-i-searchCtrl 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列出当前工作目录的文件三、中频安装、配置与权限终端 / Shell3.1 安装 / 更新 / 版本[中频]命令说明npm install -g anthropic-ai/claude-code全局安装 Claude Codenpm update -g anthropic-ai/claude-code更新到最新版本claude update更新到最新版本CLI 内置命令claude --version查看当前版本claude auth login登录 Anthropic 账号--console用 Console 计费--sso强制 SSOclaude 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 Key3.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 CodeCtrl L清屏保留会话上下文Ctrl O切换详细输出显示工具调用与执行细节EscEsc回退到历史检查点恢复代码 / 对话到之前状态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/offCtrl P⌘P打开模型选择器切换模型并调整推理强度部分版本4.5 任务与后台快捷键说明Ctrl T切换任务列表浮层跟踪多步任务进度Ctrl B将当前 Bash 任务转入后台tmux 需连按两次Ctrl G在外部编辑器打开当前提示词适合长输入Ctrl S暂存当前提示词稍后继续4.6 粘贴与图片快捷键说明Ctrl V粘贴macOS / LinuxAlt V粘贴图片Windows4.7 任务执行中的确认当 Claude 展示差异并询问「Apply?」时通常只需输入首字母 Enter按键说明yEnter批准本次变更nEnter拒绝要求替代方案eEnter在编辑器中打开变更后再决定aEnter批准本任务剩余全部变更跳过逐个确认qEnter退出当前任务拒绝所有待定变更4.8 Vim 模式快捷键启用/vim后快捷键说明模式i/a/o进入插入前 / 后 / 下方新行NORMAL → INSERTI/A/O行首 / 行尾 / 上方新行插入NORMAL → INSERTEsc回到普通模式INSERT → NORMALh j k l左 / 下 / 上 / 右移动NORMALw/b下一词 / 上一词NORMAL0/$行首 / 行尾NORMALdd删除当前行NORMALyy复制当前行NORMALp粘贴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.mdClaude 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_KEYAnthropic 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
Claude Code 命令速查手册：高频指令、快捷键与高效工作流全整理
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 -201.3 上下文与费用管理[高频]命令说明/clear清除当前对话上下文开始全新会话同时清空本目录命令历史/compact压缩当前对话历史保留关键信息减少 token 占用/cost查看当前会话的 token 消耗与费用统计/status查看当前会话状态模型、目录、token 用量等会话过长 → 用/compact保信息切换任务 → 用/clear防混淆大文件 → 用引用而非直接粘贴。1.4 最高频快捷键[高频]快捷键说明Enter发送消息Shift Enter换行部分终端需先执行/terminal-setupmacOS 默认Option EnterCtrl C中断当前操作 / 生成连按两次退出 Claude CodeCtrl D退出 Claude CodeEOF 信号Tab自动补全文件路径 / 斜杠命令↑/↓浏览历史输入记录按目录独立保存Ctrl R反向模糊搜索历史输入类似 bash 的 reverse-i-searchCtrl 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列出当前工作目录的文件三、中频安装、配置与权限终端 / Shell3.1 安装 / 更新 / 版本[中频]命令说明npm install -g anthropic-ai/claude-code全局安装 Claude Codenpm update -g anthropic-ai/claude-code更新到最新版本claude update更新到最新版本CLI 内置命令claude --version查看当前版本claude auth login登录 Anthropic 账号--console用 Console 计费--sso强制 SSOclaude 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 Key3.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 CodeCtrl L清屏保留会话上下文Ctrl O切换详细输出显示工具调用与执行细节EscEsc回退到历史检查点恢复代码 / 对话到之前状态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/offCtrl P⌘P打开模型选择器切换模型并调整推理强度部分版本4.5 任务与后台快捷键说明Ctrl T切换任务列表浮层跟踪多步任务进度Ctrl B将当前 Bash 任务转入后台tmux 需连按两次Ctrl G在外部编辑器打开当前提示词适合长输入Ctrl S暂存当前提示词稍后继续4.6 粘贴与图片快捷键说明Ctrl V粘贴macOS / LinuxAlt V粘贴图片Windows4.7 任务执行中的确认当 Claude 展示差异并询问「Apply?」时通常只需输入首字母 Enter按键说明yEnter批准本次变更nEnter拒绝要求替代方案eEnter在编辑器中打开变更后再决定aEnter批准本任务剩余全部变更跳过逐个确认qEnter退出当前任务拒绝所有待定变更4.8 Vim 模式快捷键启用/vim后快捷键说明模式i/a/o进入插入前 / 后 / 下方新行NORMAL → INSERTI/A/O行首 / 行尾 / 上方新行插入NORMAL → INSERTEsc回到普通模式INSERT → NORMALh j k l左 / 下 / 上 / 右移动NORMALw/b下一词 / 上一词NORMAL0/$行首 / 行尾NORMALdd删除当前行NORMALyy复制当前行NORMALp粘贴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.mdClaude 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_KEYAnthropic 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
