Claude Code 使用教程
这篇 Claude Code 使用教程写给刚装好 Claude Code 的人：从第一次对话开始，讲怎么让 Claude 读代码、改代码，怎么用计划模式和 CLAUDE.md，上下文满了怎么压缩，改错了怎么回退，最后附上常用快捷键和全部斜杠命令的命令大全。
开始之前，你需要已经安装好 Claude Code，并配置好 API。用 cdnd 的话，设置好 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 就不用登录 Claude 账号。
开始第一次对话
进入你的项目目录，运行 claude：
cd 你的项目目录
claude
Claude Code 会在终端里打开一个对话。第一次可以先让它了解项目，直接用中文提问就行：
这个项目是做什么的？
解释一下目录结构
Claude 会自己去读需要的文件再回答。默认情况下，它读文件不需要你确认；要修改文件或运行命令时，会先停下来问你是否允许。
也可以在启动时直接带上问题：
claude "解释一下这个项目"
让 Claude 修改代码
用自然语言描述你想要的改动，越具体越好：
给登录接口加上参数校验，用户名为空时返回 400
Claude 会先读相关代码，然后提出修改。每次改文件前，它会显示改动内容并请你确认：同意就执行，拒绝的话可以告诉它哪里不对、让它重新改。
- 查看所有改动：输入
/diff，查看工作区里的全部修改，包括 Claude 改过的部分。 - 中途打断：Claude 方向不对时按
Esc，它会停下来，已经完成的工作保留，你可以接着补充要求。 - 用 Git 提交：直接说"提交我的改动，写一条清楚的提交说明"，或者"新建一个叫 feature/login 的分支"。
权限模式与计划模式（Plan Mode）
按 Shift+Tab 可以在几种权限模式之间切换，当前模式显示在输入框下方：
| 模式 | 不用确认就能做的事 | 适合 |
|---|---|---|
default（界面显示为 Manual） |
只有读取文件 | 想逐个确认每一步操作 |
acceptEdits |
读取、修改文件，以及 mkdir、mv、cp 等常见文件操作 |
你会自己检查改动，不想每次都点确认 |
plan（计划模式） |
只读，不改任何文件 | 改代码之前先摸清代码、出方案 |
用计划模式先出方案
复杂的改动建议先用计划模式：Claude 只读代码、不做修改，最后给出一份方案，你确认以后再让它动手。进入计划模式有三种方式：
- 按
Shift+Tab切到plan； - 在对话里输入
/plan，后面可以直接跟任务，例如/plan 修复登录失败的 bug； - 启动时指定：
claude --permission-mode plan。
方案满意后，切回 default 或 acceptEdits 模式让 Claude 执行。
另外还有一个 bypassPermissions 模式，所有操作都不再询问。官方说明只应该在隔离的容器或虚拟机里使用，平时不要打开。
用 CLAUDE.md 让 Claude 记住项目
CLAUDE.md 是写给 Claude 看的项目说明，每次启动对话都会自动加载。把每次都要重复的信息写进去：怎么构建和运行测试、代码规范、目录说明、哪些文件不要动。
第一次在项目里使用时，运行：
/init
Claude 会分析项目并生成一份 CLAUDE.md，你再按需要修改。CLAUDE.md 可以放在几个位置：
| 位置 | 作用范围 |
|---|---|
~/.claude/CLAUDE.md |
只对你自己生效，所有项目都会加载 |
./CLAUDE.md 或 ./.claude/CLAUDE.md |
项目说明，提交到 git，团队共享 |
./CLAUDE.local.md |
只对你自己生效、只在当前项目加载，记得加进 .gitignore |
之后想修改，输入 /memory 打开这些文件。注意：对话进行中修改 CLAUDE.md，要到下一次对话或 /compact 之后才会生效。
管理上下文：压缩、清空与查看
Claude 在一次对话里看到的所有内容，包括你的消息、它读过的文件和命令输出，都占用上下文窗口。对话越长，占得越多，也越费钱。
压缩上下文：/compact
Claude Code 压缩上下文的命令是 /compact。它会把之前的对话总结成一段摘要，用摘要代替完整记录，腾出空间继续聊。后面可以加上总结时要保留的重点：
/compact 保留数据库表结构和还没修完的 bug
上下文快满时 Claude Code 会自动压缩。想调整自动压缩的时机，用 /autocompact，例如 /autocompact 500k。
开始新对话：/clear
换一个不相关的任务时，用 /clear 开始一个全新的对话，上下文清空。之前的对话不会丢，可以用 /resume 找回来。用 /clear 登录重构 这样的写法，还能先给旧对话起个名字，方便以后找。
查看上下文占用：/context
/context 用彩色格子显示当前上下文被哪些内容占用，并给出优化建议，比如哪个工具的输出太占空间。
回退修改与恢复会话
回退：Esc Esc 或 /rewind
输入框为空时连按两次 Esc，或者输入 /rewind，会打开回退菜单，可以把对话、代码或两者一起退回到之前的某一步。
要注意：通过 Bash 命令改动的文件（比如 Claude 运行了 rm 或脚本），以及你在 Claude Code 之外做的修改，都不会被回退。重要的改动还是要靠 git 兜底。
恢复之前的对话
关掉终端以后，之前的对话还在：
claude -c # 继续当前目录最近一次对话
claude -r "登录重构" # 按名称或 ID 恢复指定对话
在对话里输入 /resume，会打开会话列表让你挑选。
切换模型
输入 /model 打开模型选择，选中的模型会保存为以后新对话的默认模型。也可以直接写别名，例如 /model opus。按 Option+P（macOS）或 Alt+P（Windows、Linux）可以在不清空输入的情况下切换。
| 别名 | 用途 |
|---|---|
sonnet |
最新的 Sonnet，日常写代码的主力 |
opus |
最新的 Opus，适合复杂推理和大型改动 |
haiku |
速度快、价格低，适合简单任务 |
opusplan |
计划模式用 Opus，执行时自动换成 Sonnet |
中途换模型要谨慎：每个模型的缓存是分开的，对话进行到一半换模型，下一次请求要把整段历史按没有命中缓存的价格重新计算。最好在对话开始时就选好模型。各模型的价格和缓存计费见 Claude Code 价格。
常用快捷键
| 快捷键 | 作用 |
|---|---|
Esc |
打断 Claude 当前的回复或操作，已完成的工作保留 |
Esc Esc |
输入框为空时打开回退菜单；有内容时清空输入 |
Shift+Tab |
切换权限模式（default / acceptEdits / plan） |
Ctrl+C |
打断操作或清空输入，没有内容时再按一次退出 |
Ctrl+R |
搜索以前输入过的内容 |
Ctrl+O |
打开详细记录，查看每一步工具调用 |
Ctrl+V |
粘贴剪贴板里的图片（Windows 和 WSL 用 Alt+V） |
Ctrl+B |
把正在运行的命令放到后台 |
Ctrl+G |
用默认编辑器写长提示词 |
\ + Enter、Ctrl+J |
换行，任何终端都能用 |
@ |
提及文件，输入时自动补全路径 |
! |
在开头输入，进入 shell 模式直接运行命令，输出交给 Claude |
? |
输入框为空时按，显示快捷键帮助 |
Claude Code 命令大全
在对话里输入 / 会弹出命令列表，继续输入可以筛选。下面按用途列出官方文档里的全部 117 个斜杠命令（已下线的命令不列）。标 ※ 的命令依赖 claude.ai 订阅账号或 Anthropic 的云端功能，使用 cdnd 的 API Key 时通常用不了。
对话与会话
| 命令 | 作用 |
|---|---|
/clear [名称] |
开始一个上下文为空的新对话，可以给旧对话起名 |
/compact [重点] |
总结之前的对话来腾出上下文，可以指定要保留的重点 |
/autocompact [大小] |
设置自动压缩的阈值，例如 500k；auto 恢复默认 |
/context |
用彩色格子显示上下文占用，并给出优化建议 |
/resume [会话] |
按 ID 或名称恢复对话，不带参数时打开会话列表 |
/rename [名称] |
重命名当前会话，不写名称时自动生成 |
/rewind |
把对话和代码退回到之前的某一步（别名 /checkpoint、/undo） |
/branch [名称] |
从当前位置分出一个对话分支，尝试别的方向，原对话保留 |
/fork [提示] |
把当前对话复制到一个新的后台会话里，你继续在这里工作 |
/background [提示] |
把当前会话转到后台运行，释放终端（别名 /bg） |
/subtask <任务> |
派出一个继承完整对话的后台子代理去做任务，完成后结果回到这里 |
/stop |
停止当前连接的后台会话，记录和工作目录保留 |
/tasks |
查看和管理后台任务，包括运行完的子代理（别名 /bashes） |
/goal [条件] |
设一个目标，Claude 会持续工作直到条件满足；clear 取消 |
/btw [问题] |
问一个旁支问题，不加入当前对话 |
/recap |
生成当前会话的一句话总结 |
/focus |
切换专注视图，只显示最后的提示、工具调用摘要和最终回复 |
/copy [N] |
复制最近一条（或倒数第 N 条）回复到剪贴板 |
/export [文件名] |
把当前对话导出为纯文本 |
/cd <路径> |
把会话移到另一个工作目录，对话保留 |
/add-dir <路径> |
给当前会话增加一个可访问的工作目录 |
/list-agents |
列出 Claude 可以发消息的子代理和其他会话（别名 /peers） |
/exit |
退出 Claude Code（别名 /quit） |
模型与输出
| 命令 | 作用 |
|---|---|
/model [模型] |
切换模型并保存为默认，不带参数时打开选择列表 |
/effort [级别] |
设置思考力度：low 到 xhigh、max 或 auto |
/fast [on/off] |
开关 fast 模式；Opus 5.5 的 fast 模式按 2 倍价格计费 |
/advisor [模型/off] |
开关顾问工具，在关键节点请另一个模型给建议 |
/output-style [风格] |
列出或切换输出风格，例如 /output-style concise |
/config [键=值] |
打开设置界面，或者直接改设置，例如 /config model=sonnet |
项目、记忆与权限
| 命令 | 作用 |
|---|---|
/init |
分析项目，生成 CLAUDE.md |
/memory |
编辑 CLAUDE.md，开关和查看自动记忆 |
/plan [描述] |
直接进入计划模式，可以同时给出任务 |
/permissions |
管理工具权限的允许、询问、拒绝规则 |
/fewer-permission-prompts |
分析历史记录，把常用的只读命令加进允许列表，减少确认弹窗 |
/auto-mode-setup |
根据项目生成自动模式的环境配置草稿 |
/sandbox |
开关沙箱模式（仅部分平台支持） |
/hooks |
查看 hooks 配置 |
/update-config [需求] |
用一句话描述设置改动，由 Claude 修改对应的 settings.json |
/import [来源] |
从 OpenAI Codex、Gemini CLI 或 Cursor 导入配置 |
/keybindings |
打开快捷键配置文件 |
写代码、审查与调试
| 命令 | 作用 |
|---|---|
/diff |
查看工作区的所有改动，包括 Claude 做的修改 |
/code-review [选项] |
审查当前改动、某个 PR、分支或路径，找出正确性问题；--fix 直接修 |
/review [选项] |
/code-review 的别名 |
/simplify [目标] |
检查改动的代码能否简化，并直接应用修改（不找 bug） |
/security-review |
检查当前分支相对默认分支的改动有没有安全漏洞 |
/run |
启动并操作你的应用，确认改动真的能用 |
/verify |
构建、运行应用并观察结果，验证改动是否符合预期 |
/run-skill-generator |
为项目生成一个 Skill，教会 /run 和 /verify 怎么启动你的应用 |
/batch <指令> |
把大规模改动拆成 5 到 30 个独立单元，并行完成 |
/debug [描述] |
打开调试日志，读取日志排查问题 |
/loop [间隔] [提示] |
在会话打开期间重复执行一个提示，例如 /loop 5m 检查部署是否完成 |
/deep-research <问题> |
并行搜索网页、交叉核对来源，生成带引用的报告 |
/workflows |
查看、暂停、恢复正在运行或已完成的工作流 |
/workflow-authoring |
加载编写动态工作流脚本的参考资料 |
/claude-api [子命令] |
加载 Claude API 和 Managed Agents 的参考资料，用于开发 Claude 应用 |
/dataviz [需求] |
图表和看板的设计指导 |
/ultrareview [PR或分支] |
在云端沙箱里运行多代理深度代码审查 ※ |
Skills、插件、MCP 与集成
| 命令 | 作用 |
|---|---|
/skills |
列出可用的 Skills，可以筛选和切换是否可见 |
/reload-skills |
重新扫描 Skill 目录，不用重启就能用上新加的 Skill |
/skill-doctor |
查看每个 Skill 占多少上下文、用得多不多 |
/plugin [子命令] |
管理插件：浏览、安装、启用、停用 |
/reload-plugins |
重新加载插件，不用重启 |
/plugin-authoring |
加载编写插件扩展（mod）的参考资料 |
/mcp [子命令] |
管理 MCP 服务器的连接和认证 |
/agents |
提示怎么创建和管理子代理（subagents） |
/ide |
管理 IDE 集成，查看连接状态 |
/chrome |
配置 Claude in Chrome |
/claude-in-chrome [任务] |
让 Claude 在浏览器里完成任务，比如测试页面、填表单 |
/install-github-app |
为仓库安装 Claude GitHub App，并可配置 GitHub Actions |
/install-slack-app |
安装 Claude 的 Slack 应用 |
状态、费用与诊断
| 命令 | 作用 |
|---|---|
/status |
查看版本、模型、账号和连接状态 |
/usage |
查看本次会话的花费、用量和缓存命中情况 |
/cost |
/usage 的别名 |
/stats |
/usage 的别名，直接打开统计页 |
/doctor |
检查安装、设置、扩展和 CLAUDE.md 的问题，并提出修复方案 |
/insights |
生成一份分析你最近使用情况的 HTML 报告 |
/heapdump |
导出内存快照，用于排查内存占用过高 |
/release-notes |
查看各版本的更新日志 |
/help |
显示帮助和可用命令 |
/powerup |
通过带动画演示的小课程了解 Claude Code 的功能 |
/bug [描述] |
报告 bug；用第三方 API 时报告会保存在本地 |
/feedback [描述] |
发送产品反馈 |
/team-onboarding |
根据你最近 30 天的使用记录，生成一份给新同事的上手指南 |
界面与终端
| 命令 | 作用 |
|---|---|
/theme |
切换配色主题，包括跟随终端的 auto |
/color [颜色] |
设置当前会话输入栏的颜色 |
/statusline |
配置底部状态栏 |
/terminal-setup |
为 VS Code、Cursor 等终端配置 Shift+Enter 换行 |
/tui [模式] |
切换终端界面的渲染方式，例如 fullscreen |
/scroll-speed |
调整全屏模式下的鼠标滚动速度 |
/radio |
在浏览器里打开 Claude FM 音乐电台 |
/stickers |
订购 Claude Code 贴纸 |
账号、订阅与云端功能
| 命令 | 作用 |
|---|---|
/login |
登录 Anthropic 账号（用 cdnd 不需要） |
/logout |
退出 Anthropic 账号 |
/upgrade |
打开升级订阅的页面 ※ |
/usage-credits |
配置订阅的额外用量额度 ※ |
/rate-limit-options |
达到 claude.ai 用量上限时，显示可选的处理方式 ※ |
/privacy-settings |
查看和修改隐私设置，仅 Pro 和 Max 订阅可用 ※ |
/passes |
把 Claude Code 免费周卡分享给朋友（账号符合条件时才显示） ※ |
/remote-control |
让当前会话可以在 claude.ai 上远程控制（别名 /rc） ※ |
/remote-env |
选择云端会话的默认环境 ※ |
/web-setup |
用本机 gh 的凭据为云端会话连接 GitHub 账号 ※ |
/teleport |
把云端会话拉到当前终端继续（别名 /tp） ※ |
/autofix-pr [提示] |
启动一个云端会话，在 CI 失败或有评审意见时自动推送修复 ※ |
/schedule [描述] |
创建和管理云端定时任务（别名 /routines） ※ |
/desktop |
在 Claude Code 桌面应用里继续当前会话（别名 /app） ※ |
/mobile |
显示下载 Claude 手机应用的二维码（别名 /ios、/android） |
/voice [模式] |
开关语音输入，需要 Claude.ai 账号 ※ |
/artifacts |
列出你的 artifacts，并附加到会话或在浏览器里打开 ※ |
/artifact-capabilities |
加载 artifact 可用能力的参考资料 ※ |
/artifact-diagramming |
加载在 artifact 里画图的指导 ※ |
/slides [需求] |
生成一份 Claude Slides 演示文稿 ※ |
/design [需求] |
生成 UI 草图、页面流程或海报，发布为 Claude Design artifact ※ |
/design consent、/design revoke |
授权或撤销 Claude 访问 Claude Design ※ |
/design-login |
用 claude.ai 账号授权设计系统访问 ※ |
/design-sync [提示] |
把仓库里的 React 设计系统上传到 Claude Design ※ |
/setup-bedrock |
配置 Amazon Bedrock（设置 CLAUDE_CODE_USE_BEDROCK=1 后才显示） |
/setup-vertex |
配置 Google Cloud Agent Platform（设置 CLAUDE_CODE_USE_VERTEX=1 后才显示） |
终端里的 claude 命令
上面是对话里的斜杠命令。在终端里，claude 本身也有这些常用用法：
| 命令 | 作用 |
|---|---|
claude |
启动交互式对话 |
claude "问题" |
启动对话并直接提出第一个问题 |
claude -p "问题" |
只回答这一个问题然后退出，适合写进脚本 |
claude -c |
继续当前目录最近一次对话 |
claude -r "名称" |
按名称或 ID 恢复指定对话 |
claude --model opus |
用指定模型启动 |
claude --permission-mode plan |
以计划模式启动 |
claude update |
升级到最新版本 |
claude doctor |
检查安装和配置，不启动对话 |
claude mcp |
配置 MCP 服务器 |
每个命令的完整参数见 Claude Code 官方命令参考。
省钱技巧
Claude Code 每轮对话都会带上之前的上下文，花费主要取决于上下文有多长、缓存有没有命中。下面这些 Claude Code 使用技巧能明显降低花费：
- 对话开始时选好模型，中途不要换。换模型会让缓存全部失效。
- 把
/compact留到两个任务之间。一个任务做到一半时压缩，后面可能要重新读文件。 - 不相关的任务用
/clear开新对话，不要让旧上下文一直跟着计费。 - 简单任务用 Haiku，比如改文案、查一个函数的用法，价格是 Sonnet 的二十分之一。
- 用
/usage看花费。它会显示本次会话按官方标价计算的美元花费，以及有多少输入命中了缓存。用 cdnd 时，这个美元金额乘以 2 大约就是人民币花费，实际扣费以控制台为准。 - 给 API Key 设每月花费上限，避免脚本失控。在 cdnd 控制台里可以给每个 Key 单独设置。
缓存怎么计费、一次请求大概多少钱，见 Claude Code 价格。
Skills、MCP 和插件
- Skills：一个
SKILL.md文件就是一个 Skill，里面写好某类任务的步骤和要求。Claude 在相关时会自动使用，你也可以输入/加 Skill 名称直接调用，例如/deploy。以前.claude/commands/里的自定义命令已经并入 Skills。输入/skills查看已有的 Skill。 - MCP：通过 MCP（Model Context Protocol）把数据库、浏览器、设计工具等外部工具接进 Claude Code。用
claude mcp添加，用/mcp查看连接状态。 - 插件：插件把 Skills、MCP、hooks 等打包在一起，输入
/plugin浏览和安装。
在 VS Code 里使用 Claude Code
Claude Code 也有 VS Code 插件，在编辑器侧边栏里对话，改动直接以 diff 的形式显示在编辑器里。本文介绍的命令、权限模式和 CLAUDE.md 在插件里同样适用。插件接入 cdnd 的配置方法和终端不同，需要在 VS Code 设置里配置 claudeCode.environmentVariables，见 VS Code 插件接入第三方 API。
常见问题
Claude Code 怎么输入多行？
输入反斜杠再按回车（\ + Enter）或者按 Ctrl+J 都可以换行，任何终端都能用。iTerm2、Windows Terminal 等终端里也可以直接按 Shift+Enter；其他终端可以运行 /terminal-setup 配置。
Claude Code 压缩上下文的命令是什么？
压缩上下文的命令是 /compact。它会把之前的对话总结成摘要来腾出上下文，后面可以加上要保留的重点，例如"/compact 保留数据库表结构"。上下文快满时 Claude Code 也会自动压缩。如果想彻底开始新对话，用 /clear。
怎么让 Claude 先出方案再改代码？
用计划模式（Plan Mode）：按 Shift+Tab 切到 plan，或者输入 /plan 加上任务描述。计划模式下 Claude 只读代码、不做修改，最后给出方案，你确认以后再切回普通模式让它执行。
关掉终端以后还能继续之前的对话吗？
可以。在项目目录运行 claude -c 继续最近一次对话，或者用 claude -r 加名称恢复指定对话。在对话里输入 /resume 也能打开会话列表挑选。
Claude Code 能用中文吗？
可以。直接用中文提问和描述需求即可，Claude 会用中文回答。命令和快捷键本身是英文的，不影响使用。
用 cdnd 时 /usage 显示的花费准吗？
/usage 的美元金额是 Claude Code 在本地按官方标价计算的，cdnd 也按官方美元标价扣费，所以两者大致一致，乘以 2 约等于人民币花费。实际扣费以 cdnd 控制台里每个请求的记录为准。