Claude Code 从入门到精通，一步到位

小星AI
69 阅读3分钟

Claude Code 从入门到精通，一步到位

作者身份：AI工具探索者（深度使用过Cursor、Copilot、Claude Code等主流AI编程工具）

一、场景：为什么你需要Claude Code

上周我的服务器突然崩了——不是代码bug，而是数据库连接池耗尽。凌晨2点，我盯着满屏的报错日志，脑子里只有一个念头：要是能有个AI助手帮我快速定位问题就好了。

这时候我想起了Claude Code。

说实话，一开始我对它不抱太大期望。毕竟之前用过太多AI编程工具，要么就是"智能补全"，要么就是"聊天机器人"，真正能自主完成复杂任务的很少。但Claude Code不一样——它是Anthropic推出的终端原生AI编程代理，不是简单的代码补全工具。

一句话总结：Claude Code能读你的整个代码库，理解上下文，然后自主执行多步骤任务，你只需要在关键节点说"同意"或"拒绝"。

二、环境准备

2.1 安装

# 全局安装（推荐）
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

如果提示 command not found，说明你的npm全局bin目录没在PATH里。检查一下：

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 文件：

# 项目技术栈
- 语言: 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 中配置权限：

{
  "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

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 要写得更详细。比如：

# 核心模块
- 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 设得更严格：

{
  "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工具实战教程，关注我第一时间获取～

avatar
文章
阅读
粉丝