Claude Code 从入门到实战：让 AI 真正帮你改代码、跑测试、开 PR

你打开 Claude Code 后，最不该做的一件事，是直接丢一句：

帮我优化一下这个项目。

这句话听起来省事，实际很容易把 AI 推进一片雾里。它不知道你要优化速度、代码结构、页面体验、测试覆盖，还是部署流程。最后很可能改了一堆你没让它改的东西，留下一个很难审的 diff。

Claude Code 真正适合的用法，是把它当成一个能读仓库、能改文件、能跑命令的开发助手。你给它清楚任务、项目规则、权限边界和验收标准，它就能把很多原本拖着不想做的小闭环跑完。

这点对独立开发者和内容站运营者尤其重要。

很多时候卡住你的不是“不会写一个惊天动地的大功能”，而是发布脚本有个小 bug、文档缺一段说明、页面移动端有个样式问题、测试命令老是忘跑。

这些小事不酷，但它们决定一个项目能不能长期活下去。

截至 2026 年 6 月 4 日，Anthropic 官方把 Claude Code 定位为 agentic coding tool：它可以读取代码库、编辑文件、运行命令，并和终端、IDE、桌面 app、浏览器等开发环境配合使用。

这篇不写 Claude Code 有多神。

我们只讲一件事：新手怎么把它用进真实项目，少踩坑，多交付。

如果你还没看过前两篇专题，可以先看：

• https://mayizhu.top/codex-vs-claude-code-vs-cursor-devin/
• https://mayizhu.top/openai-codex-guide-cloud-cli-code-review/

一句话结论

Claude Code 最适合这类任务：边界清楚、能验证、能审查。

任务	适不适合 Claude Code	原因
解释一个陌生项目	适合	它能读目录和文件，帮你快速找入口
修一个明确报错	适合	可以结合日志、代码和测试定位问题
给已有逻辑补测试	很适合	验证标准清楚，结果容易审查
重构一个小模块	适合	前提是要求保持行为不变并跑测试
一句话做完整 SaaS	不适合	需求太大，验收不清，风险太高
自动部署生产环境	谨慎	必须人工确认，不能让 AI 自己拍板

新手最稳的顺序是：

• 先让 Claude Code 只读项目。
• 再让它写计划。
• 然后批准一个小改动。
• 最后让它跑测试、总结 diff 和风险。

不要一上来就把权限拉满。AI 干活很快，翻车也很快。

Claude Code 和普通聊天机器人有什么区别

普通聊天机器人更像顾问。你贴一段代码，它回答你这段代码哪里可能有问题。

Claude Code 更像在你的项目里工作的助手。它可以：

• 读取项目文件和目录。
• 搜索相关代码。
• 编辑一个或多个文件。
• 运行测试、构建、脚本或命令。
• 根据项目里的 CLAUDE.md 读取长期规则。
• 帮你整理提交说明或 PR 描述。

这也是为什么 Claude Code 特别适合“项目级任务”，而不是单段代码问答。

比如你维护一个 WordPress 内容站，发布脚本偶尔有问题。普通聊天式 AI 只能看你粘贴的脚本片段；Claude Code 可以先读 scripts/、docs/operations-runbook.md、README.md，再判断问题可能出在哪里。

你可以这样问：

先不要改代码。
请阅读 scripts 目录和 docs/operations-runbook.md，说明这个项目发布一篇新文章会经过哪些步骤。
重点找出：哪些步骤会改线上 WordPress，哪些步骤只是本地检查。

这个提示词的重点是“先不要改代码”。先让它理解项目，再决定是否动手。

第一步：安装和启动

Claude Code 官方提供了多种安装方式。Windows 用户可以用 PowerShell 安装：

irm https://claude.ai/install.ps1 | iex

也可以用 npm 安装：

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

如果你用 WinGet，也可以按官方文档使用：

winget install Anthropic.ClaudeCode

安装后，在项目根目录启动：

claude

第一次用时，不要急着让它改代码。先问一个只读问题：

请阅读当前项目，给我一个高层概览：
- 主要目录分别做什么？
- 发布、测试、构建或验证命令在哪里？
- 哪些文件看起来是长期项目规则？
先不要修改任何文件。

如果它能说清项目结构，再进入下一步。如果它读错了目录、误解了目标，先纠正，不要让它带着错误理解继续改。

第二步：写好 CLAUDE.md

Claude Code 的一个关键入口是 CLAUDE.md。

官方文档说明，项目级 CLAUDE.md 可以放在项目根目录，或放在 ./.claude/CLAUDE.md。它适合写项目规则、构建命令、测试命令、代码风格、架构约定和常见工作流。

如果你的仓库已经有 AGENTS.md，注意一点：Claude Code 默认读的是 CLAUDE.md，不是 AGENTS.md。更稳的做法是在 CLAUDE.md 里引用已有规则：

@AGENTS.md

## Claude Code

- 修改代码前先读 README.md 和 docs/operations-runbook.md。
- 涉及线上发布、删除、推送、付款、账号授权时，必须先暂停确认。
- 完成代码改动后运行与改动范围匹配的验证。
- 不要输出、保存或记录 token、cookie、nonce、私钥。

一个好的 CLAUDE.md 不需要长。它要回答四个问题：

问题	写什么
项目是什么	一句话说明业务和主要目标
怎么跑	常用安装、测试、构建、验证命令
怎么改	风格、目录边界、不要动的区域
怎么算完成	必须跑哪些检查，哪些风险要说明

不要把 CLAUDE.md 写成愿望清单。越具体越好。

第三步：先用 plan mode，不要直接开改

Claude Code 有多种权限模式。对新手最重要的是两个：

• plan：先探索、分析、写计划，不直接改文件。
• default：读文件不需要太多打断，但编辑文件、运行命令等动作会要求确认。

官方文档里也强调，plan mode 适合在修改前先分析。你可以在启动时用：

claude --permission-mode plan

也可以在会话里用 /plan。

我建议新手把复杂任务都先写成计划模式：

/plan
目标：修复发布脚本在搜索推送失败时记录不清楚的问题。

请先阅读：
- scripts/new-article-workflow.ps1
- docs/operations-runbook.md
- docs/reference/push-history.txt

约束：
- 不要推送搜索引擎。
- 不要读取或输出任何 token。
- 不要修改线上 WordPress。
- 只提出最小改动方案。

完成标准：
- 说明现有问题。
- 给出要改的文件和理由。
- 说明需要运行的验证命令。

等它给出计划后，你再决定是否执行。这个小动作能挡掉很多“AI 自作主张”。

第四步：给它一个可验证的小任务

Claude Code 最吃“可验证结果”。

不要这样说：

把代码质量提升一下。

可以这样说：

目标：
让 new-article-workflow.ps1 在缺少 BAIDU_PUSH_TOKEN 时，把推送历史写成
“Baidu skipped: missing BAIDU_PUSH_TOKEN”，不要写成已推送。

范围：
只允许修改 scripts/new-article-workflow.ps1。

约束：
不要真正推送百度，不要读取或打印 token。

验证：
运行脚本的 CheckOnly 模式，确认不会写推送历史。
再说明如果正式运行且缺 token，预期会写入什么记录。

这里有四个好东西：

• 目标清楚。
• 文件范围清楚。
• 安全边界清楚。
• 验证方式清楚。

Claude Code 不怕你啰嗦，怕你含糊。

第五步：让它跑测试，而不是只说“改好了”

很多人用 AI 写代码最大的问题，不是 AI 不会写，而是人太早相信它。

Claude Code 官方最佳实践里有一个很实用的观点：给 Claude 一个能验证工作的方式，比如测试、构建、截图或可比较的输出。

如果项目有测试，直接告诉它：

改完后运行与本次变更相关的测试。
如果测试失败，不要继续扩大修改范围，先解释失败原因和最小修复方案。

如果项目没有测试，也要给最小验证：

这个项目没有完整测试。请至少做三件事：
- 运行 PowerShell 语法检查或最小命令验证。
- 用一个不会改线上状态的参数跑一次脚本。
- 检查 git diff，确认只改了任务相关文件。

对前端页面，可以让它跑：

请启动本地开发服务，打开页面，检查桌面和移动端是否有文本重叠、按钮溢出或空白区域。
完成后给出截图路径和发现的问题。

对 WordPress 内容站，可以让它跑：

发布后检查：
- URL 是否 200。
- title 和 H1 是否匹配。
- meta description 是否存在。
- robots 是否是 index, follow。
- sitemap 是否包含新 URL。
如果 sitemap 没包含，不要假装成功，把它列为待办。

AI 写完不是结束，验证通过才接近结束。

第六步：让它准备 PR，而不是替你合并

Claude Code 可以帮你整理 PR。官方常见工作流里也提到，你可以让 Claude 总结改动、创建 PR，并继续优化 PR 描述。

但这里要分清：让 AI 准备 PR 可以，让 AI 替你合并生产代码不行。

一个稳一点的 PR 提示词：

请根据当前 git diff 生成 PR 描述。

结构：
- Summary：用 2-3 条说明改了什么。
- Verification：列出实际运行过的命令和结果。
- Risk：说明还有什么风险或未验证项。

不要提交，不要 push，不要创建 PR。只输出草稿。

如果你确实想让它创建 PR，也建议加上：

可以使用 gh pr create 创建草稿 PR。
不要合并 PR。
不要 force push。
创建前先给我看标题和正文。

这不是不信任 Claude Code，而是正常工程流程。能自动生成，不代表可以自动上线。

权限怎么选：新手别急着 auto

Claude Code 的权限模式很多，最容易被误用的是自动模式和绕过权限。

你可以先按这个表选：

场景	推荐模式
第一次读项目	plan 或默认模式
修一个小 bug	默认模式
你会认真看 diff，想少点打断	acceptEdits
长任务、低风险、方向很清楚	auto，但仍要审查
CI 或脚本中只允许固定工具	dontAsk
隔离容器或虚拟机里的实验	bypassPermissions

最重要的一条：不要在真实项目里随手开 bypassPermissions。官方文档也把它定位在隔离环境里使用。它会跳过权限检查，适合容器、VM 或没有生产风险的实验环境，不适合你日常维护网站、客户项目或公司仓库。

如果你要给 Claude Code 更高权限，至少先写清楚边界：

可以编辑当前工作区内的文件。
不要删除文件。
不要 push。
不要部署。
不要访问生产数据库。
不要输出任何凭据。

这类边界不是废话。边界越清楚，AI 越不容易“热心过头”。

CLAUDE.md 实战模板

下面是一份适合个人项目或内容站的 CLAUDE.md 模板：

# Project Instructions

## Project

This is a WordPress content operations workspace for an AI tools review site.

## Commands

- Check SEO setup: `.\scripts\seo-check.ps1`
- Publish Markdown draft: `node .\scripts\publish-markdown-post.js .\content\drafts\file.md`
- New article workflow: `.\scripts\new-article-workflow.ps1 -Url "https://example.com/post/"`

## Safety

- Do not print or save tokens, cookies, nonces, passwords, or private keys.
- Do not push search engines unless the required API token is present.
- Do not modify live WordPress UI without backup, cache purge, and public-page verification.
- Ask before deleting files, force-pushing, deploying, changing payments, or touching production data.

## Workflow

- Read README.md and docs/operations-runbook.md before changing scripts.
- Keep changes minimal and scoped to the task.
- After code changes, run the smallest relevant verification.
- If verification cannot be run, say why and list the risk.

这份模板的重点不是英文，而是具体。Claude Code 不需要听你说“请写高质量代码”。它需要知道这个项目怎么跑、什么不能碰、什么算完成。

常见翻车点

1. 让它一次做太多

“重构整个项目”“优化全部 SEO”“把网站做得更好”都太大。

拆成：

• 找出问题。
• 给出计划。
• 只改一个脚本。
• 跑一个验证。
• 总结风险。

2. 没有给验收标准

AI 会倾向于把“看起来完成”当成完成。

你要写清楚：

• 哪个命令要通过。
• 哪个页面要 200。
• 哪个字段必须存在。
• 哪个文件不能被改。

3. 没审查 diff

Claude Code 改得越快，你越要看 diff。

至少检查：

• 是否改了无关文件。
• 是否引入明文密钥或敏感输出。
• 是否绕过错误而不是真修问题。
• 是否删除了用户已有内容。
• 是否缺少验证。

4. 把 AI 当最终负责人

Claude Code 可以帮你找问题、改代码、跑测试、写 PR 描述。最终要不要合并、发布、部署，还是你负责。

尤其是客户项目、付费系统、生产数据库、搜索平台、账号授权，必须人工确认。

一个完整工作流示例

假设你要让 Claude Code 修一个发布后流程的小 bug，可以这样走：

/plan
请先阅读 scripts/new-article-workflow.ps1 和 docs/operations-runbook.md。
目标：确认百度推送缺 token 时，脚本是否会把历史记录误写为已推送。
不要修改文件。给出分析和最小修复计划。

确认计划没问题后：

按计划修改。
范围只限 scripts/new-article-workflow.ps1。
不要读取或输出 token。
完成后运行 CheckOnly 模式验证，并总结 git diff。

改完后再让它做一次自查：

请审查刚才的 diff。
重点看：
- 是否会误记录推送状态。
- 是否改变了原有推送流程。
- 是否有泄露 token 的风险。
- 是否运行了足够的验证。

最后生成 PR 描述：

请根据当前 diff 写 PR 描述，包含 Summary、Verification、Risk。
不要提交，不要 push。

这套流程不花哨，但够稳。真正的效率不是让 AI 乱跑，而是让它按清楚的轨道跑。

内容站运营者怎么用 Claude Code

如果你不是全职开发者，而是内容站、独立站或副业项目运营者，Claude Code 仍然有价值。

你可以先把它用在这些事情上：

• 检查文章发布脚本。
• 扫描草稿 frontmatter 是否完整。
• 生成发布后检查清单。
• 修复 sitemap、robots、meta description 检查脚本。
• 整理运营 runbook。
• 给重复流程写 PowerShell 或 Node 小工具。
• 审查 UI 注入脚本是否影响移动端。

不要上来就让它“帮我做一个爆款网站”。先让它帮你把每天重复的小坑填平。

这些小坑包括：发布后忘记查 URL，sitemap 没更新却以为成功，百度推送失败却误记为已推送，文章 title 和 H1 不一致，旧多语言页面重复收录。

这些问题都不酷，但都真实影响网站运营。

结论：Claude Code 好用，但要给它轨道

Claude Code 的价值，不是让你完全不用懂项目，而是让你更快把项目里的小任务做完。

新手记住五条就够了：

• 先读项目，再改代码。
• 先写计划，再批准执行。
• 先给范围，再给权限。
• 先跑验证，再说完成。
• 先看 diff，再提交或发布。

如果你只把 Claude Code 当成“更会写代码的聊天框”，它会让你失望。

如果你把它当成一个需要项目规则、验收标准和代码审查的开发助手，它会很快变成你工作流里最省心的一环。

我越来越觉得，AI 编程代理最适合解决的不是“从零替你造一个世界”。

而是帮你把真实项目里那些脏活、碎活、重复活，一点点清掉。

项目真正变好，往往就是这么发生的。

下一篇我会继续写 AI 编程代理专题，聊一个更接近副业的问题：不会编程的人，能不能用 AI Agent 做一个能上线的小工具。

参考资料

本文基于 2026 年 6 月 4 日核验的 Anthropic 官方资料整理。Claude Code 的安装方式、权限模式、Web/桌面/IDE 能力和模型支持可能继续变化，实际使用前以官方文档为准。

• Claude Code Overview: https://code.claude.com/docs/en/overview
• Claude Code Getting Started: https://code.claude.com/docs/en/getting-started
• Claude Code Best Practices: https://code.claude.com/docs/en/best-practices
• Claude Code Memory / CLAUDE.md: https://code.claude.com/docs/en/memory
• Claude Code Permission Modes: https://code.claude.com/docs/en/permission-modes
• Claude Code Common Workflows: https://code.claude.com/docs/en/common-workflows
• Claude Code MCP: https://code.claude.com/docs/en/mcp