Claude Code 使用指南：终端里的 AI 编程助手

Claude Code 是 Anthropic 推出的命令行 AI 编程工具，直接在终端中和 AI 协作写代码。

什么是 Claude Code？

Claude Code 运行在终端中，可以：

读取和理解你的代码库
直接编辑文件
执行 shell 命令
搜索代码
Git 操作

不同于 ChatGPT 需要复制粘贴代码，Claude Code 直接操作你的项目。

安装

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

基本使用

启动

cd your-project
claude

常用操作

# 让 AI 理解项目
> 帮我分析这个项目的结构

# 写代码
> 在 src/controllers 下创建一个用户管理的 Controller

# 修 bug
> 这个报错怎么解决：[粘贴错误]

# 代码审查
> 审查最近一次 git commit 的代码

# 重构
> 重构 src/service/OrderService.java，提取公共方法

实战示例

示例 1：快速创建 API

> 创建一个 Spring Boot 的 REST API，管理博客文章，
  包含 CRUD 接口，使用 JPA + MySQL，添加分页查询

Claude Code 会：

创建 Entity 类
创建 Repository
创建 Service
创建 Controller
更新配置文件

示例 2：写测试

> 为 UserService 写单元测试，覆盖所有方法，
  使用 JUnit 5 + Mockito

示例 3：排查问题

> 我的应用启动报错 "BeanCreationException"，
  帮我分析原因

示例 4：Git 操作

> 查看最近 5 次 commit 的改动
> 创建一个新分支 feature/user-auth
> 把当前改动 commit，写一个清晰的 commit message

高效使用技巧

1. 用 CLAUDE.md 配置项目

在项目根目录创建 CLAUDE.md：

# 项目规范
- 使用 Java 17 + Spring Boot 3.2
- 代码规范遵循 Google Java Style
- 所有 API 返回统一格式 Result<T>
- 单元测试覆盖率 > 80%

Claude Code 每次启动会读取这个文件，按规范写代码。

2. 善用 /help 查看命令

> /help          # 查看所有命令
> /clear         # 清除上下文
> /cost          # 查看 token 用量

3. 分步执行复杂任务

不要一次让 AI 做太多事，拆分成小步骤：

# 第一步
> 先创建数据库表的 Entity 类

# 第二步
> 基于 Entity 创建 Repository 接口

# 第三步
> 创建 Service 层，添加业务逻辑

4. 让 AI 解释代码

> 解释一下这个项目的认证流程是怎么工作的
> 这段代码为什么要用 CompletableFuture？

和其他工具对比

特性	Claude Code	Cursor	Copilot
运行环境	终端	编辑器	插件
代码库理解	✅ 全项目	✅ 全项目	部分
执行命令	✅	❌	❌
多文件编辑	✅	✅ Composer	❌
Git 集成	✅	❌	❌
学习成本	低	低	最低

注意事项

AI 会犯错：生成的代码一定要 review
保护敏感信息：不要把密钥、密码发给 AI
控制成本：大项目上下文很长，token 消耗快
备份代码：用 Git 管理，方便回滚

总结

Claude Code 最大的优势是直接在终端操作项目，不需要在编辑器和聊天窗口之间切换。对于后端开发者来说，这是目前最高效的 AI 编程方式。