Claude Code 完全使用教程从安装到精通

2026 最新版 · 深度教程

Claude Code完全使用教程从安装到精通

一篇写给所有开发者的 Claude Code 深度指南。无论你是第一次接触 AI 编程工具，还是想系统掌握高级功能，这篇文章都能帮到你。

2026.04约 25 分钟阅读v2.1+

13.5万GitHub 日提交量4%占公共 GitHub 提交比例90%Anthropic 内部 AI 辅助代码比例

Claude Code 不是浏览器里的聊天机器人，也不是 IDE 里的代码补全插件——它是一个终端原生的 AI 编程智能体，直接运行在你的终端里，能够读取你的整个项目、编辑文件、执行命令、管理 Git，全部通过自然语言对话完成。

SECTION 01

前置准备与系统要求

系统要求

Claude Code 对硬件的要求很低。所有 AI 推理都在 Anthropic 的服务器上运行，你的电脑只是运行一个轻量级的 CLI 客户端。不需要 GPU。

项目	要求
操作系统	macOS 13.0+ / Ubuntu 20.04+ / Debian 10+ / Windows 10 (1809+)
内存	最低 4GB，推荐 8GB
网络	需要稳定的网络连接
Node.js	原生安装器无需；npm 方式需 18.0+

账户与定价

Claude Code 不支持免费账户。你需要以下任一付费方案：

方案	月费	适合人群
Claude Pro	$20/月	大多数个人开发者
Claude Max	$100–200/月	重度使用者，需要更高限额
Teams	$25/座/月	团队协作
Enterprise	联系销售	企业级需求
Console (API)	按量计费	偶尔使用或 CI/CD 集成

💡 费用提示

如果你只是偶尔使用，Console 按量付费可能更划算。Sonnet 4.6 的价格是每百万输入 token $3.00、输出 $15.00，一次重度编程会话的 API 成本约 $0.50 ~ $2.00。

SECTION 02

安装 Claude Code

推荐方式：原生安装器

2026 年官方推荐的安装方式。零依赖、无需 Node.js、后台自动更新。

macOS / Linux：

curl-fsSLhttps://claude.ai/install.sh|sh

Windows（PowerShell）：

irmhttps://claude.ai/install.ps1|iex

⚠ 重要

安装完成后，打开一个新的终端窗口让 PATH 生效，然后验证安装：

claude--version# 查看版本号claudedoctor# 检查安装健康状态claudewhoami# 查看认证信息

备选方式：Homebrew（macOS）

brewinstall--cask claude-code

注意：Homebrew 不会自动更新，需要手动 brew upgrade claude-code。

备选方式：npm

npminstall-g @anthropic-ai/claude-code

npm 方式已不再推荐，但仍可用，适合锁定特定版本的场景。需要 Node.js 18.0+。遇到权限错误时不要用 sudo，应使用 nvm 管理 Node.js。

SECTION 03

首次使用与认证

在你的项目根目录下打开终端，输入：

claude

首次运行会自动打开浏览器引导登录。凭证保存在 ~/.claude/ 目录下，后续无需重复登录。

如果在远程服务器上（无浏览器），Claude Code 会提供一个 URL，可在其他设备上完成认证。

进入会话后，试试这些入门指令来熟悉工具：

这个项目是做什么的？帮我找到所有的 API 端点，列出每个端点的功能当前代码里有哪些明显的安全隐患？

Claude 会自动扫描代码库、理解项目结构，然后给出全面的回答。

SECTION 04

核心配置：CLAUDE.md

CLAUDE.md 是 Claude Code 最重要的配置机制。放在项目根目录下，Claude 每次启动时自动读取。你可以把它理解为给 AI 助手写的一份「员工手册」。

快速生成

/init

Claude 会分析代码库，自动生成一份适合你项目的 CLAUDE.md。

应该写什么

# 项目概述 这是一个基于 Next.js 14 的电商平台，使用 TypeScript 编写。 # 技术栈 - 前端：Next.js 14 + React 18 + Tailwind CSS - 后端：Next.js API Routes + Prisma ORM - 数据库：PostgreSQL # 编码规范 - 使用函数式组件和 React Hooks，不使用 class 组件 - 所有组件使用 TypeScript 严格模式 - CSS 统一使用 Tailwind，不写自定义 CSS 文件 - 提交信息使用 Conventional Commits 格式 # 常用命令 - 开发服务器：npm run dev - 运行测试：npm test - 类型检查：npx tsc --noEmit # 注意事项 - 所有数据库查询使用 Prisma，不要写原始 SQL - API 路由必须做参数验证 - 敏感信息存放在 .env.local，不要硬编码

配置层级

Claude Code 按层级读取多个 CLAUDE.md 文件：

~/.claude/CLAUDE.md → 全局配置，对所有项目生效
项目根目录/CLAUDE.md → 项目级配置
子目录/CLAUDE.md → 特定目录的额外规则

子目录的规则会补充（而非覆盖）上级规则。

SECTION 05

斜杠命令完全指南

在 Claude Code 中输入 / 可以看到所有可用命令。以下是最重要的内置命令：

会话管理

命令	功能
`/help`	显示所有可用命令（包括自定义命令）
`/clear`	清空当前对话历史
`/compact`	压缩对话历史，释放上下文空间
`/exit`	退出 Claude Code
`/cost`	查看当前会话的 token 消耗
`/model`	切换 AI 模型

开发工具

命令	功能
`/diff`	查看 Claude 所做的所有更改的交互式差异视图
`/plan`	进入计划模式，让 Claude 先规划再执行
`/review`	对代码进行审查
`/init`	初始化项目的 CLAUDE.md
`/permissions`	管理权限设置
`/hooks`	交互式配置钩子
`/skills`	列出所有可用技能

💡 关于 /compact

/compact 是长会话的救星。当 Claude 开始「遗忘」之前的内容时，它能压缩历史记录释放上下文。还可以加聚焦提示：/compact 保留关于认证模块重构的上下文

SECTION 06

Plan Mode（计划模式）

这是 Claude Code 最强大的功能之一，尤其适合复杂任务。

分析问题 — 读取相关文件，追踪依赖关系，识别影响范围

制定计划 — 列出要修改的文件、修改顺序和原因

展示推理 — 你能看到 Claude 的完整思考路径

等待批准 — 不会在你确认前执行任何操作

适用场景：

跨多个文件的大规模重构
添加涉及路由、控制器、模型和测试的新功能
在不熟悉的代码库中理解修改的影响范围
学习——通过阅读 Claude 的推理过程来理解代码库

/plan将认证模块从 session cookies 迁移到 JWT tokens

SECTION 07

日常开发工作流

写代码

给注册表单添加邮箱验证功能，包括格式检查和重复检查

Claude 会自动找到相关文件，规划修改方案，展示 diff，等你确认后再应用。

修 Bug

用户反馈在移动端登录表单无法提交。我怀疑是表单验证的问题。表单在 src/components/Login.jsx

写测试

给 auth 模块写测试，运行测试，修复失败的用例

Git 操作

用描述性的 commit message 提交我的更改创建一个新分支，实现用户评论功能，然后提交 PR

高效提示的技巧

核心原则：说清楚目标，让 Claude 来规划实现方式。

✗ 不推荐

让代码更好

✓ 推荐

重构这个组件以提高可维护性： - 提取逻辑为自定义 hooks - 添加 TypeScript 类型 - 编写单元测试

✗ 微管理

先检查文件，然后看第 42 行， 然后修改条件判断...

✓ 描述问题

用户反馈仪表盘加载很慢， 请调查性能问题并提出优化方案

SECTION 08

模型选择策略

模型	适用场景	建议
Sonnet 4.6	日常编码任务	80% 的时间用它——速度快、性价比高
Opus 4.6	复杂推理、架构设计、多文件重构	20% 的时间用它——处理高难度问题
Haiku 4.5	简单探索、快速问答	节省 token 的好选择

使用 /model 命令切换，或在启动时指定：

claude--model opus

SECTION 09

Skills（技能系统）

Skills 允许你通过 Markdown 文件教会 Claude 处理特定任务。它们是 Claude Code 的扩展系统。

创建自定义 Skill

在 ~/.claude/skills/ 下创建目录和 SKILL.md 文件：

# 文件路径：~/.claude/skills/explain-code/SKILL.md --- name: explain-code description: 用可视化图表和类比来解释代码 command: /explain --- 解释代码时，始终包含以下步骤： 1. **先做类比**：将代码比作日常生活中的事物 2. **画一张图**：用 ASCII 字符画展示流程 3. **逐步讲解**：解释每一步发生了什么 4. **指出陷阱**：常见的错误或误解是什么？

项目级技能

将技能放在 .claude/skills/ 目录中并提交到 Git，团队所有成员自动获得相同命令。

# .claude/skills/tdd/SKILL.md --- name: TDD Workflow description: 严格的测试驱动开发流程 command: /tdd --- 按照严格的 TDD 流程工作： 1. 先写一个失败的测试，运行，确认失败 2. 编写最少量代码让测试通过 3. 运行测试，确认通过 4. 重构代码，再次运行测试

💡 技能 vs 命令

旧版的 .claude/commands/ 仍然可用，但官方推荐使用 .claude/skills/，因为它支持附带模板文件、前置配置等更多功能。用 /skills 可以列出所有可用技能。

SECTION 10

Hooks（钩子自动化）

Hooks 让你在 Claude 执行特定操作时自动运行 shell 命令。与提示词不同，Hooks 保证执行——不管模型怎么想。

{"hooks": {"PostToolUse": [{"matcher": "Write(*.py)",         "hooks": [{"type": "command",           "command": "python -m black $file"}]},       {"matcher": "Write(*.ts)",         "hooks": [{"type": "command",           "command": "npx prettier --write $file"}]}]}}

效果：每当 Claude 写入 .py 文件时自动运行 Black 格式化，写入 .ts 文件时自动运行 Prettier。

你也可以在会话中输入 /hooks，通过交互式菜单配置，比手动编辑 JSON 更方便。

SECTION 11

MCP（模型上下文协议）

MCP 是一个开源标准协议，让 Claude Code 连接到外部工具和数据源。配置 MCP 后，Claude Code 从编程助手升级为集成式开发平台。

添加 MCP 服务器

# GitHub 集成claude mcp add github -- npx -y @modelcontextprotocol/server-github # PostgreSQL 数据库claude mcp add postgres -- npx -y @modelcontextprotocol/server-postgres # HTTP 远程服务（如 Notion）claude mcp add notion --transport http https://mcp.notion.com/mcp# 查看已配置的服务器claude mcp list

实际应用

查看 JIRA 上 ENG-4521 的需求描述，实现它并创建 PR检查 Sentry 上最近的错误日志，找到根因并修复根据 Slack 里发的最新 Figma 设计图，更新邮件模板

过去需要在多个工具间反复切换的工作，现在一句话搞定。

SECTION 12

权限管理

Claude Code 采用权限审批机制——默认每次文件修改和命令执行都需要你确认。

权限模式

# 自动接受文件编辑（仍需确认命令执行）claude--permission-mode acceptEdits # 跳过所有权限检查（谨慎使用！）claude--dangerously-skip-permissions

精细控制

{"permissions": {"allowedTools": ["Read", "Write", "Bash(git *)"],     "deny": ["Read(./.env)",       "Read(./.env.*)",       "Write(./production.config.*)"]}}

允许读写文件和运行 Git 命令，但禁止读取 .env 和修改生产配置。

SECTION 13

IDE 与 CI/CD 集成

VS Code / Cursor

Claude Code 提供 VS Code 扩展，支持内联差异视图、@ 文件引用、计划审查和对话历史。在扩展市场搜索「Claude Code」安装，然后 Cmd+Shift+P 打开命令面板，选择 "Claude Code: Open in New Tab"。

自动代码审查

运行 /install-github-app，Claude 会自动对每个 PR 进行审查。它会在项目中添加 claude-code-review.yml 配置文件，你可以自定义审查重点。

非交互式模式（CI 集成）

claude-p"检查这个 PR 的安全风险"< diff.txt

SECTION 14

快捷键速查

Ctrl+C中断当前回复，保持对话Ctrl+D结束整个会话@文件名引用特定文件!命令直接执行 shell，节省 token💡!前缀

如果你只是想跑 git status，用 !git status 比让 Claude 帮你跑要快得多，也不消耗 AI token。

SECTION 15

常见问题排查

`claude`命令找不到？

打开新终端窗口。如果仍然找不到：

echo'export PATH="$HOME/.local/bin:$PATH"'>> ~/.zshrc source ~/.zshrc

Windows 上 MCP 服务器连接失败？

原生 Windows（非 WSL）需要加 cmd /c 包装器：

claude mcp add my-server --cmd /c npx -y @some/package

遇到速率限制？

使用 /compact 压缩上下文减少 token 消耗，或升级到 Max 方案获取更高限额。也可以用 /model 切换到更轻量的模型（如 Haiku）来处理简单任务。

如何在团队中标准化？

将 CLAUDE.md、.claude/skills/ 和 .claude/settings.json 提交到 Git。新成员克隆项目后自动获得所有配置。

SECTION 16

最佳实践总结

1从项目根目录启动，确保 Claude 能理解完整的项目上下文2投入时间写好 CLAUDE.md，这是提升输出质量最有效的方式3善用 Plan Mode，大型修改前先让 Claude 制定计划4合理选择模型：日常用 Sonnet，复杂任务用 Opus5用 /compact 管理长会话，避免上下文溢出6用 /diff 检查每一批修改，在继续前确认没有问题7配置 Hooks 自动化质量保障，格式化、lint、类型检查都应自动触发8接入 MCP 减少工具切换，让开发流程在终端内闭环9将配置纳入版本控制，确保团队一致性

学习 Claude Code 最好的方式就是在真实项目中使用它。从一个小任务开始，端到端地完成，然后逐步探索更复杂的工作流。

AI 工具再强大，也是为人服务的。保持你的工程判断力，审查每一个修改，理解每一行代码。

📖 官方文档 →