INLOOK

Appearance

1 分钟快速上手：从配置到实战 ​

核心原则：Claude Code 不是自动编程机器人。 最专业的使用方式是：开发者负责拆解任务，Claude 负责执行具体步骤。

1. 环境安装 (Installation) ​

确保 Node.js >= 18.0。在终端执行全局安装：

bash
# 安装并登录
npm install -g @anthropic-ai/claude-code
claude login

2. 项目初始化 (Initialization) ​

这是很多新手忽略的环节，但它是 AI 理解代码库的基石。

进入项目根目录：

bash
cd your-project
claude /init

Claude 会扫描仓库并生成核心配置文件：CLAUDE.md。

为什么 CLAUDE.md 极其重要？ 该文件相当于 Agent 的“操作手册”。配置越清晰，Claude 修改代码的准确度就越高。建议包含：

  • 项目技术栈：例如 Java, Spring Boot, Maven。
  • 构建命令：如 mvn clean install。
  • 测试命令：如 mvn test。
  • 代码规范：如命名风格、异常处理准则。

3. 启动 Claude Agent ​

在项目目录输入 claude 进入 交互式 Agent 模式 (TUI)。你可以像面试官一样下达任务：

  • > 分析这个项目的模块结构。
  • > 登录逻辑在哪个模块？

4. Claude Code 的正确工作流 ​

新手误区：直接输入“为系统增加完整的支付模块”。这种模糊且宽泛的任务通常效果很差。

推荐流程：理解代码 → 制定计划 → 修改代码 → 运行测试

第一步：理解与定位 ​

先让 AI 梳理结构，确定受影响的模块。

> 分析订单逻辑在哪个模块？

第二步：制定修改计划 (使用 /plan) ​

使用 /plan 命令让 Claude 拆解任务：

> /plan 为订单模块增加 Redis 缓存

Claude 会输出类似步骤：

  1. 添加 Redis 依赖
  2. 创建 RedisConfig
  3. 修改 OrderService
  4. 添加缓存逻辑

第三步：执行与验证 ​

按照计划逐步要求 Claude 修改代码，并在完成后执行验证：

  1. 审核修改：Claude 展示代码 Diff，输入 y 确认，n 拒绝。
  2. 运行测试：强制要求执行 mvn test，确保修改未破坏现有逻辑。

5. 常用命令速查 ​

命令作用
claude启动 Agent 交互模式
claude /init初始化项目并生成规则文件
/plan拆解复杂任务，防止 AI 逻辑跑偏
Ctrl + C中断当前正在执行的任务

6. 新手常见错误 ​

  • ❌ 贪大求全：直接让 AI 完成整个模块或系统。
  • ❌ 忽略测试：修改完代码后不进行 mvn test 验证。
  • ❌ 配置缺失：不维护 CLAUDE.md，导致 AI 生成不符合规范的代码。

7. 解决卡点与分流 ​

下一站建议：如果您已跑通基础流程，请前往 实战自动化工作流 查看如何让 AI 自动处理复杂的并发 Bug。