AI开发工具实战：一、Claude Code 入门：从安装到第一个项目的完整指南

如果你还没用过 Claude Code，这篇文章就是写给你的。不讲理论，直接装好跑起来。

Claude Code 是什么

Anthropic 官方出的终端 AI 编程工具。不是 VS Code 插件，是直接在命令行里跑的——你说话，它写代码、跑测试、修 bug、提交 Git。

和 GitHub Copilot 的本质区别：Copilot 是"自动补全"，Claude Code 是"自动干活"。

安装（3 分钟）

npm install -g @anthropic-ai/claude-code
claude

首次运行会提示你登录 Anthropic 账号（需要 API Key 或订阅）。没有账号的话先去 console.anthropic.com 注册，新用户有免费额度。

国内用户注意：Anthropic API 需要科学上网。如果你在国内不方便，可以考虑用 DeepSeek 的 API 替代——功能类似，网络无障碍，详见我之前发的 DeepSeek API 避坑指南。

第一个项目：写一个 Markdown 转 PDF 的脚本

先在终端进到你的项目目录：

mkdir md2pdf && cd md2pdf
claude

进入 Claude Code 的对话界面后，直接说人话：

“帮我写一个 Python 脚本，读取当前目录下所有的 .md 文件，把它们转成 PDF。用 markdown 库和 weasyprint。要有进度条。”

Claude Code 会：

1. 分析你的需求
2. 检查当前目录有什么文件
3. 写代码
4. 自己跑一遍测试
5. 告诉你结果

全程你只需要看和点头——或者要求修改。

三个一定要知道的用法

1. 让它读项目再干活

不要一上来就让它写代码。先说：

“先读一遍这个项目的 README 和主要代码文件，告诉我你理解了这个项目是干什么的，然后等我确认再开始写代码。”

这一步能省掉 80% 的返工。Claude Code 内置了强大的代码阅读能力。

2. 让它自己跑测试

写完代码后说：

“你现在自己跑一遍测试，如果有失败的，先尝试修复，修复不了再告诉我。”

不需要你手动切出去跑 pytest。它会自己跑、自己修。

3. 让它写 commit message

“把你这次的改动总结成一条 git commit message，用英文，遵循 conventional commits 规范。”

给完命令后它会生成标准的 commit 文案，你确认无误后它会帮你提交。

常见坑

1. 它有时候会改太多文件

Claude Code 默认会尝试"全面解决问题"，有时候改得比你预想的范围大。防坑方法：开头加一句"只改 src/ 目录下的文件，不要碰其他目录"。

2. 长对话上下文内存爆炸

和 Claude Code 聊了 30 轮之后，它会"忘掉"你最早的要求。防坑方法：每次完成一个独立任务后，输入 /clear 清空上下文再开始下一个。

3. 它可能会用过时的 API

Claude Code 的训练数据有时滞。如果它用了一个过时的库版本或 API，直接指出：“这个 API 在 v3 里改了，去查最新的文档再写。”

---

Claude Code 是目前我用过的所有 AI 编码工具里最接近"干活"的一个。下一篇我会讲 Superpowers——一套把 Claude Code 从"好用"推到"开挂"的工作流方法论。先关注，别走丢。

（环境：Node.js 18+ / Python 3.10+ / macOS 或 Linux 或 WSL）