企业官网建设流程全解析

1. 从一次团队协作翻车说起：CLAUDE.md 与权限模式到底解决什么问题

团队里三个人用 Claude Code 写同一个仓库，第一周就出了状况。A 同事让 Claude 生成接口代码，缩进用了 4 空格，B 同事的版本是 2 空格，C 同事提交时发现测试命令跑不起来——因为 Claude 每次都在猜这个项目该用pnpm test还是npm run test:unit。更麻烦的是，有人让 Claude 直接改了package.json的 scripts，没人注意到，CI 挂了两天才定位到。

这些问题的根子不在模型能力，而在于每个会话都是全新的上下文窗口。Claude Code 不会自动记得你上周纠正过它什么，也不会天然知道你们团队的编码规范。它需要两样东西：一份持久化的项目说明书，和一套可控的操作边界。

这就是 CLAUDE.md、权限模式、会话管理三大特性存在的意义。CLAUDE.md 是写给 Claude 看的项目 README，每次会话启动时自动加载；权限模式决定 Claude 在动手改文件、跑命令前要不要先问你；会话管理则让你能恢复、命名、分支对话，把一次性的问答变成可追溯的工程资产。

适合谁看：已经把 Claude Code 当日常编码工具、但还没把它接进团队工作流的开发者。如果你只是偶尔问几个问题，这些配置意义不大；但如果你希望 Claude 稳定地按团队规范产出代码，下面这套东西值得花半小时配好。

我试过在三个不同规模的项目里落地这套配置，小到单人脚本仓库，大到十几人的 monorepo，踩过的坑基本都集中在「指令写得太模糊」和「权限放得太开」这两件事上。下面按可复制的顺序拆开讲。

2. 接入前的统一通道准备：TaoToken 的 Key 与 Base URL 配置

在配置 CLAUDE.md 之前，得先让 Claude Code 能稳定连上模型服务。团队场景下最怕的是每个人各自申请 Key、各自配环境变量，出了问题没法统一排查。用统一通道的好处是：Key 集中管理，Base URL 一致，模型 ID 固定，新人入职五分钟就能跑起来。

TaoToken 提供的就是这样一个统一入口。官网地址是 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_content=console&utm_campaign=rewrite ，登录后在 API Keys 页面生成一个新 Key。建议按项目或按人命名，比如team-frontend-prod，方便后续审计。生成后立刻复制保存，页面刷新后就看不到了。

第二步，配置环境变量。Claude Code 读取的是ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY这两个变量。在 macOS/Linux 下写入~/.zshrc或~/.bashrc：

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

Windows 用户用 PowerShell 设置用户级环境变量：

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://taotoken.net/api", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-你的Key", "User")

第三步，确认模型 ID。团队里统一用一个模型 ID，避免有人用 opus 有人用 sonnet 导致输出风格不一致。可以在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 查看当前可用的模型列表，把选定的 ID 记下来，后面写进配置。

这里有个容易忽略的点：环境变量配好后，必须重开终端才生效。很多人配完直接在当前窗口跑claude，发现还是报 401，就是因为旧 shell 没加载新变量。验证方法：

echo $ANTHROPIC_BASE_URL # 应输出 https://taotoken.net/api

如果输出为空，说明变量没写进去或者没重开终端。这一步过了，再往下配 CLAUDE.md 才有意义。

3. 可复制的 CLAUDE.md 模板与权限模式配置片段

CLAUDE.md 的加载优先级从低到高是：托管策略 > 用户指令 > 项目指令 > 本地指令。团队协作主要用项目指令./CLAUDE.md，个人偏好放~/.claude/CLAUDE.md，本地私有配置放./CLAUDE.local.md并加进.gitignore。

先给一份可以直接抄的项目级模板，放在仓库根目录的CLAUDE.md：

# 项目说明 ## 技术栈 - 前端：React 18 + TypeScript 5 + Vite - 后端：Node.js 20 + Fastify - 包管理：pnpm（禁止使用 npm 或 yarn） - 测试：Vitest + Playwright ## 构建与测试命令 - 安装依赖：`pnpm install` - 本地开发：`pnpm dev` - 单元测试：`pnpm test` - 提交前必须运行：`pnpm lint && pnpm test` ## 编码规范 - 缩进使用 2 空格，禁止 Tab - 组件文件使用 PascalCase，工具函数使用 camelCase - API 处理程序统一放在 `src/api/handlers/` - 所有导出函数必须有 JSDoc 注释 ## 架构决策 - 状态管理用 Zustand，不用 Redux - 网络请求统一走 `src/lib/request.ts` 封装 - 禁止在组件内直接调用 fetch ## 常见工作流 - 新增接口：先在 `src/api/handlers/` 建文件，再在 `src/api/routes.ts` 注册 - 修改数据库 schema：必须同步更新 `migrations/` 下的迁移文件

这份模板控制在 50 行以内，符合「每个 CLAUDE.md 目标 200 行以下」的建议。指令要具体到可验证，比如「缩进使用 2 空格」比「正确格式化代码」强得多，因为前者 Claude 能明确判断对错。

如果项目大，用.claude/rules/拆分子规则。比如testing.md只放测试相关，api-design.md只放接口规范。这些文件会被递归发现，且支持按路径范围加载——只有 Claude 处理匹配文件时才加载对应规则，省上下文。

权限模式的配置走 settings 文件。项目级配置放在.claude/settings.json：

{ "permissions": { "allow": [ "Bash(pnpm test:*)", "Bash(pnpm lint:*)", "Read(src/**)", "Edit(src/**)" ], "deny": [ "Bash(rm -rf:*)", "Edit(package.json)", "Edit(.env*)" ] }, "autoMemoryEnabled": true }

这段配置的含义：允许 Claude 自动跑测试和 lint、读写src/下的文件；禁止执行rm -rf、禁止改package.json和任何.env文件。autoMemoryEnabled控制自动记忆开关，默认开启，这里显式写出来方便团队统一。

权限模式本身有几种档位，用Shift+Tab在会话里循环切换。default 模式下每个操作都要确认，适合刚接入时观察 Claude 的行为；auto 模式下符合 allow 规则的操作自动放行，日常编码丝滑很多。团队建议先用 default 跑一周，把高频操作加进 allow 列表，再切 auto。

注意一点：无论哪种模式（除了 bypassPermissions），对受保护路径的写入永远不会自动批准。这是防止 Claude 误改仓库状态和自身配置的兜底机制，别想着绕过它。

4. 验证请求与自动记忆效果：从 /memory 到实际产出

配置写完，得验证三件事：CLAUDE.md 有没有被加载、权限规则有没有生效、自动记忆有没有在工作。

先验证 CLAUDE.md 加载。在项目根目录启动 Claude Code，输入/memory。这个命令会列出当前会话加载的所有 CLAUDE.md、CLAUDE.local.md 和规则文件。如果列表里没有你的项目 CLAUDE.md，说明文件位置不对或者没被识别。常见原因是文件放在了子目录但启动目录不对——Claude Code 从当前工作目录向上遍历目录树，你在foo/bar/启动，它会读foo/bar/CLAUDE.md、foo/CLAUDE.md以及沿途的CLAUDE.local.md。

验证权限规则。让 Claude 执行一个被 deny 的操作，比如「帮我改一下 package.json 的 version」。如果配置生效，Claude 会提示这个操作被权限规则阻止，而不是直接改。反过来，让它跑pnpm test，在 auto 模式下应该直接执行不弹确认。

验证自动记忆。自动记忆默认开启，Claude 在工作时会自己保存笔记到~/.claude/projects/<项目路径>/memory/。你可以主动触发一次：在会话里说「记住这个项目用 pnpm，不要用 npm」。然后运行/memory，选择自动记忆文件夹，应该能看到 Claude 保存的笔记。下次新开会话时，这条记忆会自动加载。

自动记忆的加载规则是：MEMORY.md的前 200 行或前 25KB（先到者为准）在每次对话开始时加载。超过阈值的内容不会在会话启动时加载，Claude 会把详细笔记移到单独的主题文件里保持主文件简洁。

验证模型通道是否正常，可以用一个最小请求测试。在会话里输入：

请读取 src 目录结构，然后告诉我这个项目的入口文件在哪

如果 Claude 能正确列出目录并给出合理回答，说明 Base URL、Key、模型 ID 三件套都通了。如果报错，对照下一节的排查表。

会话管理也值得验证一下。给当前会话命名，比如/rename frontend-refactor，然后退出。重新进入时用claude --resume打开会话选择器，应该能看到刚才命名的会话。会话文本记录存在~/.claude/projects/<项目路径>/*.jsonl，每行是一个 JSON 对象，包含消息、工具调用和元数据。默认 30 天后清理，可以用cleanupPeriodDays调整。

5. 本篇常见错误排查：401、local proxy failed 与记忆不生效

接入过程中最常撞见的几类报错，逐个拆。

401 Unauthorized。这是最高频的。原因通常是三种：Key 没配、Key 配错、环境变量没生效。排查顺序：先echo $ANTHROPIC_API_KEY确认变量有值；再确认 Key 没有多余空格或换行；最后确认终端是配完变量后新开的。如果用的是.env文件加载，注意 Claude Code 不一定读.env，得用 shell 的 export 或者写进 shell 配置文件。

local proxy failed / connection refused。这个报错说明 Claude Code 尝试连的地址不对。检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api/（末尾多了斜杠）或者漏了/api。正确值是https://taotoken.net/api，不带末尾斜杠。另外确认本地没有其他工具占用同名环境变量，有些 IDE 插件会覆盖。

reading choices / unexpected response format。这类报错通常是模型 ID 写错了，或者请求打到了不兼容的端点。确认你用的模型 ID 在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite 列表里存在。如果配置里写了claude-3-opus但实际可用的是别的 ID，就会返回格式异常。

OAuth 相关报错。如果你之前用官方账号登录过 Claude Code，本地可能残留 OAuth 凭证，和 API Key 模式冲突。清理~/.claude/下的凭证缓存，或者显式设置ANTHROPIC_API_KEY让它走 Key 模式。

CLAUDE.md 不生效。先跑/memory确认文件被加载。如果没列出，检查文件路径和启动目录。如果列出了但 Claude 不遵守，多半是指令太模糊或互相冲突。比如两个 CLAUDE.md 一个说用 2 空格一个说用 4 空格，Claude 会任意选一个。用claudeMdExcludes排除无关的祖先文件：

{ "claudeMdExcludes": [ "/monorepo/CLAUDE.md", "/home/user/monorepo/other-team/.claude/rules/" ] }

自动记忆不保存。自动记忆不是每个会话都保存，Claude 会判断信息未来是否有用。如果你明确要求「记住 XXX」它还不保存，检查autoMemoryEnabled是不是被设成了 false，或者环境变量CLAUDE_CODE_DISABLE_AUTO_MEMORY=1被设置了。

权限规则不生效。settings.json 的路径要对，项目级是.claude/settings.json，用户级是~/.claude/settings.json。JSON 格式不能有注释和尾逗号。改完配置要重启会话才生效。

6. 把三大特性接进团队工作流的下一步

配置跑通之后，团队落地还有几个动作值得做。

把项目 CLAUDE.md 纳入代码评审。每次有人改架构决策或编码规范，CLAUDE.md 要同步更新，否则 Claude 会按旧规则产出代码。建议在 PR 模板里加一条检查项：「本次改动是否影响 CLAUDE.md 中的约定」。

权限规则按角色分层。新人用 default 模式加较严的 deny 列表，熟悉后逐步放开。核心仓库的package.json、CI 配置、迁移文件建议长期放在 deny 里，让 Claude 只读不写。

会话命名形成习惯。并行处理多个任务时，用/rename给每个会话起描述性名字，比如fix-auth-bug、refactor-api-layer。这样claude --resume时能快速定位，不用翻一堆无名会话。

自动记忆定期审计。/memory打开自动记忆文件夹，看看 Claude 都记了什么。有时候它会记下过时的信息，比如某个已经删掉的命令，这些要手动清理，否则会误导后续会话。

需要长期跑编码任务或 Agent 工作流的团队，可以了解 Coding Plan 的用法：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。如果只是想先验证模型对话效果，用 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 快速试几个 prompt。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，API Key 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。

最后提醒一个实操细节：Claude Code 的配置改动大多需要重启会话才生效，包括 CLAUDE.md 的修改、settings.json 的调整、环境变量的变更。改完别急着在当前会话里验证，先退出再进。这个坑我踩过不止一次，浪费的时间够配好几套模板了。