一、什么是 Claude Code？

Claude Code 是 Anthropic 推出的终端 AI 编程助手，核心特点：

特性	说明
终端原生	直接在终端运行，无缝融入你的开发工作流
Agent 能力	不只是回答问题，能直接编辑文件、执行命令、操作 Git
超长上下文	200K Token，能读完整个代码库
多语言支持	40+ 编程语言，包括前端、后端、移动端、数据科学
工具调用	可调用 npm、git、curl 等外部工具

一句话总结：Copilot 只能帮你补全代码，Claude Code 能帮你完成整个开发任务。

---

二、安装指南

2.1 前置条件

要求	说明
操作系统	macOS 10.15+ / Ubuntu 20.04+ / Windows 10+（推荐 WSL2）
网络	需要访问 Anthropic 服务（国内需代理或 API 中转）
账号	Claude.ai 账号 或 Anthropic API Key

2.2 安装方式

方式一：官方原生安装（推荐，无需 Node.js）

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

macOS Homebrew：

brew install --cask claude-code

Windows WinGet：

winget install Anthropic.ClaudeCode

方式二：npm 安装

# 确保已安装 Node.js 18+
npm install -g @anthropic-ai/claude-code

验证安装

claude --version
# 输出: Claude Code v2.x.x

---

三、配置与首次启动

3.1 API Key 配置

创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-xxxxxxxxxxxxx",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

3.2 国内用户特别注意

由于 Anthropic 限制了中国大陆的直接访问，国内开发者有两种方案：

方案 A：API 中转站（推荐）

使用第三方 API 中转服务，将 ANTHROPIC_BASE_URL 替换为中转站地址：

{
  "env": {
    "ANTHROPIC_API_KEY": "你的中转站Key",
    "ANTHROPIC_BASE_URL": "https://api.yixia.ai"
  }
}

方案 B：代理 + 官方 API

在终端开启代理后直接使用官方 API：

# 设置代理（根据你的代理工具修改端口）
export https_proxy=http://127.0.0.1:7890
export http_proxy=http://127.0.0.1:7890

3.3 首次启动

cd 你的项目目录
claude

首次启动会引导你完成 OAuth 认证或 API Key 配置，跟着提示走就行。启动成功后你会看到这样的交互界面：

> claude
​
Claude Code v2.x.x
Type /help for available commands.
​
> _

---

四、基础使用

4.1 第一个对话

进入 Claude Code 后，直接用自然语言描述需求即可：

> 帮我看看这个项目的目录结构，简述主要模块
> 这个 utils.ts 里的 calculatePrice 函数干了什么？
> 给这段代码加上类型注解

4.2 核心工作流

一个标准的 Claude Code 使用流程：

1. 描述需求 → "帮我用 React 写一个带搜索功能的表格组件"

2. AI 分析代码库 → Claude 会读取项目文件，理解你的技术栈

3. 生成方案 → 告诉你要创建哪些文件、修改哪些代码

4. 执行操作 → 自动创建文件、写入代码

5. 验证结果 → 运行测试或启动项目检查效果

4.3 权限模式

Claude Code 有三种权限模式，按需切换：

模式	说明	适用场景
普通模式	文件操作和命令执行需你确认	谨慎操作、第一次使用
自动接受模式	自动执行所有操作	熟悉的项目、高效开发
Plan 模式	只生成计划不写代码	复杂需求，先讨论方案再动手

关闭自动确认以提高效率：

> 从今以后不要再问我确认，所有的操作直接执行

---

五、核心命令速查

5.1 斜杠命令（Slash Commands）

命令	功能
/help	查看帮助
/init	初始化项目 CLAUDE.md
/model	切换模型（Opus / Sonnet / Haiku）
/compact	压缩上下文，节省 Token
/undo	撤销上一步修改
/cost	查看当前会话费用
/clear	清空对话历史
/doctor	诊断配置问题
/status	查看当前会话状态
/add-dir	添加工作目录
/permissions	管理权限设置

5.2 快捷键

快捷键	功能
Ctrl + R	搜索历史命令
Ctrl + L	清屏
Esc	打断当前 AI 操作
Shift + Enter	输入多行内容
@文件名	快速引用文件
↑ / ↓	浏览历史命令

5.3 快捷引用文件

> @src/components/Table.tsx 帮我把这个组件改成虚拟滚动
> @package.json 看看有哪些依赖可以升级

---

六、CLAUDE.md——让 AI 真正懂你的项目

这是 Claude Code 最容易被忽视但最有价值的功能。

6.1 什么是 CLAUDE.md？

CLAUDE.md 是放在项目根目录的 Markdown 文件，Claude Code 在每次对话时都会自动读取它。你可以在里面写：

• 项目的技术栈和架构说明

• 编码规范和命名约定

• 常用的命令和脚本

• 注意事项和踩过的坑

6.2 自动生成

> /init

Claude Code 会扫描你的整个项目，自动生成一份高质量的 CLAUDE.md。

6.3 手动编写参考

# CLAUDE.md
​
## 项目概述
这是一个基于 Next.js 14 的电商后台管理系统。
​
## 技术栈
- 框架：Next.js 14 (App Router)
- 语言：TypeScript 5.x
- UI 库：Ant Design 5.x
- 状态管理：Zustand
- 请求库：TanStack Query
​
## 编码规范
- 组件名使用 PascalCase
- 文件名使用 kebab-case
- API 路由放在 app/api/ 下
- 使用 TypeScript 严格模式，禁止 any
​
## 常用命令
- 开发：pnpm dev
- 构建：pnpm build
- 测试：pnpm test
- 类型检查：pnpm type-check
​
## 注意事项
- 图片资源统一放在 public/images/
- 环境变量使用 NEXT_PUBLIC_ 前缀才能在客户端访问
- 不要直接修改 .prisma 文件，统一通过 migration 管理

写好 CLAUDE.md 后，AI 的代码质量会有质的飞跃。

---

七、实战场景

场景一：快速读懂陌生项目

> 我刚接手这个项目，帮我梳理整体架构

Claude Code 会扫描项目结构、package.json、关键配置文件，生成一份清晰的项目地图。

场景二：批量修复 Lint 错误

> 帮我看看 ESLint 报的错，全部帮我修掉

它会逐个分析并修复，比你自己手动改快 10 倍。

场景三：添加新功能

> 帮我给用户列表页加一个按角色筛选的功能，角色数据从 /api/roles 接口获取

Claude Code 会：

1. 找到用户列表组件

2. 分析现有代码风格

3. 添加筛选 UI 和数据请求逻辑

4. 符合项目现有的编码规范

场景四：代码重构

> 把这个 class 组件改成函数组件 + Hooks 的写法
> 把这里的 axios 调用统一改成我们项目用的 request 封装

场景五：写单元测试

> 给 src/utils/format.ts 里的所有函数写单元测试

场景六：Debug

直接粘贴报错信息：

> Uncaught TypeError: Cannot read properties of undefined (reading 'map')
> 在 Dashboard.tsx 第 45 行
> 帮我修复

Claude Code 会定位问题、分析原因、给出修复方案。

---

八、进阶技巧

8.1 自定义 Skills（技能）

在 ~/.claude/ 目录下创建自定义技能，让 AI 执行特定领域的任务。

例如创建 ~/.claude/skills/review.md：

# Code Review Skill
​
当我说 /review 时，请按照以下标准审查代码：
1. 是否有安全漏洞（XSS、SQL注入、越权）
2. 是否有性能问题（不必要的重渲染、内存泄漏）
3. 错误处理是否完善
4. 是否符合项目的编码规范

8.2 MCP 扩展

通过 MCP（Model Context Protocol）集成外部工具：

> 帮我在 GitHub 上创建一个 PR
> 看看 Jira 上分配给的我 Bug 单
> 从 Figma 设计稿生成对应的 CSS

配置 MCP 服务器在 ~/.claude/mcp.json：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-github"]
    }
  }
}

8.3 Hooks（钩子）

在 ~/.claude/settings.json 中配置 Hook，在执行前后自动触发操作：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "echo \"即将执行命令...\""
      }
    ]
  }
}

8.4 内存/记忆系统

Claude Code 支持持久记忆，在 ~/.claude/projects/ 目录下保存：

• 你的个人偏好

• 项目的上下文信息

• 反馈和修正记录

AI 会在后续对话中自动读取这些记忆，越来越"懂你"。

8.5 多模型切换

> /model
# 选择 Opus（最强推理，复杂任务）
# 选择 Sonnet（平衡速度和质量，日常使用）
# 选择 Haiku（最快速度，简单任务）

建议：

• 写代码、改 Bug：用 Sonnet

• 架构设计、复杂重构：用 Opus

• 简单查询、格式化：用 Haiku

---

九、费用说明

方案	价格	适用人群
Claude Pro	$20/月	个人开发者，日常轻度使用
Claude Max 5x	$100/月	重度使用，每天大量交互
Claude Max 20x	$200/月	专业团队，极限使用量
API 按量	按 Token 计费	灵活使用，按需付费

白嫖党小技巧：

• 用 /compact 压缩上下文节省 Token

• 简单任务切到 Haiku 模型

• 善用 CLAUDE.md 减少重复解释

---

十、常见问题（FAQ）

Q1：和 GitHub Copilot 有什么区别？

Copilot 是代码补全（写下一行），Claude Code 是任务执行（完成整个需求）。两者可以互补使用。

Q2：支持哪些 IDE？

Claude Code 是终端工具，可以在 VS Code、JetBrains 等 IDE 的终端中使用。Anthropic 也提供了 VS Code 和 JetBrains 插件。

Q3：代码会上传到哪里？安全吗？

代码通过加密传输到 Anthropic 服务器处理。对于敏感项目，建议使用 API 方式并确认数据使用政策，或关注企业版方案。

Q4：Windows 上能用吗？

可以。推荐通过 WSL2 使用，或直接安装 Windows 原生版本（winget）。

Q5：国内怎么用？

• 个人用户：代理 + 官方 API，或使用 API 中转站

• 企业用户：联系 Anthropic 企业方案

Q6：能离线使用吗？

不能，Claude Code 需要联网调用云端模型。

---

十一、总结

Claude Code 代表了 AI 编程工具从辅助到代理的转变。它不能替代程序员的思考和判断，但能大幅减少重复劳动，让你把精力花在真正重要的事情上。

推荐学习路线：

1. 第 1 天：安装 + 首次对话 + /init 生成 CLAUDE.md

2. 第 1 周：在日常开发中逐步使用，从小任务开始

3. 第 2 周：尝试让它处理完整的功能开发

4. 第 1 月：配置 MCP 扩展、自定义 Skills、完善 CLAUDE.md

用好 Claude Code 的关键不在工具本身，而在于你如何描述需求和提供上下文。

最后送一句话：AI 不会取代程序员，但会用 AI 的程序员会取代不会用的。

---

参考资源

• Claude Code 官方文档

• awesome-claude-code-tutorial — 中文系统教程

• claude-code-chinese/claude-code-guide — 国内使用指南

• Claude Code 阿里云社区全攻略

---

本文写于 2026 年 6 月，Claude Code 版本 2.x，如有更新请以官方文档为准。