# 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`（会提示选择文件） |

**示例：**

```bash
@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 常用配置内容

```bash
# 项目说明

## 技术栈
- 语言：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 集成

```bash
# 查看变更并审查
!git diff HEAD~1
审查最近的提交变更，检查是否有安全问题

# 生成分支说明
!git log --oneline main..feature-branch
为这个 feature 分支生成 PR 描述
```

## 7.3 调试与诊断

```bash
/status      # 查看会话状态
/cost        # 查看费用
/doctor      # 诊断安装与配置（注意是斜杠命令）
```

## 7.4 批量文件处理

```bash
# 引用整个目录批量操作
@src/components/ 给所有组件添加 TypeScript 类型声明

# 管道模式批量处理
!find . -name "*.py" -type f | head -20
分析这些 Python 文件的 import 依赖关系
```

## 7.5 导出历史会话

```bash
# 安装导出工具
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](https://docs.anthropic.com/en/docs/claude-code "https://docs.anthropic.com/en/docs/claude-code")

![](https://developer.qcloudimg.com/http-save/yehe-12796585/18469b9f61d6b2f8e77dbbfac60b181b.png)

管道用法示例：cat error.log \| claude -p "分析这个报错并给出修复建议"

Claude Code 命令速查手册：高频指令、快捷键与高效工作流全整理

开发工具

编程语言

人工智能

ClaudeCode命令速查手册，覆盖最高频日常命令、上下文管理、快捷键、Git集成、配置权限及CLAUDE.md设置。提供完整安装更新、环境变量、调试诊断与批量处理技巧，助你快速掌握AI编程助手核心操作。

文件处理

代码解释

PostgreSQL

TypeScript 

数据库

Windows

Python

Linux

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Claude Code 命令速查手册：高频指令、快捷键与高效工作流全整理-腾讯云开发者社区-腾讯云

Claude Code 命令速查手册：高频指令、快捷键与高效工作流全整理

Claude Code 命令速查手册：高频指令、快捷键与高效工作流全整理

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐