如果你已经用过 Cursor、Copilot 这类 IDE 内嵌的 AI 助手，Claude Code 会打开一个新世界：它直接跑在终端里，不需要特定 IDE，能读写整个项目文件、运行命令、执行测试、提交代码——相当于一个 7x24 小时在线的 AI 程序员，你用自然语言给它派活就行。

Claude Code 在终端中的工作界面
Claude Code 在终端中的工作界面

Claude Code vs Cursor vs Copilot：怎么选？

  • GitHub Copilot：行级/函数级补全，适合写代码时减少打字量，不能自主完成任务
  • Cursor：IDE 内 AI 对话 + Agent 模式，可视化操作，适合喜欢图形界面的开发者
  • Claude Code：纯终端，无 GUI，能直接执行命令和脚本，适合后端/DevOps/全栈开发者
  • 核心差异：Claude Code 更像一个「能自己动手的同事」，而不是「给建议的顾问」

第一步：安装和配置

前提条件：Node.js 18+ 和一个 Anthropic API Key（或 Claude Pro/Max 订阅）。

  1. 获取 API Key：登录 console.anthropic.com，创建 API Key
  2. 安装 Claude Code：终端运行 npm install -g @anthropic-ai/claude-code
  3. 首次运行：在项目目录下输入 claude，按提示粘贴 API Key 完成认证
  4. 验证：输入 claude --version 确认安装成功

注意：Claude Pro（$20/月）和 Max（$100/月）订阅用户可以直接用 Claude Code，不需要单独购买 API 额度。Max 版每月约 100 次 Claude Code 会话。

第二步：理解工作模式

Claude Code 有两种核心交互模式：

  • 对话模式：直接在终端输入需求，Claude 分析后给出方案或直接动手
  • Agent 模式：输入 agentic 任务（如「修复所有 lint 错误」），Claude 自主规划步骤并逐个执行

关键概念——「项目上下文」：Claude Code 启动时会自动扫描当前目录的文件结构、package.json/pyproject.toml 等配置，理解项目的技术栈和架构。你不需要手动解释「这是一个 React + Express 项目」。

第三步：实际项目操作

进入你的项目目录，启动 Claude Code：

cd my-project
claude

场景 1：理解陌生代码库

> 这个项目的认证逻辑在哪里？帮我梳理一下登录流程

Claude 会扫描项目文件，找到认证相关代码，给你一个结构化的回答，包含文件路径和关键函数。

场景 2：修 Bug

> 用户反馈登录后 token 过期太快，检查一下 token 过期时间的配置，可能是 1 小时太短了，改成 7 天

Claude 会：找到 token 配置文件 → 修改过期时间 → 如果有相关测试则运行测试 → 给你 diff 让你确认。

场景 3：批量重构

> 把所有用 var 声明的变量改成 let 或 const，根据是否重新赋值判断用哪个

Claude 会遍历所有 JS 文件，逐一分析并修改，最后给你一个完整的变更清单。

第四步：CLAUDE.md — 项目记忆文件

Claude Code 支持在项目根目录放一个 CLAUDE.md 文件，作为给 AI 的「项目说明书」。每次启动自动读取。

# CLAUDE.md

## 项目说明
这是一个基于 Next.js 14 的电商网站，后端用 Supabase。

## 代码规范
- 使用 TypeScript strict mode
- 组件用函数式，不用 class
- CSS 用 Tailwind，不写自定义 CSS
- 提交信息用 conventional commits 格式

## 注意事项
- 不要修改 server/middleware.ts，这是认证核心
- 数据库 schema 在 supabase/migrations/ 下
- 运行测试用 npm test，不要用 jest 直接跑

有了这个文件，Claude 每次操作都会遵循你的规范，不会随意改架构或破坏约定。

第五步：安全与权限控制

Claude Code 可以直接执行终端命令，这很强大但也需要谨慎。权限控制机制：

  • 默认模式：执行命令前会征求你同意（y/n），不会自动跑危险命令
  • 信任模式：claude --dangerously-skip-permissions 可跳过确认，仅在你完全信任的项目中使用
  • 文件白名单：在 CLAUDE.md 中声明「不要修改的文件/目录」，Claude 会遵守
  • Git 安全：默认不会自动 commit/push，需要你确认。不会执行 git push --force

第六步：高效使用技巧

  • 先说目标，别说步骤：写「给用户列表加一个搜索功能」比「先改 UserList.tsx 再改 api.ts」效果好
  • 分步骤提需求：复杂功能拆成 3-5 步，每步确认后再进行下一步
  • 用 /cost 查看消耗：随时输入 /cost 查看 Token 用量和费用
  • 用 /compact 压缩上下文：对话太长时，用 /compact 压缩历史，保留关键信息
  • 配合 Git 使用：每次让 Claude 改代码前先 commit，不满意可以 git reset 回退

成本控制

Claude Code 按 Token 计费。一些实测参考：

  • 理解代码库（读 10 个文件）：约 $0.05-0.10
  • 修一个中等 Bug（改 2-3 个文件）：约 $0.10-0.30
  • 完整功能开发（5-10 个文件改动）：约 $0.50-2.00
  • 大型重构（20+ 文件）：约 $2-10
  • Max 订阅用户：每月 100 次会话，折合每次约 $1，适合日常开发

建议：日常用 Max 订阅额度，大型重构任务用 API Key 按 Token 付费更划算。

常见坑

  • 上下文溢出：项目太大时 Claude 可能「忘记」前面的对话。用 /compact 或分多个会话
  • 幻觉文件路径：偶尔会引用不存在的文件，让它用 ls 确认后再操作
  • 过度修改：有时会改一些你没要求的文件。每次确认 diff 时仔细看，用 n 拒绝不必要的改动
  • 死循环修复：偶尔会在修 Bug 时陷入「改了 A → B 坏了 → 改 B → A 又坏了」的循环。发现后立即 Stop，换思路重新描述