旋大爷的博客

AI编程04：Claude Code/CLI工具

从命令行Agent、仓库级修改、长任务上下文保持到批量代码生成，理解如何使用CLI工具提升开发效率。

字数 1088 阅读时长 ≈ 4 分钟 2026-7-17 2026-7-27
#AI #AI编程
AI编程04：Claude Code/CLI工具

Claude Code 和 CLI 工具为开发者提供了在命令行环境中使用 AI 的能力。它们支持仓库级代码理解、批量修改、长任务执行和自动化工作流。

CLI 工具的核心优势

仓库级代码理解

CLI 工具可以理解整个代码仓库的结构和逻辑：

能力说明示例
目录分析分析项目目录结构了解模块划分
文件索引索引所有源代码文件快速定位文件
依赖分析分析代码依赖关系理解模块间关系
架构理解理解项目整体架构把握系统设计

仓库分析示例：

$ claude analyze

分析结果：
项目名称：电商平台
技术栈：Java 21 + Spring Boot 3.2 + MySQL + Redis

模块划分：
- controller/ - REST API 控制层
- service/ - 业务逻辑层
- repository/ - 数据访问层
- entity/ - 数据库实体
- dto/ - 数据传输对象
- config/ - 配置类

核心依赖：
- Spring Boot Starter Web
- Spring Boot Starter Data JPA
- Spring Boot Starter Security
- Redis Spring Boot Starter

批量代码修改

CLI 工具可以一次性修改多个文件：

修改类型示例效果
全局替换将所有文件中的某个方法名替换批量重命名
格式统一统一所有文件的代码格式代码规范
依赖更新更新所有文件中的依赖版本版本升级
模式修改修改特定模式的代码架构调整

批量修改示例：

$ claude rewrite --pattern "findById" --replacement "getById" --files "*.java"

修改结果：
已修改 15 个文件，替换了 23 处 findById 为 getById

长任务上下文保持

CLI 工具可以在长时间任务中保持上下文：

场景说明示例
多步骤任务执行多个相关步骤创建完整功能
迭代开发逐步完善代码迭代优化
调试修复多次尝试修复排除问题
知识积累逐步建立知识库项目知识

长任务示例：

$ claude chat

Claude: 你好！我可以帮你完成什么任务？

用户：帮我实现一个用户注册功能

Claude: 好的，请提供项目结构和现有代码

用户：[提供项目结构]

Claude: 这是实现方案...

用户：实现注册接口

Claude: [生成 Controller 代码]

用户：实现业务逻辑

Claude: [生成 Service 代码]

用户：实现数据访问

Claude: [生成 Repository 代码]

用户：生成单元测试

Claude: [生成测试代码]

用户：运行测试

Claude: [执行测试命令并报告结果]

自动化工作流

CLI 工具可以与其他工具集成，实现自动化工作流：

集成方式说明示例
Shell 脚本在脚本中调用 CLI 工具自动化任务
CI/CD在 CI/CD 流程中使用自动代码审查
Git Hooks在 Git 钩子中使用提交前检查
自定义工具集成到自定义工具链工作流增强

自动化脚本示例：

#!/bin/bash

# 代码审查脚本
echo "=== 代码审查 ==="
claude review --files "*.java" --output "review-report.md"

# 生成测试脚本
echo "=== 生成测试 ==="
claude test --files "*.java"

# 运行测试
echo "=== 运行测试 ==="
mvn test

# 生成文档
echo "=== 生成文档 ==="
claude doc --files "*.java" --output "api-docs.md"

Claude Code 的核心功能

命令行聊天

命令行聊天提供交互式对话：

$ claude chat

Claude: 你好！我可以帮你完成什么任务？

用户：解释这段代码
[粘贴代码]

Claude: 这段代码的功能是...

文件编辑

文件编辑允许直接修改文件内容：

$ claude edit UserService.java

Claude: 请告诉我你想如何修改这个文件？

用户：添加一个根据邮箱查询用户的方法

Claude: 已添加方法 findByEmail(String email)

代码审查

代码审查分析代码质量：

$ claude review OrderService.java

审查结果：
1. 性能问题：
   - 方法 getOrders() 没有分页，可能导致内存溢出
   - 建议添加 Pageable 参数

2. 安全问题：
   - 方法 deleteOrder() 没有权限检查
   - 建议添加 @PreAuthorize 注解

3. 代码质量：
   - 缺少单元测试
   - 建议添加测试用例

文档生成

文档生成自动创建项目文档：

$ claude doc --module auth

生成文档：
# 用户认证模块文档

## 模块概述
负责用户注册、登录、认证等功能

## API 接口
- POST /api/auth/register - 用户注册
- POST /api/auth/login - 用户登录
- GET /api/auth/me - 获取当前用户

## 核心类
- AuthController - 认证控制器
- AuthService - 认证服务
- JwtUtil - JWT 工具类

## 数据模型
- User - 用户实体
- RegisterRequest - 注册请求
- LoginRequest - 登录请求

CLI 工具的使用技巧

如何提供上下文

技巧说明示例
指定文件使用 --files 参数指定文件claude review --files "*.java"
提供代码直接粘贴代码在聊天中粘贴代码片段
设置角色设置 AI 的角色claude chat --role "资深架构师"
提供约束指定技术约束claude rewrite --constraint "Java 8"

如何优化输出

技巧说明示例
定义格式指定输出格式claude doc --format markdown
设置长度控制输出长度claude chat --max-tokens 2000
要求简洁要求简洁回答”请简洁回答”
要求详细要求详细回答”请详细解释”

如何批量处理

技巧说明示例
使用通配符使用通配符匹配文件*.java
使用目录指定目录处理src/main/java
使用列表使用文件列表--files file1.java file2.java
使用管道使用管道传递输入find . -name "*.java" | claude review

CLI 工具的常见问题

问题1：上下文丢失

表现：AI 忘记了之前的对话内容

解决方案：

  • 使用 --session 参数保持会话
  • 在提问时重复关键信息
  • 使用文件传递上下文

问题2：输出太长

表现：AI 输出的内容太多，难以阅读

解决方案：

  • 使用 --max-tokens 限制长度
  • 要求简洁回答
  • 使用分步提问

问题3：无法访问文件

表现：AI 无法读取指定的文件

解决方案：

  • 检查文件路径是否正确
  • 检查文件权限
  • 使用绝对路径

问题4：生成的代码不符合规范

表现：AI 生成的代码不符合项目规范

解决方案：

  • 提供代码规范文档
  • 设置代码风格约束
  • 使用项目现有的代码作为示例

CLI 工具的最佳实践

代码审查流程

1. 使用 claude review 分析代码
2. 查看审查报告
3. 根据建议修改代码
4. 重新审查验证
5. 提交代码

文档生成流程

1. 使用 claude doc 生成初始文档
2. 人工审查和补充
3. 更新文档
4. 定期维护文档

自动化工作流

1. 在 Git Hook 中添加代码审查
2. 在 CI/CD 中添加测试生成
3. 在发布流程中添加文档更新
4. 定期运行自动化任务

项目判断清单

  • 需要理解项目结构 → 使用 claude analyze
  • 需要修改多个文件 → 使用 claude rewrite
  • 需要长任务支持 → 使用 claude chat
  • 需要代码审查 → 使用 claude review
  • 需要生成文档 → 使用 claude doc
  • 需要自动化 → 编写 Shell 脚本集成
  • 上下文丢失 → 使用会话保持或文件传递
  • 输出不符合规范 → 提供代码规范和示例