Claude Code 最全使用指南
Claude Code 是 Anthropic 推出的终端级 AI 编程助手，它不仅仅是一个代码补全工具，更是一个能够完整理解你的代码库、自动运行命令、修复 Bug、甚至跨系统协作的智能代理。本文将从下载安装到高级配置，全方位带你掌握 Claude Code 的所有技巧，让你的开发效率提升 10 倍。
一、下载与安装：5 分钟快速上手
1.1 环境准备
Claude Code 依赖 Node.js 环境，在安装前请确保你的系统满足以下要求：
-
操作系统：macOS 10.15+、Ubuntu 20.04+/Debian 10+、Windows 10/11
-
Node.js：18.0 及以上版本
-
内存：至少 4GB 可用内存
-
网络：稳定的互联网连接
安装 Node.js（如未安装）：
# macOS (使用 Homebrew)
brew install node
# Linux
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash –
sudo apt-get install -y nodejs
# Windows
# 访问 https://nodejs.org 下载安装包
验证 Node.js 安装：
node –version
npm –version
1.2 安装 Claude Code
Claude Code 提供多种安装方式，推荐使用官方一键安装脚本：
方式一：官方一键安装（推荐）
# macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex
方式二：npm 全局安装
npm install -g @anthropic-ai/claude-code
方式三：Homebrew 安装（macOS）
brew install –cask claude-code
1.3 验证安装
安装完成后，重启终端，执行以下命令验证：
claude –version
正常情况下会输出版本号，例如：
Claude Code v2.1.73
1.4 首次登录与配置
首次启动 Claude Code 时，会引导你完成身份验证：
# 进入你的项目目录
cd your-project
# 启动 Claude Code
claude
首次启动会自动打开浏览器进行 OAuth 认证，你可以选择：
Claude Pro/Max 订阅：直接使用你的订阅账户
API Key：按用量付费，适合企业用户
第三方平台：如 Amazon Bedrock、Microsoft Foundry 等
自定义 API 端点配置（如需使用中转服务）：
# 临时配置（当前会话有效）
export ANTHROPIC_API_KEY=你的key
export ANTHROPIC_BASE_URL=https://你的中转地址
# 永久配置（写入 ~/.claude/settings.json）
echo '{
"env": {
"ANTHROPIC_API_KEY": "你的key",
"ANTHROPIC_BASE_URL": "https://你的中转地址"
}
}' > ~/.claude/settings.json
二、基础使用：掌握核心交互模式
2.1 三种核心工作模式
Claude Code 提供三种交互模式，通过 Shift \\+ Tab 可以快速切换：
| 默认模式 | ? for shortcuts | 每次文件修改都询问确认 | 日常开发，安全第一 |
| 自动模式 | Accept edits on | 自动同意所有文件修改 | 信任任务，无人值守 |
| 规划模式 | Plan mode on | 只讨论方案，不修改文件 | 架构设计、需求讨论 |
2.2 常用斜杠命令
Claude Code 内置了丰富的斜杠命令，输入 / 即可看到所有可用命令：
# 查看当前会话的 Token 消耗
/cost
# 清空对话历史，重置上下文
/clear
# 压缩对话历史，保留关键信息
/compact
# 初始化项目，生成 CLAUDE.md
/init
# 创建 Git 提交，自动生成 commit 信息
/commit
# 回滚到之前的会话状态
/rewind
# 查看后台任务
/tasks
# 切换模型
/model
# 查看上下文使用情况
/context
2.3 实用快捷键
掌握这些快捷键，让你的操作效率翻倍：
| Opt/Alt \\+ Enter | 换行（不提交） |
| Ctrl \\+ G | 打开 VS Code 编辑长文本 |
| Ctrl \\+ B | 将当前命令放入后台 |
| Esc | 取消当前输入 / 回到主界面 |
| Alt \\+ T | 切换 Thinking 模式开关 |
| Shift \\+ Tab | 切换工作模式 |
2.4 终端命令与后台任务
Claude Code 内置了终端交互能力，无需切换窗口：
# 输入 ! 进入 Bash 模式，执行任意命令
! npm install lodash
! git status
! ls -la src/
# 长时间运行的服务可以放入后台
# 运行 npm run dev 后按 Ctrl+B
# 服务会在后台运行，你可以继续和 Claude 对话
查看和管理后台任务：
/tasks # 列出所有后台任务
# 在任务列表中按 x 结束任务，Esc 返回
三、效率倍增：10 个让你事半功倍的技巧
3.1 @ 语法：精准引用文件
使用 @ 符号可以直接引用文件，让 Claude 精准定位到你要处理的内容，避免它盲目搜索整个项目：
# 直接引用文件
查看 @src/components/Button.tsx 的代码，帮我添加 hover 样式
# 引用整个目录
帮我重构 @src/components/ 下的所有组件
# 引用 Git 差异
帮我分析 @git diff 的变更
3.2 版本回滚：一键撤销操作
如果 Claude 的修改出了问题，不用手动恢复，一键回滚：
# 输入 /rewind 或者连续按两次 Esc
/rewind
然后选择你要回滚的时间点，可以选择：
回滚代码和对话
仅回滚对话
仅回滚代码
3.3 多模态输入：看图写代码
Claude Code 支持直接拖拽图片到终端，让它根据设计稿生成代码：
# 直接拖拽图片文件到输入框，然后输入：
根据这个设计稿，帮我生成对应的 React 组件
注意：macOS 下粘贴图片请使用 Ctrl \\+ V，而非 Cmd \\+ V
3.4 权限管理：安全与效率的平衡
Claude Code 对终端命令有严格的权限控制，如果你信任当前任务，可以开启跳过权限模式：
# 启动时跳过所有权限检查（谨慎使用！）
claude –dangerously-skip-permissions
⚠️ 警告：这个模式下 Claude 拥有和你相同的终端权限，会自动执行所有命令而不询问，仅在信任的项目中使用。
3.5 SubAgent：分身协作处理大任务
对于复杂任务，可以让 Claude 启动子代理来处理，避免主上下文被污染：
# 让子代理做代码审查
用子代理帮我做这段代码的安全审查
# 让子代理搜索代码库
用子代理帮我找出所有用到 old_api 的地方
子代理拥有独立的上下文，处理完任务后只会返回结果，不会把中间过程污染到主对话。
四、Token 成本优化：让你的预算翻倍
很多人抱怨 Claude Code 太贵，其实是没用对方法。通过以下 7 个技巧，可以让你的 Token 消耗暴降 80%。
4.1 精准提示词：一句话省 80% 探索开销
错误的提问方式：
帮我看看登录功能有什么问题
这种提问会让 Claude 遍历整个项目搜索，消耗 1.5-2.5 万 Token。
正确的提问方式：
查看 src/auth/login.ts 第 45 行，JWT 验证里 exp 字段没检查，
加上过期时间校验，过期时抛 AuthExpiredError。
不需要解释，直接给代码。
这种精准提问只需要 3-5 千 Token，直接省了 70-80%。
提示词公式：做什么 \\+ 在哪个文件 \\+ 具体改什么 \\+ 限制条件
常用限制语：
-
不需要解释：省 500-2000 Token
-
只修改这个文件：避免连带修改其他文件
-
不需要写测试：跳过测试生成
-
简洁回复：减少废话输出
4.2 /compact 和 /clear：及时清理上下文
对话越长，Token 消耗越高。每一条消息都要重读整个历史：
# 完成一个子任务后，压缩上下文
/compact 保留所有代码修改记录，丢弃分析过程
# 完全切换任务时，彻底清空
/clear
最佳实践：一个会话只解决一个独立任务。任务完成就清空，绝不一个会话用到底。
4.3 [CLAUDE.md](CLAUDE.md) 瘦身：只保留高频规则
[CLAUDE.md](CLAUDE.md) 的内容每次会话都会加载，很多人把它写成了项目百科全书，一个文件 3000 Token，每次对话都要花这钱。
正确做法：
-
只放最核心、最频繁使用的规则
-
低频指令迁移到 Skill 中（按需加载）
-
把 [CLAUDE.md](CLAUDE.md) 从 3000 Token 瘦到 500 Token，每次对话省 2500 Token
4.4 .claudeignore：从源头过滤垃圾文件
创建 \\.claudeignore 文件，告诉 Claude 哪些文件永远不需要看：
# .claudeignore 模板
node_modules/
dist/
build/
.git/
vendor/
*.lock
*.min.js
*.min.css
*.map
coverage/
__pycache__/
这可以避免 Claude 读取那些又大又没用的文件，一次就能省数万 Token。
4.5 MCP 按需开关：不用的工具就关掉
每个 MCP Server 的工具定义都会注入到系统提示词，6 个 MCP 可能就占了 2 万 Token。
做法：
-
只开当前任务需要的 MCP Server
-
做完就关掉
-
定期用 /context 查看 MCP 占了多少 Token
4.6 模型分层调用：别用大炮打蚊子
不同模型价格天差地别，按任务选模型：
| Haiku | 改变量、修拼写、格式化 | 1/10 |
| Sonnet | 日常开发、写功能、修 Bug | 1 |
| Opus | 架构设计、复杂推理 | 5 |
# 切换模型
/model claude-sonnet-4-5
/model claude-opus-4-5
4.7 善用缓存：重复内容只付一次钱
Claude 有 5 分钟的缓存窗口，相关任务尽量在 5 分钟内完成，最大化缓存命中率：
# 尽量连续操作，避免长时间间隔
# 保持配置稳定，不要频繁改 MCP/Skill
五、Skill 系统：按需加载的能力插件
Skill 是 Claude Code 的能力扩展系统，它和 [CLAUDE.md](CLAUDE.md) 不同，是按需加载的 —— 只有当任务匹配时才会注入上下文，不触发就不消耗 Token。
5.1 什么是 Skill？
Skill 本质上是一个 Markdown 文件，包含了特定任务的最佳实践和工作流程。它就像是给 Claude 的专业说明书，让它在处理特定任务时更专业。
Skill 的分类：
-
知识型：代码审查规范、安全规范
-
流程型：PR 创建流程、发布流程
-
工具型：数据库迁移、测试运行
5.2 安装和使用 Skill
Claude Code 内置了 find\\-skill 元 Skill，可以用自然语言搜索社区 Skill：
# 在 Claude 会话中
/find-skill 我需要一个代码审查的 Skill
/find-skill 帮我找一个生成 API 文档的工具
Claude 会自动搜索匹配的 Skill 并协助你安装。
5.3 Skill 的作用域
Skill 支持两级作用域：
-
全局 Skill：\\~/\\.claude/skills/，对所有项目生效
-
项目 Skill：\\.claude/skills/，仅对当前项目生效
5.4 自定义 Skill 编写
你可以很容易编写自己的 Skill：
—
name: code-review
description: 代码审查，检查安全漏洞和性能问题
—
当用户要求做代码审查时，按照以下步骤执行：
1. 首先读取目标文件的完整内容
2. 检查以下几个方面：
– SQL 注入风险
– XSS 漏洞
– 权限检查
– N+1 查询问题
– 内存泄漏
3. 每个问题都要给出具体的行号和修复建议
4. 按严重程度排序：Critical > High > Medium > Low
把这个文件保存为 \\.claude/skills/code\\-review\\.md，下次你说 "帮我审查这个代码"，Claude 就会自动加载这个 Skill。
六、MCP：连接外部世界的万能接口
MCP（Model Context Protocol）是 Claude Code 连接外部服务的标准协议，通过它，Claude 可以直接操作 GitHub、数据库、Figma、浏览器等外部工具，实现跨系统自动化。
：让 AI 真正懂你的项目
[CLAUDE.md](CLAUDE.md) 是 Claude Code 的项目配置文件，它就像是给新同事的入职手册，告诉 Claude 你的项目是怎么组织的、有哪些约定、该怎么干活。
8.1 什么是 [CLAUDE.md](CLAUDE.md)？
[CLAUDE.md](CLAUDE.md) 是一个放在项目根目录的 Markdown 文件，Claude 每次启动会话都会自动读取它。有了它，你再也不用每次都解释：
-
这个项目用什么技术栈？
-
测试命令是什么？
-
代码风格是什么？
-
哪些目录不能改？
8.2 快速生成：用 /init 起步
不用从零开始写，Claude 可以帮你生成第一版：
# 在项目根目录启动 Claude
claude
# 运行 init 命令
/init
Claude 会自动扫描你的项目，检测技术栈、目录结构、常用命令，帮你生成一个基础的 [CLAUDE.md](CLAUDE.md)。
8.3 [CLAUDE.md](CLAUDE.md) 编写模板
一个标准的 [CLAUDE.md](CLAUDE.md) 应该包含这些内容：
# 项目名称
FastAPI + React 后台管理系统
## 技术栈
– 前端：React 18 + TypeScript + Vite + Tailwind CSS
– 后端：FastAPI + Python 3.11 + SQLAlchemy
– 数据库：PostgreSQL 14
– 测试：pytest / Vitest
## 目录结构
– `frontend/` – 前端代码
– `backend/` – 后端代码
– `backend/app/models/` – 数据库模型
– `backend/app/api/` – API 路由
– `frontend/src/components/` – React 组件
## 常用命令
```bash
# 前端开发
cd frontend && npm run dev
# 后端开发
cd backend && uvicorn app.main:app –reload
# 运行测试
cd backend && pytest tests/
cd frontend && npm run test
# 代码检查
cd backend && ruff check .
cd frontend && npm run lint
代码规范
-
前端用 2 空格缩进
-
后端用 4 空格缩进，遵循 PEP 8
-
所有函数都要有类型注解
-
Commit 信息遵循 Conventional Commits
约束规则
-
不要修改 backend/app/generated/ 下的文件，这是自动生成的
-
数据库变更必须生成 Alembic 迁移文件
-
所有 API 必须有错误处理和日志
-
新增功能必须配套测试用例
### 8.4 分层加载机制
Claude Code 支持多层 CLAUDE.md，自动继承和覆盖：
– **用户级**：`~/.claude/CLAUDE.md` – 你的全局偏好
– **项目级**：`./CLAUDE.md` – 项目通用规则
– **子目录级**：`./backend/CLAUDE.md` – 特定目录的规则
越靠近当前目录的规则优先级越高。
### 8.5 让 CLAUDE.md 持续进化
CLAUDE.md 不是写一次就完事了，它应该随着项目一起进化：
1. **日常记录**：每次你纠正 Claude 的时候，把这个规则加到 CLAUDE.md
2. **/reflection 命令**：会话结束后，让 Claude 总结本次经验：
```bash
/reflection
/insights 报告：定期查看使用报告，发现重复的问题：
/insights
九、高级玩法：Hooks 与自定义命令
9.1 Hooks：事件驱动的自动化
Hooks 让你在特定事件发生时自动执行命令：
// .claude/settings.json
{
"hooks": {
"PostToolUse": {
"Edit": "echo '📝 文件已修改: $FILENAME'",
"Bash": "echo '⚡ 命令已执行'"
},
"SessionStart": "echo '👋 欢迎使用 Claude Code!'"
}
}
支持的事件：
-
PreToolUse：工具调用前
-
PostToolUse：工具调用后
-
SessionStart：会话启动时
-
SessionEnd：会话结束时
9.2 自定义斜杠命令
把你常用的提示词保存为自定义命令：
# 创建 .claude/commands/performance-optimization.md
# 性能优化分析
分析提供的代码，找出性能瓶颈，覆盖以下方面：
– 数据库 N+1 查询问题
– 算法时间复杂度
– 内存泄漏风险
– 前端渲染性能
代码如下：
$ARGUMENTS
然后你就可以直接用：
/performance-optimization @src/utils/query.ts
十、总结
Claude Code 不是一个简单的 AI 聊天工具，它是一个完整的开发协作平台。通过掌握：
-
基础安装与交互：5 分钟上手，掌握三种工作模式
-
效率技巧：@引用、后台任务、版本回滚
-
成本优化：7 个技巧让 Token 消耗降 80%
-
Skill 系统：按需加载的专业能力
-
MCP 集成：连接外部世界的万能接口
-
头脑风暴：先想清楚再动手
-
[CLAUDE.md](CLAUDE.md)：让 AI 真正懂你的项目
你就可以把 Claude Code 从一个 "写代码的工具"，变成你真正的结对编程伙伴，让开发效率提升 10 倍。
💡 最后提醒：从简单开始，先把 [CLAUDE.md](CLAUDE.md) 写好，再逐步添加 Skill 和 MCP，你会发现开发从未如此轻松。
