11-Claude Code 从安装到生产力 —— 一个项目实战走完全流程

Claude Code 从安装到生产力 —— 一个项目实战走完全流程前面 10 篇文章你已经把 Skills、MCP、Plugins 的原理和配置都学完了。这篇回到工具本身——把 Claude Code 装好用学到的所有能力从零做一个真实项目。这是从知道到做到的关键一步。安装与认证macOS / Linux# 方式一npm推荐更新方便npminstall-ganthropic-ai/claude-code# 方式二Homebrewbrewinstallclaude-code# 方式三直接下载二进制# 从 https://github.com/anthropics/claude-code/releases 下载认证# 启动 Claude Code首次会自动弹出认证流程claude# 或手动设置 API KeyexportANTHROPIC_API_KEYsk-ant-xxx# 也支持第三方 API兼容 OpenAI 接口格式exportANTHROPIC_BASE_URLhttps://api.deepseek.com验证安装claude--version# → Claude Code v2.x.xclaude--help基础配置速览安装完 Claude Code 后做三件事1. 初始化项目 CLAUDE.md# 在项目根目录创建touchCLAUDE.md内容见第 3 篇。最小可用版本# 项目名 ## 技术栈 Python 3.12 / FastAPI / SQLAlchemy / PostgreSQL ## 代码规范 - 所有 Python 代码用 Black 格式化 - 函数不超过 40 行 - 公开函数必须有 docstring ## 安全红线 - 禁止硬编码密钥 - SQL 查询必须参数化2. 安装必备 MCP Server# 创建用户级 MCP 配置touch~/.claude/mcp.json配置内容见第 7 篇。最小版本GitHub Filesystem 两个。3. 调整权限设置# Claude Code 权限配置在 ~/.claude/settings.json# 默认是 ask 模式——每次操作都会问你# 对可信项目可以放宽{permissions:{allow:[Bash(npm test),Bash(npm run dev),Bash(git status),Bash(git diff)]}}原则读操作可以放宽写操作保持 ask。危险操作rm -rf、git push --force、DROP TABLE永远不自动允许。核心概念速览前 10 篇已经详细拆解过的概念这里做一张速查表概念一句话配置位置详见CLAUDE.md告诉 AI 什么能做、什么不能做项目根目录第 3 篇Skills把重复提示词变成可复用工作流.claude/skills/第 4-6 篇MCP给 AI 装上访问外部系统的手脚.mcp.json第 7-8 篇PluginsSkills MCP Hooks 的一键安装包Marketplace第 9-10 篇Hooks在关键节点自动执行脚本.claude/settings.json第 12-13 篇Memory跨会话持久化关键信息.claude/memory/第 15 篇Permissions控制 AI 能自动做什么、必须问你什么.claude/settings.json本文常用命令与快捷键对话中操作方式提交当前输入Enter换行Shift Enter中断 AI 输出Ctrl C清屏Ctrl L退出 Claude Code/exit或Ctrl D切换模式fast/normal/fast切换模型/model会话管理命令作用/resume恢复上次会话/compact手动压缩上下文清理过期信息/clear开始新会话信息查看命令作用/status查看当前会话状态Token 用量、加载的 Skill 等/permissions查看和修改权限设置/memory查看 Memory 内容/doctor诊断 Claude Code 是否有配置问题配置管理命令作用/config打开配置面板/add-dir添加工作目录让 AI 看到更多文件/init初始化项目的 CLAUDE.md完整项目实战从零搭建一个 Task Manager Web 应用以下是一个完整流程覆盖从需求到上线的全过程。看我是怎么和 Claude Code 协作的。Phase 1初始化项目 我: 帮我创建一个 FastAPI React 的 Task Manager 项目。 后端用 Python 3.12 FastAPI SQLAlchemy SQLite。 前端用 React 18 TypeScript Tailwind CSS。 先搭项目骨架不要写业务逻辑。 Claude Code: 1. 读 CLAUDE.md → 了解技术栈要求 2. 创建项目结构 backend/ ├── main.py ├── models.py ├── database.py └── requirements.txt frontend/ ├── src/ │ ├── App.tsx │ └── components/ ├── package.json └── tailwind.config.js 3. pip install -r requirements.txt 4. npm install 5. 骨架搭好了。运行 npm run dev 和 uvicorn main:app 可以启动。Phase 2做第一个功能 我: /review 先审查一下骨架代码没问题的话开始做第一个功能 任务列表页展示所有任务支持按状态筛选。 Claude Code: [自动加载 code-review Skill] 1. 审查骨架代码没有安全问题 2. 后端创建 GET /tasks?statustodo 接口 → 参数化查询符合 CLAUDE.md 安全要求 3. 前端创建 TaskList 组件 状态筛选器 → 用 Tailwind 深色主题卡片布局 4. npm run dev → 验证效果 5. 任务列表页完成了这是截图。你看看样式满意吗Phase 3遇到 BugAI 自己修 我: 筛选功能有问题——选了 进行中 之后切换回 全部列表没更新。 Claude Code: 1. 读 TaskList.tsx → 定位问题 2. 发现useEffect 的依赖数组少了 statusFilter 3. 修复 → 重新运行 → 验证通过 4. 是 React 的 useEffect 缺少依赖导致的。已修复。不需要手动 debug——描述问题AI 自己定位、修复、验证。Phase 4加更多功能 我: 接下来三个功能一个一个做 1. 任务详情页点击任务卡片跳转到详情 2. 新建任务表单 后端 POST 接口 3. 删除任务确认弹窗 后端 DELETE 接口 做好一个我确认了再做下一个。 Claude Code: [依次完成 3 个功能每个功能做完等你确认] - 每步做完后自动运行、验证 - 相关代码修改后自动 run testPhase 5部署 我: /deploy Claude Code: [加载 deploy Skill] 1. 检查环境变量是否完整 2. 运行测试套件 → 全部通过 3. 用 GitHub MCP 创建 Release v0.1.0 4. 前端构建 → 部署到 Vercel 5. 后端构建 Docker 镜像 → 推送 6. 部署完成。前端https://task-manager.vercel.app 后端 APIhttps://api.task-manager.com整个过程你做了什么你做的事 ├── 描述需求5 轮对话 ├── 确认 AI 的产出每轮看一眼 └── 做决策用 Tailwind、一个一个做 AI 做的事 ├── 写所有代码 ├── 装依赖、配环境 ├── 读文件、定位 Bug、修复 ├── 跑测试、运行验证 └── 创建 PR、部署你写的代码行数0。你做的决策大约 10 个。工作流优化技巧技巧一一步一个功能❌ 帮我做一个完整的电商系统包括用户系统、商品管理、购物车、支付、订单管理 → AI 一次生成 50 个文件 → 每个文件都有小问题 → 你根本不知道该从哪看起 → 改了一个问题引出三个新问题 ✅ 先做商品列表页展示 10 个示例商品 → 好现在加搜索功能 → 好现在加商品详情页 → 每次只改 2-3 个文件 → 每次改动你都能理解 → 出问题也知道是哪个改动引起的技巧二用 AI 生成 To-do再逐项执行 我: 帮我分析一下要实现用户认证系统需要做哪些事 拆成小的独立步骤每个步骤用一个 PR 能完成的范围。 AI: 拆成 7 个步骤 1. User model 数据库迁移 2. 注册接口POST /register 3. 登录接口POST /login返回 JWT 4. JWT 验证中间件 5. 前端登录页面 6. 前端注册页面 7. 前后端联调 集成测试 我: 好做第 1 步。 [AI 完成第 1 步] 我: 第 1 步没问题。做第 2 步。 ...这个流程和 Spec Driven Development第 21 篇的原理一致。技巧三善用 CLAUDE.md 的禁忌区在真正开始让 AI 写业务代码前确保 CLAUDE.md 里有这些 ## 绝对不能做的事 - 不要把密钥硬编码到源码中 - 不要跳过 pre-commit hooks - 不要修改已经跑通的测试 - 不要自动合并 PR必须人工确认 - 不要在生产数据库上执行任何写操作 这些规则在 AI 生成代码时会自动生效。很多坑提前堵住了。技巧四遇到复杂问题时切 CodexClaude Code 的默认模式是直接动手。遇到特别复杂的任务时可以先让 Codex 生成一个执行计划再回到 Claude Code 执行。 我Codex CLI: /plan 重构整个认证系统从 session 迁移到 JWT refresh token Codex: [生成详细执行计划8 个步骤预估影响 15 个文件] 我回到 Claude Code: 按这个计划执行从第 1 步开始 // 附上 Codex 的计划Claude Code 会话中的隐性知识使用 Claude Code 几周后你会积累一些不会写在文档里但很有用的经验1. Let me read that file → AI 在收集上下文别打断 → 如果它连续读了很多不相关的文件提醒它聚焦 2. AI 写代码时突然停下来 → 可能遇到了冲突或不确定的事 → 主动问卡在哪里了 3. AI 给出的方案你觉得不对 → 直接说不对我要的是 X → 不要绕弯子AI 不会受伤直接指正效率最高 4. AI 生成了一大段代码你看不懂 → 直接问解释一下这段代码在干什么 → AI 是最好的代码讲解员 5. 上下文快满了/status 显示 80% → /compact 压缩上下文或 /clear 开始新会话 → 不要让 AI 在满载的上下文里做重要决策5 分钟自检你的 Claude Code 合格了吗□ CLAUDE.md 写好了吗至少包含技术栈 安全红线 □ GitHub MCP 装好了吗至少这一个 □ 至少装了 1 个 Skill 吗推荐从 code-review 开始 □ 权限设置检查过了吗危险命令不要设 allow □ 尝试过从头做一个完整的小项目吗 □ 遇到过 Bug 并让 AI 自己修好了吗如果全部打勾你已经是一个合格的 Claude Code 用户了。延伸阅读Claude Code 官方文档