「从零玩转 AI Agent」【第十五篇】实战:AI 代码 Agent 入门(Claude Code 玩法)

本系列大部分文章都在教你"怎么做 Agent"。这篇反过来——带你玩一个现成的代码 Agent
，让你感受 Agent 目前最成熟的应用形态：AI 编程。
上一篇：「从零玩转 AI Agent」【第十四篇】实战项目：搭建你的"个人 AI 助理"

一、为什么先玩"代码 Agent"？

因为编程是 Agent 目前最擅长的领域：

代码是纯文本 → LLM 天然擅长
有明确的"对错" → 编译/测试能自动验证
反馈循环快 → 写代码 → 运行 → 报错 → 修复，一气呵成

你先玩一玩，感受完整的 Agent 体验，再回来看前面的文章会有更深的理解。

二、什么是 Claude Code？

Claude Code 是 Anthropic 推出的命令行 AI 编程 Agent。

它不只是"帮你写一行代码"——它会：

📖 自动读项目文件，理解项目结构
🔍 定位 Bug 在哪
✏️ 写代码修改
🧪 跑测试验证
📝 写 Git Commit Message
🚀 一键提交

一句话描述：你在终端里说需求，它自己写完、跑通、提交。

三、安装与配置

3.1 安装

# Mac / Linuxnpm install -g @anthropic-ai/claude-code# 或使用 Homebrewbrew install claude-code

3.2 配置 API Key

# Claude Code 支持接入 Anthropic API 或 DeepSeek# 如果想用 DeepSeek（更便宜），设置环境变量：export ANTHROPIC_API_KEY="sk-你的deepseek-key"export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"# 或用 Anthropic 官方 APIexport ANTHROPIC_API_KEY="sk-ant-你的anthropic-key"

3.3 启动

# 进入你的项目目录cd your-project# 启动 Claude Codeclaude

四、六大经典用法

用法 1：让它解释代码

你：  帮我解释一下 src/auth/login.py 这个文件在干什么，      把逻辑画成流程图。

Claude Code 会：

读文件
理解代码逻辑
输出文字解释 + ASCII 流程图

💡 看开源项目时，用这个比看文档还快。

用法 2：修 Bug

你：  app 在用户名为空时会 crash，帮我找一下 bug 在哪里并修复。

Claude Code 会：

搜索相关代码
定位问题（比如空值检查缺失）
修改代码
写测试验证修复

（Agent 自动执行）🔍 搜索 crash 日志相关代码…   找到：src/handlers/user_handler.py, line 47🐛 分析问题：   user_handler.py:47 处直接调用 user.name.upper()   如果 user.name 为 None，会抛出 AttributeError🔧 修复：   添加空值检查：   display_name = user.name.upper() if user.name else "匿名用户"🧪 测试：   test_user_none_name.py → ✓ 通过✅ 修复完成！

用法 3：加新功能

你：  给 todo app 加一个"按优先级排序"的功能。     优先级分高/中/低三级，默认排序列。

Claude Code 会：

找 Todo 相关的代码
理解现有数据模型
设计实现方案（加字段、改排序逻辑、更新 UI）
写代码
跑测试
返回结果

用法 4：重构

你：  src/services/ 下面的代码太乱了，帮我整理一下。     把重复逻辑抽出来，函数不要超过 50 行。

Claude Code 会：

扫描 services 目录
识别重复模式
提取公共函数
整理文件结构
确保所有测试仍然通过

用法 5：写测试

你：  给 src/utils/validator.py 补上单元测试，     覆盖所有边界情况。

Claude Code 会：

读 validator.py
分析每个函数的输入输出
生成测试用例（正常+边界+异常）
运行测试

用法 6：自动化工作流

你：  每次我改了代码后，自动做这些：     1. 跑 lint（代码风格检查）     2. 跑单元测试     3. 如果有失败，告诉我哪里错了并建议修复     4. 如果全通过，帮我生成 commit message

这就是一个完整的 CI Agent。

五、Claude Code 背后的 Agent 原理

回头用我们系列学到的知识拆一拆 Claude Code：

Agent 组件	Claude Code 中的实现
🧠 LLM	Claude 4 Opus / Sonnet（或 DeepSeek）
🦾 Tools	读文件、写文件、执行 bash 命令、搜索代码
📝 Memory	当前对话上下文（短时记忆）+ 项目结构理解
🗺️ Planning	自动规划：分析任务 → 定位文件 → 修改 → 验证
🔄 ReAct	思考→行动→观察→再思考，完整循环

它跟我们在第 8、9 篇手写的 Agent 在架构上完全一致，只是工具更强（能直接操作文件系统）。

六、常见使用技巧

6.1 写好需求

❌ 差：  "修一下那个 bug"✅ 好：  "用户登录时如果密码包含特殊字符 #@! 就会报 500 错误，         帮我在 auth_service.py 里定位并修复"

越具体，结果越精准。

6.2 分步骤引导

你：  先帮我看看有哪些文件跟用户认证相关。      [Agent 列出文件]你：  好，重点看 auth_service.py，分析一下逻辑。      [Agent 分析]你：  这个函数里如果 token 过期了会怎么处理？安全吗？      [Agent 深入分析]

不要一次给太模糊的大任务，分步沟通效果更好。

6.3 让它写 commit message

你：  git diff 出来看看改了啥，帮我写一个规范的 commit message。

6.4 让它 review 代码

你：  看看这次的改动，有没有安全问题或者性能坑？

七、Claude Code vs GitHub Copilot vs Cursor

	Claude Code	GitHub Copilot	Cursor
形态	命令行/TUI	IDE 插件	AI 原生 IDE
交互方式	对话式，你说它做	补全式，自动建议	对话 + 补全
自主程度	★★★★★ 能自主完成多步骤任务	★★☆ 主要是补全	★★★★ 能完成中等任务
适合任务	大型重构、修 Bug、架构调整	日常编码加速	综合开发
价格	API 按量付费	$10/月	$20/月

八、入门三步走

今天
装好 Claude Code，随便找个项目，让它解释代码
明天
让它帮你修一个真实的 Bug 或加一个小功能
后天
尝试"一句话需求"——只描述要什么，让它自己拆任务、自己写、自己测

做完这三步，你会真正理解"Agent 能干到什么程度"。

九、下篇预告

最后一篇！《AI Agent 的未来以及你该怎么跟上》——MCP 协议、Agentic Workflow、具身智能，以及给零基础读者的学习路线图。

关注本号，不错过最终章。

下一篇：《趋势与展望：AI Agent 的未来以及你该怎么跟上》

上一篇：「从零玩转 AI Agent」【第十四篇】实战项目：搭建你的"个人 AI 助理"

本系列大部分文章都在教你"怎么做 Agent"。这篇反过来——带你玩一个现成的代码 Agent，让你感受 Agent 目前最成熟的应用形态：AI 编程。上一篇：「从零玩转 AI Agent」【第十四篇】实战项目：搭建你的"个人 AI 助理"

一、为什么先玩"代码 Agent"？

二、什么是 Claude Code？

三、安装与配置

3.1 安装

3.2 配置 API Key

3.3 启动

四、六大经典用法

用法 1：让它解释代码

用法 2：修 Bug

用法 3：加新功能

用法 4：重构

用法 5：写测试

用法 6：自动化工作流

五、Claude Code 背后的 Agent 原理

六、常见使用技巧

6.1 写好需求

6.2 分步骤引导

6.3 让它写 commit message

6.4 让它 review 代码

七、Claude Code vs GitHub Copilot vs Cursor

八、入门三步走

九、下篇预告

本系列大部分文章都在教你"怎么做 Agent"。这篇反过来——带你玩一个现成的代码 Agent
，让你感受 Agent 目前最成熟的应用形态：AI 编程。
上一篇：「从零玩转 AI Agent」【第十四篇】实战项目：搭建你的"个人 AI 助理"