Claude Code 是 Anthropic 推出的命令行 AI 编程工具，直接在终端里运行，能够读写文件、执行命令、自主完成复杂编程任务。本文从环境配置到实战场景，完整覆盖国内开发者的使用路径。

一、什么是 Claude Code Claude Code 不是插件，不是浏览器扩展，它是一个 命令行工具（CLI），核心能力： • 理解整个项目结构（自动读取文件树） • 编写、修改、删除文件 • 执行 Shell 命令（包括运行测试、调用 Git） • 多步骤自主完成任务（"帮我把这个 REST API 改成 GraphQL"） 和 GitHub Copilot、Cursor 的区别：它是 Agent 模式，不是补全模式，你给它一个目标，它自己想怎么做。

二、环境要求

​
检查 Node.js 版本（需要 >= 18）#

node -v

安装 Claude Code#

npm install -g @anthropic-ai/claude-code

验证安装

claude --version 如果 npm 安装慢，换 mirror：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

​

三、登录认证 Claude Code 需要 Claude Pro 或 Claude Max 订阅才能使用，不支持 API Key 单独购买（注意区分：这里要的是账号订阅，不是 API）。

claude login 执行后会弹出浏览器让你登录 Anthropic 账号。

国内用户的订阅问题： Anthropic 官网不支持中国大陆支付方式。如果你还没有账号/订阅，推荐通过 ClaudeMax.shop 代付，给的是官方 Team 席位，微信支付，5 分钟内收到 Anthropic 官方邀请邮件。我自己用的这家，稳定半年没出过问题。 （Pro ¥210/月，Max 5x ¥980/月——高频 Claude Code 用户推荐直接 Max 5x，Pro 限额在高强度编程场景下经常触顶）

四、基础使用 进入项目目录，启动 Claude Code：

cd /your/project claude 常用指令模式 单次任务（不进入交互）：

claude "帮我在 src/utils 目录下新建一个 formatDate 工具函数，支持多种格式" 交互模式：

claude> 看一下这个项目的整体结构，找出 TODO 注释并汇总 claude> 帮我写这个功能的单元测试 claude> 把所有 any 类型都改成正确的 TypeScript 类型

五、实战场景演示 场景 1：老项目 TypeScript 类型迁移

claude "这个项目有大量 any 类型，帮我逐个文件分析并改成正确的 TypeScript 类型，优先处理 src/api 目录" Claude Code 会自动： 1 读取 tsconfig.json 理解配置 2 遍历 src/api 所有文件 3 逐个分析类型关系 4 修改文件并确认不破坏编译 场景 2：写测试用例

claude "给 src/services/UserService.ts 的所有 public 方法写 Jest 单元测试，mock 掉数据库调用" 场景 3：代码审查

claude "审查 src/controllers 目录的安全性，重点看 SQL 注入、XSS、未校验输入这三类问题"

六、进阶：claude.md 配置 在项目根目录创建 CLAUDE.md，告诉 Claude Code 项目背景：

项目说明#

技术栈#

• Next.js 15 App Router
• Prisma + PostgreSQL
• 用 zod 做参数校验

代码规范#

• 函数命名用 camelCase
• 文件命名用 kebab-case
• 所有 API 必须有 TypeScript 类型

不要做的事#

• 不要修改 .env 文件
• 不要删除 tests 目录下的文件 有了claude.md，每次会话 Claude Code 都会先读这个文件，给出更符合项目实际的代码。

七、常见问题 Q: 限流了怎么办？Pro 档在重度使用时容易触顶，升级到 Max 5x 可以解决（用量是 Pro 的 5 倍）。 Q: 修改错了能撤销吗？Claude Code 每次操作前会描述要做什么，你可以拒绝。建议在 Git 仓库里使用，每次大改前 commit 一次。 Q: 安全吗？会发送代码到服务器吗？是的，会把相关文件内容发给 Anthropic 的 API 处理。如果是敏感代码库，注意不要把密钥、生产数据库连接等信息放在明文文件里。

资源 • 官方文档： 国内订阅：claudemax.shop（微信支付，10 分钟交付）