企业官网建设流程全解析

1. 面试官问 CLAUDE.md，我为什么当场卡壳

“你说你用 Claude Code 写代码，那你平时怎么维护 CLAUDE.md？”

这个问题我第一次被问到时，脑子里只有一句话：CLAUDE.md 是啥？我平时不就是打开终端，敲claude，然后跟它聊天让它改代码吗？哪来的什么配置文件？

后来我才明白，面试官问的不是“你会不会用 AI 写代码”，而是“你有没有把 AI 编程当成一件需要工程化管理的事”。CLAUDE.md 就是 Claude Code 的项目级记忆文件，它决定了 AI 每次进入你的项目时，能不能第一时间知道这个项目该怎么跑、代码该怎么写、哪些地方不能碰。

如果你只是把 Claude Code 当成一个更聪明的补全工具，那确实不需要 CLAUDE.md。但只要你开始用它改真实项目、跑真实测试、提交真实 PR，你就会发现：每次开新会话都要重复交代“用 pnpm 不要用 npm”“改完跑单测”“别动数据库 schema”，这件事本身就说明你的项目规则没有被沉淀下来。

CLAUDE.md 能做什么？简单说，它是写给 Claude Code 看的项目工作说明书。适合谁？适合所有用 Claude Code 参与真实项目开发的人，尤其是团队协作、monorepo、有严格验证流程的项目。这篇文章我会把 CLAUDE.md 的角色、可复制的配置骨架、settings.json 示例，以及本地验证它是否被正确读取的完整步骤都拆开讲，让你下次被问到时不至于像我一样当场懵。

2. 先把 TaoToken 的接入准备好

在讲 CLAUDE.md 之前，得先确保你的 Claude Code 能正常跑起来。我平时用的是 TaoToken 提供的接入方式，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api 。它的作用是让你在 Claude Code 里通过一个稳定的 API 入口调用模型，不用自己折腾底层网络配置。

你需要先去控制台创建一个 API Key。打开 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，登录后进入 API Keys 页面，点新建，复制那串以sk-开头的密钥。这个 Key 只显示一次，丢了就得重新建，所以先存到安全的地方。

如果你还没决定用哪个模型，可以先去模型对话页面试试手感：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。对于长期写代码、跑 Agent 任务的场景，Coding Plan 会更划算，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，遇到配置问题先翻这里。

拿到 Key 之后，Claude Code 的环境变量配置大概是这样：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="sk-你的密钥"

Windows 用户可以在 PowerShell 里用$env:ANTHROPIC_BASE_URL="https://taotoken.net/api"这种方式设置，或者直接写进系统环境变量。设置完之后，重新打开一个终端，敲claude能正常进入交互界面，就说明接入没问题了。

注意：API Key 不要写进 CLAUDE.md，也不要提交到 Git。CLAUDE.md 是给 AI 看的项目规则，不是放密钥的地方。

3. 一份能直接抄的 CLAUDE.md 骨架

CLAUDE.md 就是一个普通的 Markdown 文件，放在项目根目录，Claude Code 启动时会自动读取。它的核心原则是：短、准、硬。短是别写长篇大论，准是每条都和行动有关，硬是写成明确约束而不是温柔建议。

下面这份骨架你可以直接复制到项目根目录，然后按自己项目改：

# 项目工作说明 ## 项目概述 - 本项目是一个 XXX 应用，主要技术栈是 XXX。 - 主要代码在 `src/`，测试在 `tests/`。 - 优先遵循现有代码风格，不要引入新的架构风格。 ## 常用命令 - 安装依赖：`pnpm install` - 本地开发：`pnpm dev` - 单元测试：`pnpm test` - 构建检查：`pnpm build` ## 目录结构 - `src/components/`：通用组件 - `src/pages/`：页面入口 - `src/api/`：接口封装 - `src/hooks/`：可复用业务逻辑 - `tests/`：测试文件 ## 编码规范 - 新增 API 请求必须放在 `src/api/`。 - 页面组件不要直接调用 `fetch`。 - 公共逻辑被两个以上模块复用时，抽到 `src/hooks/`。 - 修改已有功能时，优先保持现有接口兼容。 ## 禁止事项 - 不要提交 `.env`、token、密钥。 - 不要升级核心依赖版本，除非用户明确要求。 - 不要修改数据库 schema，除非用户明确要求。 - 不要删除用户已有改动。 ## 验证要求 - 修改业务逻辑后，运行相关测试。 - 修改公共组件后，运行构建检查。 - 如果测试无法运行，在最终回复里说明原因。 ## 常见坑 - 本项目使用 pnpm，不要使用 npm 或 yarn。 - 修改配置文件后，需要重新启动开发服务器。 - 遇到鉴权问题，先检查 `src/api/auth.ts` 和 `src/store/auth.ts`。

这份骨架的价值在结构，不在内容。你真正要做的是把每一条改成自己项目里的真实规则。假的规范比没有规范更坑，因为 Claude Code 会很听话地按错误规则执行。

除了项目根目录的 CLAUDE.md，Claude Code 还支持用户级记忆，位置在~/.claude/CLAUDE.md。这里放你个人的跨项目偏好，比如“回答用中文”“改代码前先解释风险”“优先使用项目现有命令”。这些不属于某个项目，所以不要提交到仓库。

大项目建议拆分子目录 CLAUDE.md。比如：

repo/ CLAUDE.md apps/web/CLAUDE.md apps/admin/CLAUDE.md packages/ui/CLAUDE.md docs/CLAUDE.md

根文件写全局规则：包管理器、Git 流程、安全要求、全局禁止事项。模块文件写模块规则：本模块启动命令、测试命令、常见坑。这样 Claude Code 处理具体模块时，拿到的是更相关的上下文，而不是背着一堆无关规则跑。

4. settings.json 与本地验证 CLAUDE.md 是否被读取

光写好 CLAUDE.md 还不够，你得确认 Claude Code 真的读到了它。Claude Code 的配置文件通常在~/.claude/settings.json，你可以在这里做一些全局设置。一个基础的 settings.json 示例：

{ "permissions": { "allow": [ "Bash(pnpm install)", "Bash(pnpm dev)", "Bash(pnpm test)", "Bash(pnpm build)" ], "deny": [ "Bash(rm -rf *)", "Bash(git push --force)" ] }, "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api" } }

这个文件的作用是控制 Claude Code 能执行哪些命令、不能执行哪些命令，以及注入环境变量。allow列表里的命令不需要每次确认，deny列表里的命令直接禁止。这样既能减少重复确认，又能防止 AI 执行危险操作。

接下来是验证 CLAUDE.md 是否被正确读取。我试过几种方法，最直接的是在项目根目录启动 Claude Code，然后问它一个只有 CLAUDE.md 里才有的信息。比如你的 CLAUDE.md 里写了“本项目使用 pnpm，不要使用 npm”，你就问：

这个项目用什么包管理器？构建命令是什么？

如果它回答“pnpm”和“pnpm build”，说明 CLAUDE.md 被读到了。如果它回答“npm”或者说不确定，那就要检查文件位置和文件名。

另一个验证方法是让 Claude Code 复述项目规则：

请列出这个项目的禁止事项和验证要求。

它应该能准确说出你在 CLAUDE.md 里写的禁止事项，比如“不要修改数据库 schema”“不要提交 .env”。如果它漏了或者编造了，说明文件没被正确加载。

还有一个细节：Claude Code 会从当前工作目录往上查找 CLAUDE.md。如果你在子目录里启动，它会先读子目录的，再读父目录的。所以验证时要在项目根目录启动，或者确认你当前所在目录的层级关系。

如果发现 CLAUDE.md 没被读取，先检查这几个点：文件名是不是全大写CLAUDE.md；位置是不是在项目根目录或~/.claude/下；文件编码是不是 UTF-8；有没有语法错误导致 Markdown 解析异常。排障相关的更多细节可以看接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

5. 本篇常见错排查

第一个常见错：把 CLAUDE.md 写成了 README 的复制版。README 是给人看的，写项目愿景、功能说明、贡献指南。CLAUDE.md 是给 AI 看的，写行动约束、命令、禁止事项、验证流程。两者读者不同，内容重点也不同。你把 README 那套搬过来，Claude Code 抓不住重点。

第二个常见错：CLAUDE.md 越写越长，最后变成项目垃圾场。有人把完整接口文档、历史流水账、空泛口号全塞进去。结果就是重要规则被淹没，无关规则干扰当前任务。CLAUDE.md 会进入上下文窗口，它不是免费空间。一份 300 行的 CLAUDE.md，即使有缓存，模型每次也要在大量规则里找重点。建议根 CLAUDE.md 控制在几屏内，长文档用链接或 import 引用。

第三个常见错：过期规则没删。项目已经从 npm 换成 pnpm，CLAUDE.md 里还写着 npm。Claude Code 会很听话地继续用 npm，然后你就奇怪为什么它总是不按你说的来。CLAUDE.md 要随着项目演进更新，定期删掉过期命令、不存在的目录、重复规则、临时任务残留。

第四个常见错：把 API Key 写进 CLAUDE.md。这个文件可能会进 Git，可能会被团队共享。密钥应该放在环境变量或 settings.json 的 env 里，不要写在项目规则文档里。

第五个常见错：在子目录启动 Claude Code，却期望它读到根目录的 CLAUDE.md。虽然它会往上查找，但如果你在很深的子目录里，或者项目结构复杂，最好还是在根目录启动，或者确认子目录也有对应的 CLAUDE.md。

第六个常见错：CLAUDE.md 里写太软的规则。比如“尽量注意测试”“代码要符合项目风格”。这种话看着正确，但不能指导行动。改成“修改业务逻辑后，必须运行相关测试；如果无法运行，在最终回复说明原因”“新增 API 请求必须放在 src/api/，页面组件只能调用封装后的 API 方法”。越具体，越有用。

6. 把 CLAUDE.md 当成工程资产来维护

面试官问你怎么维护 CLAUDE.md，他真正想听的不是“我会写 Markdown”，而是“我理解 AI 编程需要工程化管理”。你可以这样回答：我不会只靠临时 prompt 管项目规则。对于跨任务稳定的信息，比如项目架构、常用命令、测试方式、代码风格、禁止改动范围，我会沉淀到 CLAUDE.md。这样 Claude Code 每次进入项目时都能读取这些规则，减少重复解释，也减少上下文压缩后丢约束的问题。

但我不会把 CLAUDE.md 写成大杂烩。因为它会进入上下文，太长会稀释注意力。所以我会按全局规则和模块规则拆分，根目录写通用约束，子目录写模块细节；临时任务放 prompt，个人偏好放用户级 memory，团队规则放项目级 CLAUDE.md。核心目标不是让模型看到更多，而是让它看到更稳定、更有行动价值的信息。

团队里维护 CLAUDE.md，建议把它当成工程资产。项目根 CLAUDE.md 进仓库，团队共享规则进 Git。个人偏好放用户级 memory，不要污染团队项目文件。规则变更要像代码一样审查，尤其是禁止事项、测试命令、架构规则。踩坑之后及时沉淀，比如“支付模块的金额单位是分，不是元”，这种一句话可能避免很多次错误。定期删，CLAUDE.md 不是只加不删。

如果你还没开始用 Claude Code，可以先从模型对话页面体验一下：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 。如果你已经准备长期用它写代码、跑 Agent 任务，Coding Plan 会更适合：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。接入过程中遇到配置问题，先去 API Keys 页面确认密钥状态：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，再对照接入文档排查：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。

CLAUDE.md 不是魔法，它不会让 Claude Code 瞬间变成懂你公司所有业务的老员工。但它能解决一个非常实际的问题：别让 AI 每次进项目都从零猜。项目怎么启动，代码怎么写，哪里不能动，改完怎么验，这些规则越早沉淀，Claude Code 越像一个靠谱队友。下次面试官再问，你就可以从文件位置、内容结构、验证方法、团队维护四个角度展开，而不是像我第一次那样当场懵。