Claude Code 是什么？

目标：理解 Claude Code 的定位、能做什么、不能做什么
预计时间：10 分钟
对应官方文档：Overview

一句话定义

Claude Code 是一个 AI 编程助手，它能读懂你的整个代码库，帮你写代码、改代码、运行命令、排查错误——所有操作都在你的终端或 IDE 里完成。

它不是简单的"代码补全"，而是一个能自主执行多步骤任务的智能代理（Agent）。

它能做什么？

✅ 代码编辑

• 根据你的描述，自动修改多个文件
• 重构代码、重命名变量、提取函数
• 添加注释和文档

✅ 命令执行

• 运行测试、构建项目、安装依赖
• 执行 git 操作（提交、分支、查看 diff）
• 运行自定义脚本

✅ 代码理解

• 分析整个项目的结构和逻辑
• 解释复杂代码的工作原理
• 查找潜在的 bug 和安全问题

✅ 工具集成

• 连接 GitHub、Slack、Chrome 等外部工具
• 通过 MCP（Model Context Protocol）扩展能力
• 在 CI/CD 流程中自动运行

它不能做什么？

❌ 替代你的判断

AI 会犯错，尤其是复杂的业务逻辑。你需要审查所有更改。

❌ 访问外部网络（默认）

出于安全考虑，Claude Code 默认不能随意访问外部网站或 API（除非通过 MCP 配置）。

❌ 100% 准确

它可能会"幻觉"——自信地给出错误的代码。测试和验证是必须的。

支持的平台

需要什么条件？

1. Claude 订阅：Pro / Max / Team / Enterprise，或 Anthropic Console 账号
2. 代码项目：最好是 Git 管理的项目（方便撤销更改）
3. 终端基础：会基本的命令行操作（cd、ls、git 等）

核心概念速览

Claude Code 工作流

Agent Loop 流程

典型开发场景

实战场景对比

❌ 不用 Claude Code（传统方式）

# 1. 手动创建文件
vim models/user.py        # 20 分钟
vim routes/auth.py        # 30 分钟
vim tests/test_auth.py    # 25 分钟
 
# 2. 自己检查风格
black src/                # 发现格式问题
flake8 src/               # 发现 lint 问题
 
# 3. 来回修改
# ...反复调试
 
# 总计：约 90 分钟

✅ 使用 Claude Code

> 添加用户注册功能，包含模型、API 和测试
# Claude 自动生成所有文件
# 自动格式化
# 运行测试验证
# 总计：约 5-10 分钟

典型使用场景

场景 1：快速原型开发

> 创建一个 Todo List API，使用 FastAPI + SQLite

Claude 自动完成：

• 创建项目结构
• 编写模型、路由、CRUD
• 生成测试
• 创建 README

耗时：5 分钟 vs 传统 2 小时

场景 2：Bug 修复

> 测试报错了：
> TypeError: unsupported operand type(s) for +: 'int' and 'str'
> 
> 请定位并修复

Claude 自动完成：

• 读取错误堆栈
• 定位问题代码
• 分析类型不匹配原因
• 修复并运行测试验证

场景 3：代码审查

> 请审查 src/payment.py，关注安全漏洞

Claude 自动完成：

• 读取文件内容
• 检查 SQL 注入、XSS 等风险
• 检查敏感信息硬编码
• 输出审查报告

与类似工具对比

下一步

→ 02. 安装与首次登录