# Claude Code 从入门到精通，一步到位 > **作者身份**：AI工具探索者（深度使用过Cursor、Copilot、Claude Code等主流AI编程工具） --- ## 一、场景：为什么你需要Claude Code 上周我的服务器突然崩了——不是代码bug，而是数据库连接池耗尽。凌晨2点，我盯着满屏的报错日志，脑子里只有一个念头：要是能有个AI助手帮我快速定位问题就好了。 这时候我想起了Claude Code。 说实话，一开始我对它不抱太大期望。毕竟之前用过太多AI编程工具，要么就是"智能补全"，要么就是"聊天机器人"，真正能**自主完成复杂任务**的很少。但Claude Code不一样——它是Anthropic推出的**终端原生AI编程代理**，不是简单的代码补全工具。 **一句话总结**：Claude Code能读你的整个代码库，理解上下文，然后自主执行多步骤任务，你只需要在关键节点说"同意"或"拒绝"。 --- ## 二、环境准备 ### 2.1 安装 ```bash # 全局安装（推荐） npm install -g @anthropic-ai/claude-code # 验证安装 claude --version ``` 如果提示 `command not found`，说明你的npm全局bin目录没在PATH里。检查一下： ```bash echo $PATH # 确保包含类似 ~/.npm-global/bin 或 ~/.nvm/versions/node/v*/bin 的路径 ``` ### 2.2 认证 运行 `claude` 命令后，它会弹出一个URL让你去浏览器登录： ``` 🔐 Authenticate with Anthropic Open this URL in your browser: https://claude.ai/authorize... ``` 登录后回到终端，你就完成了认证。 ### 2.3 项目配置（关键！） 在**项目根目录**创建 `CLAUDE.md` 文件： ```markdown # 项目技术栈 - 语言: Python 3.11 - 框架: FastAPI + SQLAlchemy - 数据库: PostgreSQL 15 - 测试: pytest # 编码规范 - 使用类型注解 - 函数名用 snake_case，类名用 PascalCase - 错误处理优先 try-except，不要裸 except - 日志用 logging 模块，不要用 print # 项目结构 src/ # 主代码 tests/ # 测试文件 config/ # 配置文件 ``` **这个文件非常重要**——Claude Code会把它作为"项目记忆"，每次对话都会参考。没有它，Claude Code就像个刚入职的实习生，啥都不懂。 ### 2.4 权限配置 在 `.claude/settings.json` 中配置权限： ```json { "allowed_tools": ["read", "edit", "execute", "bash"], "disallowed_tools": ["delete"], "auto_approve": ["format", "lint"] } ``` 这样Claude Code修改文件前会先问你，但格式化这种安全操作可以自动通过。 --- ## 三、实战：用Claude Code完成一个真实任务 ### 任务背景 我的FastAPI项目有个bug：用户注册时，如果邮箱已存在，系统会抛出500错误而不是友好的提示信息。我想让Claude Code帮我修复。 ### 3.1 启动Claude Code ```bash cd my-fastapi-project claude ``` 终端进入交互模式： ``` ╭────────────────────────────────────────────╮ │ Claude Code v1.2.3 │ │ Model: Claude Opus 4.6 │ │ Context: 1,000,000 tokens │ ╰────────────────────────────────────────────╯ ``` ### 3.2 描述问题 ``` 帮我修复用户注册时的邮箱重复问题。 现在如果邮箱已存在，会抛出500错误。 应该返回400状态码，并提示"该邮箱已被注册"。 ``` ### 3.3 观察Claude Code的思考过程 Claude Code不会直接改代码，它会先**规划**： ``` 🔍 分析中... 1. 找到用户注册的路由处理器 2. 定位邮箱检查的逻辑 3. 修改异常处理，返回400而不是500 4. 添加测试用例验证修复 预计修改 3 个文件。是否继续？ ``` **这里有个关键点**：Claude Code会展示它将要修改的文件列表，你有权拒绝。 ### 3.4 查看修改预览 ``` 📝 修改预览： src/api/routes/auth.py @@ -45,7 +45,10 @@ if await user_exists(email): - raise InternalServerError("Database error") + raise HTTPException( + status_code=400, + detail="该邮箱已被注册" + ) tests/test_auth.py @@ -12,3 +12,15 @@ +async def test_duplicate_email_returns_400(): + response = await client.post("/register", json={ + "email": "test@example.com", + "password": "password123" + }) + assert response.status_code == 400 + assert "该邮箱已被注册" in response.json()["detail"] ``` ### 3.5 确认并执行 输入 `y` 确认，Claude Code开始执行： ``` ✅ 已修改 src/api/routes/auth.py ✅ 已修改 tests/test_auth.py 🔧 正在运行测试... tests/test_auth.py::test_duplicate_email_returns_400 PASSED ``` **搞定**。整个过程不到3分钟。 --- ## 四、效果对比 | 指标 | 传统方式 | Claude Code | |------|---------|-------------| | 定位问题时间 | 15-30分钟 | 30秒 | | 编写修复代码 | 10分钟 | 自动完成 | | 编写测试用例 | 5-10分钟 | 自动生成 | | 运行验证 | 手动执行 | 自动运行 | | **总计** | **30-50分钟** | **2-3分钟** | 这不是夸张。上周我重构了一个模块的异常处理逻辑，涉及8个文件、23处修改。用Cursor的Agent模式，我花了40分钟来回确认每一步；用Claude Code，我花了5分钟——大部分时间在喝咖啡。 --- ## 五、常见问题FAQ ### Q1：Claude Code和Cursor有什么区别？ **简单说**： - **Cursor** 是IDE（VS Code的AI增强版），适合**边写代码边问AI** - **Claude Code** 是终端代理，适合**交给它一个任务让它自主完成** 举个例子： - 你想写一个新功能，边写边查文档 → 用Cursor - 你想"把这个模块从同步改成异步"，交给它去搞 → 用Claude Code **实测数据**：独立测试显示，Claude Code的代理方式比Cursor减少约30%的代码返工。一个在Cursor里需要15分钟来回确认的任务，Claude Code通常一次就能搞定。 ### Q2：Claude Code收费吗？ 有免费额度，但深度使用需要订阅： | 方案 | 价格 | 适用场景 | |------|------|---------| | 免费 | $0 | 每天少量使用 | | Pro | $20/月 | 个人开发者 | | Team | $40/人/月 | 团队协作 | **省钱技巧**：日常简单任务用 **Claude Sonnet 4.6**（快、便宜），复杂架构决策用 **Claude Opus 4.6**（强、贵）。比例大概是 80% Sonnet + 20% Opus。 ### Q3：Claude Code能处理大型项目吗？ 能。它支持 **100万token上下文**，这意味着它能一次性"记住"整个代码库。 但我有个经验：**项目太大时，CLAUDE.md 要写得更详细**。比如： ```markdown # 核心模块 - auth/: 用户认证，基于JWT - api/: REST API路由 - models/: SQLAlchemy模型 # 不要动的文件 - config/settings.py (生产环境配置) - scripts/deploy.sh (部署脚本) # 依赖关系 auth 依赖 models api 依赖 auth 和 models ``` ### Q4：Claude Code会乱改代码吗？ **会，但可控**。 它的权限系统让你在每个关键步骤都有否决权： - 修改文件前会问 - 执行命令前会问 - 删除文件时**一定会问**（不可跳过） 如果你担心，可以在 `.claude/settings.json` 里把 `disallowed_tools` 设得更严格： ```json { "disallowed_tools": ["delete", "execute"] } ``` 这样它只能读和改文件，不能执行shell命令。 ### Q5：为什么有时候Claude Code"变蠢了"？ **最常见原因**：CLAUDE.md 没写好。 Claude Code每次对话都会参考这个文件。如果文件里写的是"项目用Python"，但实际是Python+FastAPI+PostgreSQL+Redis，那它就像个只看了简历没看过项目的面试官。 **解决方案**：花10分钟把CLAUDE.md写详细。包括： - 技术栈（语言、框架、数据库） - 项目结构 - 编码规范 - 核心模块说明 - 不要动的文件列表 --- ## 六、进阶技巧 ### 6.1 Plan Mode（规划模式） 对于复杂任务，先用 `/plan` 让Claude Code规划步骤： ``` /plan 重构用户认证模块，从JWT改成OAuth2 ``` 它会输出详细的执行计划，你确认后再让它动手。 ### 6.2 多模型切换 ``` /model opus # 切换到Opus，处理复杂任务 /model sonnet # 切换回Sonnet，日常使用 ``` ### 6.3 Agent Teams（代理团队） Claude Code 1.2+ 支持**并行执行多个子任务**： ``` /agents 3 并行测试所有模块 ``` 它会启动3个子代理同时工作，最后汇总结果。 --- ## 七、总结 Claude Code不是银弹，但它确实改变了我的工作方式。以前需要花几小时调试的bug，现在交给它，我去喝杯咖啡就解决了。 **我的使用习惯**： - 日常编码：Cursor（IDE体验更好） - 复杂重构/调试：Claude Code（代理能力更强） - 两者配合：在Cursor里写代码，遇到难题用Claude Code解决 如果你还没试过，建议花10分钟安装一下。反正有免费额度，试试又不亏。 --- > 如果觉得有帮助，欢迎点赞收藏 ❤️ 更多AI工具实战教程，关注我第一时间获取～