企业官网建设流程全解析

1. 为什么你的 Claude Code 总在“无效对话”

刚上手 Claude Code 的时候，很多人都会经历一个落差：第一周觉得它像个资深工程师，第三周开始觉得它像个记性不好的实习生。同一个项目里，你反复告诉它“我们用的是 NestJS 不是 Express”“接口返回必须包 Result 结构”“别用 any”，它每次都点头，下一次开新会话又忘得一干二净。

问题不在模型能力，而在你把它当成了一个每次从零开始的聊天窗口。真实项目里，最大的沟通成本不是写代码，而是重复解释背景：技术栈版本、目录约定、日志规范、构建命令、业务禁区。这些信息如果每轮对话都要重新输入，Token 被大量浪费在“自我介绍”上，AI 的输出风格也会飘忽不定。

Claude Code 给出的解法是CLAUDE.md——项目根目录下自动加载的配置文件，相当于给 AI 装了一份“长期记忆”。配合几套标准化工作流，它才能从“临时工”变成“固定搭档”。这篇就按真实项目落地的顺序，把 CLAUDE.md 骨架、settings.json 关键项、五大工作流和逐条验证方法讲清楚，让你能直接复制到自己的仓库里跑起来。

2. 前置准备：TaoToken 接入与 Claude Code 环境

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 Key。登录后进入控制台，在 API Keys 页面创建一个新密钥，复制出来先存到安全的地方。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console_key&utm_campaign=rewrite ，密钥管理页在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=apikeys_page&utm_campaign=rewrite 。创建时建议按项目命名，比如claude-code-dev，方便后面区分不同环境的额度。

拿到 Key 之后，在终端里设置环境变量。macOS 或 Linux 下可以直接写进~/.zshrc或~/.bashrc：

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

Windows PowerShell 用户用：

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

设置完执行source ~/.zshrc或重开终端，然后运行claude --version确认工具本身可用。如果这一步报连接错误，先别急着改 CLAUDE.md，问题大概率在环境变量或密钥上，后面第 5 节会专门讲排查。

注意：环境变量里的 Base URL 不要带末尾斜杠，也不要手动拼/v1，Claude Code 会自己处理路径。

3. 可复制配置：CLAUDE.md 骨架与 settings.json 关键项

3.1 用 /init 生成初稿再人工调优

新项目不用手写 CLAUDE.md。在项目根目录启动 Claude Code，输入/init，它会扫描目录结构、package.json或pom.xml、现有代码风格，生成一份基础模板。但自动生成的版本通常偏泛，必须人工补四类信息：技术栈版本锁定、代码风格约束、构建运行指令、业务禁区。

下面是我在一个 NestJS + TypeScript 项目里实际用的 CLAUDE.md 片段，你可以直接改成自己的：

# 项目规范 ## 技术栈 - Node.js 20 LTS, TypeScript 5.4, NestJS 10 - 数据库 PostgreSQL 15，ORM 使用 TypeORM - 禁止引入 Express 原生中间件写法 ## 代码风格 - 所有函数必须显式声明返回类型 - 禁止使用 any，未知类型用 unknown 并做类型收窄 - 异步统一 async/await，禁止回调 - 文件命名用 kebab-case，类名用 PascalCase ## 构建与运行 - 开发: npm run start:dev - 单元测试: npm run test - 端到端: npm run test:e2e - 迁移生成: npm run migration:generate -- src/migrations/Name ## 业务约束 - 所有 API 响应包裹在 Result<T> 结构中 - Controller 层禁止写业务逻辑，只做参数校验和转发 - 数据库字段变更必须生成 Migration，禁止直接改实体同步

这份文件放在仓库根目录，Claude Code 每次新会话都会自动读取。团队协作时把它提交到 Git，所有人共享同一套规则，AI 输出风格就统一了。

3.2 settings.json 里值得改的几项

Claude Code 的行为还可以通过.claude/settings.json微调。几个我实测下来影响最大的项：

{ "permissions": { "allow": ["Bash(npm run test:*)", "Bash(git diff:*)", "Read"], "deny": ["Bash(rm -rf:*)", "Bash(git push:*)"] }, "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api" } }

allow里放你信任的只读或测试命令，减少每次执行的确认弹窗；deny里放危险操作，比如强制推送和递归删除，让 AI 即使“想”执行也会被拦下。这一层是防御性的，配合后面的 Plan 模式一起用效果最好。

3.3 上下文管理：/compact 与 /clear 的时机

配置只是静态规则，长对话依然会把上下文窗口塞满。两个命令要养成习惯：对话变长但任务没结束时用/compact，它会压缩历史、保留结论；一个任务彻底结束、要开新模块时用/clear，清空干扰信息。我的循环是：任务开始 → 执行 → 变长时/compact→ 里程碑达成后更新 CLAUDE.md → 新任务前/clear。

4. 五大核心工作流与逐条验证

配置到位后，效率提升靠的是固定交互模式。下面五套工作流我都跑过，每套附上验证是否生效的方法。

4.1 探索-规划-编码-提交（复杂重构）

面对遗留代码重构，最忌讳直接说“开始写代码”。正确顺序是先探索、再规划、确认后分步执行。比如把 Session 认证迁移到 JWT：

读取 src/auth 目录下所有文件，分析现有认证流程和风险点 基于分析，制定从 Session 迁移到 JWT 的详细计划，考虑向后兼容

等它输出计划后，你审查步骤，确认无误再让它执行第二步。验证方法：看它是否在动手前先列出了文件清单和风险点。如果它直接开始改代码，说明你的指令缺少“先分析”的约束，回到 CLAUDE.md 里补一条“复杂任务必须先输出计划再执行”。

4.2 测试驱动开发（TDD）

核心业务逻辑用 TDD 最稳。流程是：先让它写测试并确认失败（Red），再实现功能让测试通过（Green），最后重构。指令示例：

为用户登录功能编写测试，覆盖正常登录、密码错误、账号冻结三种场景 运行测试，确认全部失败 实现登录逻辑，目标是让测试通过，不要修改测试文件

验证方法：跑npm run test，看它是否真的先红后绿。如果它跳过失败确认直接写实现，说明测试文件被它顺手改了，检查 git diff 里测试文件是否有变动。

4.3 视觉反馈迭代（UI 开发）

前端还原设计稿时，把 Figma 截图拖进终端，让它生成组件，然后在浏览器预览、截图、再拖回去指出差异。指令像这样：

根据这张设计图实现 React 组件，使用 Tailwind CSS 对比原设计图，按钮间距大了 4px，主色调偏暗，请调整

验证方法：迭代 2-3 轮后对比截图，看间距和色值是否收敛。如果每轮差异都不变小，可能是截图分辨率太低，换成局部放大截图再试。

4.4 代码库问答（新项目上手）

接手陌生项目时，直接问结构性问题，比盲目读代码快得多：

这个项目的日志系统如何工作？画出数据流向 CustomerOnboardingFlowImpl 处理了哪些边界情况？列出具体判断逻辑 增加短信验证码登录需要改哪些文件？

验证方法：挑一个它提到的文件打开核对，看行号和逻辑是否对得上。如果它给出的文件路径不存在，说明检索到了幻觉，让它先ls确认目录再回答。

4.5 Git 自动化与提交规范

日常提交可以完全交给它：

分析当前 git diff，按 Conventional Commits 生成 commit message 查看 v1.2.3 以来的更改，生成 changelog 草稿 创建分支 feature/user-profile 并提交当前修改

验证方法：执行git log -1看提交信息是否符合feat:、fix:前缀规范。如果它把多个不相关改动塞进一个 commit，在 CLAUDE.md 里加一条“提交前先按模块拆分 diff”。

5. 本篇常见错排查

报错一：ANTHROPIC_BASE_URL未生效，请求仍走默认端点。检查环境变量是否在启动 Claude Code 的同一个 shell 里设置。用echo $ANTHROPIC_BASE_URL确认输出是https://taotoken.net/api。如果为空，说明写进了错误的配置文件，或者没执行source。

报错二：401 Unauthorized。密钥复制时带了空格，或者创建后没保存。去 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=apikeys_401&utm_campaign=rewrite 重新生成一个，粘贴时注意首尾不要有换行。

报错三：CLAUDE.md 没被读取。确认文件名大小写完全一致，必须是根目录下的CLAUDE.md。放在子目录或改名成claude.md都不会被自动加载。可以在会话里问它“你读到了哪些项目规范”，看回答里有没有你写的内容。

报错四：AI 乱改无关文件。指令里显式指定文件边界，比如“仅修改 src/auth/login.ts，不要触碰其他文件”。同时确保工作区干净，git status无未提交改动，出问题一句git checkout -- .就能回滚。

报错五：长对话后回答质量骤降。这是上下文被填满的典型症状，执行/compact压缩，或者/clear后重新加载 CLAUDE.md 开始新任务。

6. 把配置落到日常提交里

CLAUDE.md 的价值不在于写得多漂亮，而在于它被持续维护。每次项目引入新依赖、调整目录结构、定下新规范，顺手更新这份文件，AI 的“记忆”就跟着项目一起演进。五大工作流也不用一次全上，先从 TDD 和 Git 自动化这两个高频场景切入，跑顺了再补复杂重构和视觉迭代。

如果你还没配好接入环境，可以先到模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat_verify&utm_campaign=rewrite 发一条测试请求，确认密钥和端点通了，再回到终端跑 Claude Code。长期做编码和 Agent 任务的，可以看下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=codingplan_cta&utm_campaign=rewrite ，接入细节都在文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc_cta&utm_campaign=rewrite 里。配置这件事，跑通一次之后就是复利。