从零开始掌握Claude Code全部50+指令,效率翻倍的终端AI编程秘籍
在AI编程助手层出不穷的今天,真正颠覆我开发体验的工具却不多——Claude Code算一个。它不是网页聊天的简单迭代,而是一个能直接操作项目文件、理解代码结构、执行终端命令的AI同事。Claude Code内置了超过50个命令,但大多数开发者只用到了其中的三五个。今天这篇文章,我将从零开始,带你系统掌握Claude Code的所有核心指令。
一、安装与环境准备
在开始使用命令之前,先确保Claude Code正确安装。
安装方式
方式一:原生安装(推荐)
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
```[reference:2]
**方式二:NPM安装**(需Node.js 18+)
```bash
npm install -g @anthropic-ai/claude-code
```[reference:3]
**方式三:Homebrew安装(macOS)**
```bash
brew install --cask claude-code
```[reference:4]
### 验证安装
安装成功后,运行以下命令确认:
```bash
claude --version
```[reference:5]
### 配置API密钥
```bash
# 临时设置
export ANTHROPIC_AUTH_TOKEN=sk-你的令牌
export ANTHROPIC_BASE_URL=https://api.anthropic.com
```[reference:6]
> ⚠️ **常见坑**:如果安装后运行`claude`提示"command not found",需要将`~/.local/bin`添加到系统PATH中[reference:7]。遇到任何问题,优先运行`/doctor`进行自诊断[reference:8]。
二、命令体系概览
Claude Code的命令分为三种类型[reference:9]:
| 类型 | 执行位置 | 示例 |
|------|----------|------|
| **CLI命令** | 终端中启动Claude Code时执行 | `claude -c`、`claude --version` |
| **斜杠命令** | 交互会话中输入`/`开头 | `/init`、`/compact`、`/model` |
| **键盘快捷键** | 会话期间直接按键 | `Shift+Tab`、`Ctrl+C` |
> 💡 简单来说:CLI命令是**启动时**用的,斜杠命令是**对话中**用的,快捷键是**操作中**用的。
三、CLI基础命令(终端中执行)
```bash
# 查看版本
claude --version
# 在当前目录启动交互界面
claude
# 在指定项目目录启动
claude /path/to/project
# 继续上一次对话(次日继续昨天的任务)
claude -c
# 恢复某个历史会话
claude -r
# 一次性执行指令后退出(Headless模式)
claude -p "帮我解释这个函数的逻辑"
# 升级到最新版本
claude update
```[reference:10][reference:11]
### 💡 Headless模式进阶
`claude -p`是Claude Code最强大的功能之一——可以在脚本和CI/CD流水线中自动调用AI能力[reference:12]。
```bash
# 默认文本输出
claude -p "分析package.json中有没有过期的依赖"
# JSON结构化输出(适合程序解析)
claude -p "列出项目中的TODO注释" --output-format json
# 限制执行轮次(控制成本)
claude -p "审查近期修改的代码" --max-turns 3 --allowedTools Read,Grep
```[reference:13]
四、三大工作模式(Shift+Tab循环切换)
Claude Code底部状态栏会显示当前模式,通过`Shift+Tab`随时切换[reference:14]。
| 模式 | 操作行为 | 适用场景 |
|------|---------|----------|
| **Default(默认模式)** | 每次改文件、执行命令都需用户确认 | 日常开发、敏感项目、新手阶段 |
| **Auto-Accept(自动接受模式)** | 文件修改自动执行,shell命令仍需确认 | 重复性编码、批量替换 |
| **Plan(计划模式)** | 纯只读,不修改任何代码 | 阅读陌生代码、架构分析、制定方案 |
**实战工作流**:先用Plan Mode梳理架构→确认方案→切换到Auto-Accept执行→Default Mode用于重要操作确认[reference:15]。
### 💡 权限模式细粒度控制
除了三大工作模式,你还可以通过`/permission`命令进行更精细的权限控制[reference:16]:
```bash
/permission # 查看当前权限模式
/permission default # 默认:每次操作都询问
/permission acceptEdits # 文件编辑自动执行,命令需询问(推荐日常使用)
/permission plan # 只生成计划,不执行任何操作
/permission auto # 全自动,几乎不询问(仅限信任环境)
五、核心斜杠命令详解(对话中输入)
🔥 高频必会命令
| 命令 | 功能 | 典型场景 |
|---|---|---|
| /help | 显示所有命令帮助 | 忘记某个功能时随时查 |
| /init | 生成CLAUDE.md项目记忆 | 新项目第一件事 |
| /memory | 编辑CLAUDE.md记忆文件 | 让AI记住项目约定 |
| /model | 切换模型 | 简单任务切小模型省token |
| /cost | 查看本次会话费用 | 控制API成本 |
| /status | 查看会话状态 | 检查版本、模型、配置 |
📁 项目管理类
/init—— 项目初始化的金钥匙
bash
/init
这是你在一个新项目中应该敲下的第一个命令。运行后,Claude会扫描整个代码库,自动生成一个CLAUDE.md文件,包含项目描述、技术栈、代码风格偏好等信息,成为Claude在项目中的“长期记忆”。
例如,在CLAUDE.md中添加规则后,AI会自动遵循这些约定:
markdown
# 身份认证规则 - 使用JWT令牌,不使用会话 - 存储在httpOnly cookie中 # 测试规范 - 为所有API端点编写测试 - 使用Jest,不使用Mocha
/add-dir—— 扩展AI视野
处理Monorepo或大型项目时,默认目录可能不够用。使用/add-dir手动添加其他工作目录:
bash
/add-dir ../shared /add-dir ../packages
/memory—— 随时更新AI记忆
bash
/memory
直接编辑CLAUDE.md文件,你甚至可以用自然语言告诉Claude:“更新记忆,所有测试都改用Vitest而不是Jest”,它会自动帮你修改记忆文件。
📝 会话管理类
/compact—— 压缩对话上下文
当对话超过30分钟,或看到“上下文过大”警告时,使用/compact压缩对话并生成摘要:
bash
# 基础压缩/compact# 定向压缩(保留特定内容)/compact retain the error handling patterns and auth module changes
/clearvs/compact:掌握两者的区别至关重要:
| 命令 | 效果 | 何时使用 |
|---|---|---|
| /compact | 压缩摘要,保留核心上下文 | 继续同一任务,但上下文太重 |
| /clear | 完全清除对话,重新开始 | 切换到完全不同的任务 |
/context—— 透视上下文窗口
输入/context,会清晰列出当前上下文窗口的组成:系统提示词、CLAUDE.md规则、已加载的文件等,帮你判断是否需要压缩。
/export—— 导出当前对话
将当前会话内容导出保存,用于记录或分享调试过程。
🤖 任务与子代理类
/agents—— 启动子代理处理复杂任务
子代理与主代理隔离运行,不依赖过多上下文信息,适合并行处理独立任务:
bash
# 启动探索型子代理/agent "分析这个目录的代码结构"# 启动任务型子代理/task "实现用户登录功能"# 指定子代理类型/agent:explore "搜索所有API端点" /agent:plan "设计数据库架构" /agent:general "实现排序算法"
Ctrl+B—— 后台任务
将当前任务挂到后台运行,让AI后台编译,前台继续讨论下一步。
bash
# 使用 /tasks 查看后台任务/tasks# 使用 /stop 停止某任务/stop
🔍 代码分析与审查类
/review—— 让AI做代码审查,提供改进建议。
/security-review—— 安全审计专用。分析当前分支的待提交更改,识别注入攻击、身份验证缺陷、数据暴露等安全风险,适合在PR前快速进行安全自查。
/diff—— 打开交互式差异查看器,展示git未提交的修改以及Claude每轮操作产生的逐轮diff。
/review和/security-review的区别:/review侧重代码质量和可维护性,而/security-review聚焦安全漏洞——两者结合起来用才是完整审查。
/insights—— 生成项目使用分析报告,包括交互模式、常见摩擦点、模型偏好等。
⚙️ 配置与诊断类
/doctor—— 你遇到任何问题的首选命令。它会自动检查七类问题并给出修复建议:Node.js版本、API认证、网络连接、文件权限等。遇到问题先跑/doctor,80%的问题都能自己解决。
/config—— 进入交互式配置面板,可开关自动压缩、主题、通知、自动更新等功能。
/mcp—— 管理MCP服务器连接,让Claude Code连接外部工具和数据源。
/hooks—— 配置工具钩子,实现在特定事件(如写文件后)自动触发脚本,例如写文件后自动格式化。
🏁 快捷键速查
| 快捷键 | 作用 | 典型场景 |
|---|---|---|
| Shift+Tab | 循环切换三种工作模式 | 从Plan切到Auto-Accept执行代码 |
| Ctrl+C | 打断当前AI执行 | AI跑偏了赶紧刹车 |
| Esc + Esc | 撤销上一次文件改动 | 改错了代码,一键回退 |
| Ctrl+B | 当前任务挂到后台 | 后台编译,前台继续讨论 |
| Ctrl+R | 搜索命令历史 | 调出之前用过的命令 |
| Ctrl+T | 显示/隐藏任务列表 | 查看后台任务进度 |
| Shift+Enter | 输入框内换行(不发送消息) | 输入多行代码或多段需求 |
| Alt+V | 粘贴图像(Windows) | 截图发给AI分析UI/报错 |
| ? | 显示快捷键提示 | 忘记快捷键时随时查 |
📌 文件引用和快捷操作
在对话中可直接引用文件或目录:
bash
@file path/to/file.py# 引用文件内容到对话@dir src/# 引用整个目录@git diff# 引用当前git差异@git log -5# 引用最近5条提交
六、避坑指南
1️⃣ 关于/init和/memory的误区
常见误解:“我已经在/init时生成了CLAUDE.md,不用再管了。”
正确做法:/init只是第一版,开发过程中要用/memory持续更新。每一次架构调整、新引入的规范、团队约定,都应该及时写入CLAUDE.md,否则AI会逐渐跟不上项目的演进。
2️⃣ 关于/compact和/clear的选择
常见误解:上下文大了就一律用/clear全部清空。
正确做法:/clear是“核武器”,慎用。如果只是上下文略重但还在同一任务流中,用/compact压缩保留关键信息即可,否则AI会丢失项目背景,你需要重新解释所有东西。
3️⃣ 三大工作模式的高效组合
推荐按这个顺序使用:Plan Mode(分析方案)→ Auto-Accept(执行代码)→ Default Mode(敏感操作确认)
新项目上手时,先用Plan Mode问“这个项目的整体结构是什么”,而不是让AI直接开写。
4️⃣ 遇到问题的第一反应
首要原则:任何问题,先运行/doctor自诊断,不要盲目搜索。
七、速查总表
| 分类 | 命令 | 一句话说明 |
|---|---|---|
| CLI启动 | claude | 启动交互式会话 |
| claude -c | 继续上一次对话 | |
| claude -p "指令" | 一次性执行后退出的Headless模式 | |
| claude --version | 查看版本 | |
| claude update | 升级到最新版 | |
| 高频核心 | /init | 生成CLAUDE.md,新项目第一件事 |
| /memory | 编辑AI记忆文件 | |
| /model | 切换AI模型 | |
| /cost | 查看token消耗 | |
| 会话管理 | /compact | 压缩对话上下文 |
| /clear | 完全清除对话历史 | |
| /context | 查看上下文使用情况 | |
| /export | 导出对话内容 | |
| 任务子代理 | /agent | 启动子代理处理复杂任务 |
| /task | 执行任务型子代理 | |
| Ctrl+B / /tasks | 后台任务管理 | |
| 代码审查 | /review | 代码审查 |
| /security-review | 安全漏洞扫描 | |
| /diff | 查看代码差异 | |
| 配置诊断 | /config | 配置面板 |
| /doctor | 环境自诊断(遇到问题先跑这个) | |
| /mcp | 管理MCP服务器 | |
| /hooks | 配置自动化钩子 | |
| 模式切换 | Shift+Tab | 切换Default/Auto-Accept/Plan |
| /permission | 精细权限控制 | |
| 快捷键 | Esc+Esc | 撤销AI修改(救命键) |
| Ctrl+C | 打断AI执行 | |
| Ctrl+R | 搜索命令历史 | |
| Shift+Enter | 换行不发送 |
掌握这些命令,你就从一个只会“跟AI聊天”的使用者,升级为能真正驾驭终端AI编程助手的开发者。建议把这篇文章收藏起来,刚开始使用时作为速查手册,很快就能形成肌肉记忆。
一个开始新项目的标准步骤送给你:
bash
cd /your/project claude# 启动交互环境/init# 生成项目记忆
配置好/memory,切换到Plan Mode梳理架构,确认方案后切换Auto-Accept执行——这套流程下来,你的开发效率会翻倍。
作为一名开发者,你是否也曾想体验 Claude Code 的强大编码能力,却被复杂的注册流程、海外信用卡要求、频繁的封号问题挡在门外?
今天我要向你介绍一个真正懂国内开发者痛点的一站式中转平台——Code2AI(console.code2ai.codes),让你 30 秒内完成配置,即刻畅享 AI 编程的乐趣!
什么是 Code2AI?
简单来说,Code2AI 是一个专为国内开发者设计的 Claude Code 中转平台。由于 Anthropic 等海外大模型对国内访问有严格限制,很多开发者无法直接使用官方 API。而 Code2AI 作为官方 API 与国内开发者之间的“桥梁”,帮助你解决支付(支持支付宝/微信)和网络(国内直连)两大难题。目前已服务20,000+活跃用户,月度调用量超100万次。
为什么选它?
- ⚡ 30秒极简配置:无需繁琐注册,无需翻墙折腾,三行环境变量搞定。
- 🛡️ 告别封号烦恼:专业账户管理与风控机制,账号异常自动切换,你只管专注编程。
- 💰 灵活透明定价:日卡低至$4.3,共享/独享模式自由选择,丰俭由人。
- 🚀 99.9% 高可用:分布式架构,全球节点,平均延迟不到100ms,还有真人技术支持。
怎么用?
只需三步:访问官网注册并选择套餐 → 获取专属 Token → 在终端配置三行环境变量,看到✓ Connected to Code2AI就完成了!
我们的时间应该花在解决业务难题、写出优雅代码上,而不是浪费在注册、翻墙、担心封号这些破事上。
如果你曾被官方渠道折磨过,或者想体验 Claude Code 却苦于无法注册,不妨从这个中转站开始。让你的 AI 编程助手,从此稳如泰山。