Claude Code 完整教程：AI 编程助手的正确打开方式

Claude Code 是 Anthropic 推出的命令行 AI 编程工具，可以直接在终端里与 Claude 交互，让它读取、修改、运行你的代码。

什么是 Claude Code

Claude Code 不只是一个”在终端里问问题”的工具，它的核心能力是：

直接读取项目文件：Claude 能看到你的整个代码库
直接写入修改：让 Claude 改代码，它真的会改文件
执行命令：可以运行测试、构建项目
理解上下文：Claude 知道你在做什么项目，不需要每次解释

安装

前提条件： Node.js 18+

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

安装完成后，在任意项目目录下运行：

claude

首次使用会引导你登录 Anthropic 账号或配置 API Key。

核心使用方式

直接对话

启动 Claude Code 后，直接输入你的需求：

> 帮我解释一下这个项目的整体架构

> 在 src/utils/ 目录下新建一个日期格式化工具函数

> 帮我找一下为什么测试用例跑不过

Claude Code 会自动读取相关文件，给出回答或直接修改代码。

常用斜杠命令

命令	功能
`/help`	查看帮助
`/clear`	清空当前对话
`/compact`	压缩对话历史，节省 token
`/cost`	查看当前会话消耗的费用
`/review`	对当前改动做代码审查
`/undo`	撤销上一次文件修改

单次执行模式

不想进入交互模式，直接一次性执行：

claude -p "帮我写一个 README.md"
claude -p "检查 src/ 目录下有没有未处理的 TODO"

实际工作流

工作流一：新功能开发

# 1. 进入项目目录
cd my-project

# 2. 启动 Claude Code
claude

# 3. 描述需求
> 我需要实现用户头像上传功能，要求：
  - 支持 JPG/PNG，最大 5MB
  - 上传到 AWS S3
  - 返回图片 URL
  - 参考项目现有的文件上传模块风格

# Claude 会读取现有代码，然后实现新功能

工作流二：Debug

> 运行 npm test，然后告诉我为什么 UserService 的测试失败了

Claude Code 会运行测试命令，读取错误信息，分析代码，给出修复方案，并可以直接修改文件。

工作流三：代码审查

> 请对我昨天的改动做一次 code review，
  重点检查：安全性、边界条件处理、代码风格是否和项目一致

工作流四：重构

> 把 utils/helpers.js 里超过 100 行的函数都拆分成更小的函数，
  保持功能不变，改完之后跑一下测试确认没有破坏

CLAUDE.md：项目上下文文件

在项目根目录创建 CLAUDE.md，Claude Code 每次启动都会读取这个文件，相当于给 Claude 的项目说明书：

# 项目说明

## 技术栈
- Node.js 20 + TypeScript
- PostgreSQL + Prisma ORM
- Express.js

## 代码规范
- 使用 ESLint + Prettier
- 函数命名用 camelCase
- 文件命名用 kebab-case
- 所有 API 接口要有 JSDoc 注释

## 测试
- 用 Jest，运行命令：npm test
- 新功能必须有单元测试

## 注意事项
- 不要直接修改 .env 文件
- 数据库迁移文件需要单独确认

有了这个文件，你不需要每次都向 Claude 解释项目情况。

费用说明

Claude Code 按 API 使用量计费，不是固定月费。

日常轻度使用（每天几十个请求）：约 $5-15/月

重度使用（全天开着）：可能 $30-80/月

省钱技巧：

用 /compact 命令定期压缩上下文
不需要时用 /clear 重置对话
用 --model claude-sonnet 指定更省钱的模型处理简单任务

和 IDE 插件的区别

维度	Claude Code（CLI）	Cursor/Copilot（IDE插件）
操作方式	命令行对话	编辑器内嵌
文件访问	读整个项目	当前文件为主
执行命令	可以直接跑命令	不可以
自动化能力	强	较弱
学习成本	稍高	低

两者不是非此即彼，很多开发者同时用 Cursor 写代码、用 Claude Code 做自动化任务。