企业官网建设流程全解析

1. 为什么面试官听到“没写过 CLAUDE.MD”就不说话了

先说结论：CLAUDE.MD 是 Claude Code 在项目根目录自动读取的一份“项目约定说明书”，它决定了每次新会话里 Claude 是否还记得你的技术栈、构建命令、代码规范和禁区。你没写它，Claude 每次开局都是失忆状态，你得手动把项目背景再讲一遍。面试官那句“你每次开新会话都要重新解释一遍吗”，问的就是这个。

我见过太多人用 Claude Code 的姿势是这样的：打开终端，cd 到项目，直接开聊，“帮我看看这个接口为什么报 500”。Claude 读几个文件，猜一下框架，改两行，跑一下，可能对了也可能错了。单次任务没问题，但一旦项目变复杂、多人协作、批量改造，这种“裸聊”方式就会暴露三个硬伤：上下文被无关文件塞满、危险命令没人拦、改完没人验证。

CLAUDE.MD 解决的是第一层——让 Claude 不失忆。再往上还有 Plan Mode 让它先规划再动手、子代理把脏活分出去、Hook 兜底安全、验证闭环让“它说能跑”变成“测试真的过了”。这篇就按这个顺序，给你一份可以直接复制到项目里的 CLAUDE.MD 骨架，再演示怎么在 Claude Code 里加载并验证它真的生效，最后说清楚怎么用 TaoToken 统一 Key 和 API 通道，避免每个工具配一遍密钥。

适合谁看：已经在用 Claude Code 但每次都要重复交代项目背景的人；准备面试被问到工程化协作的人；想把 Claude Code 从“聪明补全”升级成“团队协作工具”的人。

2. TaoToken 前置：先把 Key 和 API 通道统一

在写 CLAUDE.MD 之前，得先保证 Claude Code 能稳定连上模型。Claude Code 默认走 Anthropic 官方通道，但很多人在国内环境、多工具切换、团队共用 Key 的场景下会遇到配置分散的问题。TaoToken 的作用是把 Key 和 API 通道统一管理，Claude Code、Coding Plan、模型对话都走同一个入口，换工具不用重新配一遍。

官网入口在这里：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api ，注意 API 地址不带 UTM 参数，配置的时候别拼错。

具体操作分三步。第一步，进控制台创建 API Key，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，创建完把 Key 复制出来，后面配置环境变量要用。第二步，如果你要长期跑编码任务或者 Agent，建议看一下 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，它比按量计费更适合高频调用。第三步，把 Key 写进环境变量，Claude Code 启动时会自动读取。

# 写入 shell 配置，以 zsh 为例 echo 'export ANTHROPIC_BASE_URL="https://taotoken.net/api"' >> ~/.zshrc echo 'export ANTHROPIC_API_KEY="你的_TaoToken_Key"' >> ~/.zshrc source ~/.zshrc # 验证环境变量是否生效 echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_API_KEY | head -c 8

这里有个坑要注意：ANTHROPIC_BASE_URL 末尾不要带斜杠，带了斜杠有些版本会拼出双斜杠导致 404。另外 Key 不要直接写进 CLAUDE.MD，那个文件是要提交到 git 的，Key 写进去等于泄露。Key 只放环境变量或者本地 .env，CLAUDE.MD 里只写“Key 从环境变量读取”这类约定。

如果你还想在浏览器里直接验证模型是否通，可以用模型对话入口：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，发一句“你好”看有没有正常返回，能返回说明 Key 和通道都没问题，再去配 Claude Code 就少一层排查。

3. 可复制配置：CLAUDE.MD 骨架 + 子代理 + Hook

现在进入正题。CLAUDE.MD 放在项目根目录，Claude Code 每次会话开始自动读取。结构上把最重要的规则放最前面，因为 Claude 对开头内容关注度更高。下面这份骨架你可以直接复制，按自己项目改。

# 项目约定 ## 技术栈 - 语言：TypeScript 5.x + Node 20 - 框架：Fastify + Prisma - 测试：Vitest，覆盖率阈值 80% - 包管理：pnpm，禁止用 npm install ## 构建与测试命令 - 安装依赖：pnpm install - 本地启动：pnpm dev - 跑测试：pnpm test - 类型检查：pnpm typecheck - 提交前必须跑：pnpm lint && pnpm test ## 代码规范 - 禁止 any，用 unknown + 类型守卫 - 所有导出函数必须有 JSDoc - 错误统一用 AppError 类，禁止裸 throw new Error - 数据库查询必须走 Prisma，禁止拼 SQL 字符串 ## 禁区 - 不要改 prisma/migrations 下的历史迁移文件 - 不要动 .env 和任何密钥文件 - 不要执行 rm -rf、git push --force、DROP TABLE ## Plan Mode 约定 - 改动涉及 3 个以上文件时，先进入 Plan Mode 出方案 - 方案里必须列出：改哪些文件、为什么改、怎么验证 - 我确认方案后再切 acceptEdits 执行 ## 子代理分工 - security-reviewer：只读权限，审查认证和权限相关改动 - fast-search：Haiku 模型，负责代码库检索，只回结论 - test-writer：负责补测试，禁止改业务逻辑 ## 验证要求 - 每次改完必须跑 pnpm test，把失败输出贴出来 - 禁止说“应该没问题了”，必须给测试或构建结果

这份骨架里有几个设计点值得展开。第一，命令入口写全，Claude 不用猜你用的是 pnpm 还是 npm，直接照抄命令。第二，禁区单独成段，配合后面的 Hook 形成双保险。第三，Plan Mode 约定写清楚触发条件，避免它该规划的时候直接动手。第四，子代理分工写进 CLAUDE.MD，Claude 在需要调研时会优先考虑派子代理而不是自己读一堆文件。

子代理本身要单独建文件，放在 .claude/agents/ 目录下。比如 security-reviewer 的配置：

--- name: security-reviewer description: 审查认证、权限、密钥相关改动 tools: Read, Grep, Glob model: claude-opus-4 --- 你是安全审查代理。只读，不写文件。 检查项： 1. 是否有硬编码密钥 2. 权限校验是否可绕过 3. 输入是否做了边界检查 输出格式：问题列表 + 严重级别 + 修复建议

fast-search 的配置把 model 换成 Haiku，tools 只留 Read 和 Grep，description 写“快速检索代码库，只回结论不回过程”。这样主对话的上下文不会被大量文件读取塞满。

Hook 配置放在 .claude/settings.json 里，用来强制拦截危险命令。CLAUDE.MD 里的禁区只是“请求”，Hook 才是“强制保证”。

{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "echo \"$TOOL_INPUT\" | grep -qE 'rm -rf|git push --force|DROP TABLE' && exit 2 || exit 0" } ] } ] } }

exit 2 表示拦截，Claude 会收到拒绝信号并停止执行该命令。这样即使 CLAUDE.MD 被忽略，危险命令也过不去。

4. 验证请求：确认 CLAUDE.MD 真的生效

写完文件不算完，得验证 Claude Code 真的读到了。最直接的方式是开一个新会话，问它一个只有读了 CLAUDE.MD 才知道的问题。

# 在项目根目录启动 Claude Code cd your-project claude # 会话里输入 > 我们这个项目用什么包管理？跑测试的命令是什么？

如果它回答“pnpm，跑测试用 pnpm test”，说明 CLAUDE.MD 被读到了。如果它回答“我不确定，你能告诉我吗”，说明文件没被识别，检查文件名是不是 CLAUDE.MD（大写），位置是不是在项目根目录。

再验证 Plan Mode。按 Shift+Tab 循环切换模式，切到 plan 模式后输入一个多文件改动需求：

> 帮我把用户模块的错误处理统一改成 AppError

在 plan 模式下，Claude 只会用只读工具调研，输出一份计划，不会直接改文件。计划里应该列出涉及哪些文件、每个文件改什么、怎么验证。你 review 完确认没问题，再切到 acceptEdits 模式让它执行。如果它直接开始改文件，说明 Plan Mode 没生效，检查是不是按错了键或者版本太旧。

验证子代理是否可用，输入：

> 用 security-reviewer 审查一下 src/auth 目录

正常情况它会派子代理去跑，主对话只收到结论。如果它自己开始读文件，说明子代理配置没被识别，检查 .claude/agents/ 目录名和文件 frontmatter 格式。

验证 Hook 是否拦截，输入一个危险命令：

> 帮我执行 rm -rf node_modules 然后重装

如果 Hook 生效，Claude 会收到拦截信号，告诉你这个命令被拒绝了。如果它真的执行了，检查 settings.json 的路径和 JSON 格式，JSON 里多一个逗号都会导致整个配置失效。

验证验证闭环，输入：

> 修复 src/utils/date.ts 里的时区 bug，改完跑测试把结果贴出来

重点看它有没有真的跑 pnpm test 并把输出贴出来。如果它只说“已修复，应该没问题”，说明 CLAUDE.MD 里的验证要求没被遵守，回去检查那一段是不是写得太靠后，往前挪。

5. 本篇常见错排查

第一个高频错误：CLAUDE.MD 写成了 CLAUDE.md 或者 claude.md。Claude Code 只认全大写的 CLAUDE.MD，大小写错了等于没写。在 macOS 上文件系统默认不区分大小写，你可能本地看着没问题，但提交到 Linux CI 就失效了。用ls -la | grep CLAUDE确认一下。

第二个错误：文件放在子目录而不是根目录。Claude Code 只读项目根目录的 CLAUDE.MD，放在 src/ 下面不生效。如果你有多个子项目，每个子项目根目录各放一份，或者用 monorepo 的根目录放一份总的。

第三个错误：内容太长太杂。有人把项目背景、规范、待办、会议记录全堆进去，结果 Claude 抓不住重点。精简方法是对每一条规则问自己：如果没有这条，Claude 真的会犯错吗？不会就删掉。规则控制在 50 行以内，最重要的放最前面。

第四个错误：Key 写进了 CLAUDE.MD。这个文件要提交 git，Key 写进去等于公开。Key 只放环境变量，CLAUDE.MD 里写“Key 从 ANTHROPIC_API_KEY 读取”就行。如果不小心提交了，立刻去控制台吊销重发，地址是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

第五个错误：Hook 的 JSON 格式错误。settings.json 里多一个逗号、少一个引号，整个 hooks 配置就静默失效，Claude 不会报错，但拦截也不生效。用cat .claude/settings.json | python -m json.tool验证 JSON 合法性。

第六个错误：Plan Mode 下 Claude 还是改了文件。检查是不是在 plan 模式下按了确认键，或者版本太旧不支持。用claude --version看版本，低于 1.0 的建议升级。

第七个错误：子代理不生效。检查 .claude/agents/ 目录名是不是复数，文件 frontmatter 的 name 和 description 是不是都有，tools 字段是不是合法工具名。frontmatter 格式错了整个文件会被忽略。

第八个错误：环境变量没生效。配完 .zshrc 要 source 或者重开终端，用echo $ANTHROPIC_BASE_URL确认。如果输出为空，说明没写进去。另外注意 base url 末尾不要带斜杠。

6. 把 CLAUDE.MD 当成工程化协作的起点

回到面试那个场景。面试官问的不是“你会不会用 Claude Code”，而是“你有没有把它当成一个可以被工程化管理的协作对象”。CLAUDE.MD 是这件事的起点，它让 Claude 不失忆；Plan Mode 让它三思而后行；子代理让主线程不被杂事拖垮；Hook 兜底安全；验证闭环让“看起来对”变成“真的对”。这几层叠起来，才是把 Claude Code 当团队工具用。

如果你还没配 Key，先去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 创建一个，然后按第 2 节的环境变量配好。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，遇到配置问题先翻文档。长期跑编码任务或者 Agent 的话，Coding Plan 入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，比按量计费省心。Claude Code 相关的接入细节可以看 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

最后给你一个实操建议：今天就在你正在做的项目根目录跑一次/init，让 Claude 生成初版 CLAUDE.MD，然后按第 3 节的骨架精简一遍，把命令、禁区、Plan Mode 约定、子代理分工、验证要求这五段补上。跑一个新会话验证它真的读到了，再故意触发一次 Hook 看拦截是否生效。这一套走完，下次面试官再问“你每次开新会话都要重新解释一遍吗”，你可以直接把 CLAUDE.MD 甩给他看。