企业官网建设流程全解析

1. 为什么要在 Claude Code 里再套一层 Peaks-CLI

如果你已经在用 Claude Code 写代码，大概率经历过这几个瞬间：让它改一个组件，它顺手动了三个不相关的文件；让它按团队规范写，它写完你还要手动补 ESLint 和命名；一个需求从 PRD 到 UI 到联调，每换一个环节就要重新把上下文喂一遍。Peaks-CLI 想解决的就是这类"环节之间掉链子"的问题。

先把定位说清楚：Peaks-CLI 不是一个新的 LLM，也不是要替代 Claude Code。它更像给 Claude Code 装的一套"附魔+宝石"——底层推理还是 Claude，Peaks-CLI 负责把开源能力（SuperPowers、OpenSpec、everything-claude-code、understand-anything 等）和自研的调度、记忆、分片能力编排起来，让 AI Coding 从"单次对话"变成"有流程、有记忆、有交接"的工程链路。

它适合谁？三类人最明显：一是前端/全栈这种经常在 IDE 和终端之间来回切、又想认真用 AI Coding 的开发者；二是团队里想统一 AI 产出规范、不想每次 review 都在纠格式的人；三是已经在用 Claude Code、但觉得上下文老丢、token 烧得快的人。这篇就按"安装 → 配置统一 Key/API 通道 → 启动 Claude Code → 跑通 peaks-solo → 排错"的顺序，把本地链路完整走一遍。

2. 前置准备：TaoToken 统一 Key 与 API 通道

在装 Peaks-CLI 之前，先把模型通道这件事定下来。Claude Code 和 Peaks-CLI 都会读环境变量里的 API 配置，如果你每个工具各配一套 Key，后面排查问题会非常痛苦。我的做法是统一走 TaoToken 的 API 通道，一个 Key 覆盖 Claude Code 和 Peaks-CLI 的调用。

TaoToken 在这里的角色是"统一入口"：你不需要在多个工具里分别维护不同的接入地址和密钥，Claude Code、Peaks-CLI 以及后续可能加的 Agent 都指向同一个 API 端点即可。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api （这个地址不加 UTM 参数，配置里直接写它）。

拿 Key 的路径很直接：进控制台创建 API Key，然后到接入文档确认当前推荐的模型名和请求格式。控制台地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&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 。建议先把 Key 复制到一个临时文本里，下一步配置要用。

注意：Key 只存在本地环境变量或配置文件里，不要提交到 Git 仓库，也不要在截图里露出完整字符串。

3. 可复制配置：settings.json 与 config.toml 骨架

Claude Code 的配置分两层：一层是环境变量（决定请求打到哪个 API、用哪个 Key），一层是 settings.json（决定权限模式、工具行为）。Peaks-CLI 则主要读自己的 config.toml。下面给的是能直接抄的骨架，你只需要替换 Key 和模型名。

先配环境变量。macOS/Linux 写进~/.zshrc或~/.bashrc，Windows 用系统环境变量或 PowerShell 的$PROFILE：

# TaoToken 统一 API 通道 export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="sk-你的TaoTokenKey" export ANTHROPIC_MODEL="claude-sonnet-4-5"

改完执行source ~/.zshrc让配置生效，然后echo $ANTHROPIC_BASE_URL确认输出正确。

接着是 Claude Code 的settings.json，放在项目根目录的.claude/settings.json，或者用户级的~/.claude/settings.json：

{ "permissions": { "allow": [ "Read", "Edit", "Bash(npm run lint)", "Bash(npm run test:*)", "Bash(git status)", "Bash(git diff:*)" ], "deny": [ "Bash(rm -rf:*)", "Bash(git push --force:*)" ] }, "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_MODEL": "claude-sonnet-4-5" } }

这里allow里放的是高频且低风险的操作，deny里放的是不可逆操作。即使你后面用 bypassPermissions 模式，deny列表里的规则依然会拦下来让你确认，这是最后一道门禁。

Peaks-CLI 的config.toml一般位于~/.peaks/config.toml（首次运行peaks命令会自动生成目录）。骨架如下：

[llm] provider = "anthropic" base_url = "https://taotoken.net/api" api_key_env = "ANTHROPIC_AUTH_TOKEN" model = "claude-sonnet-4-5" max_tokens = 8192 [memory] enabled = true dir = ".peaks/memory" index = true [sub_agents] enabled = true dir = ".peaks/_sub_agents" max_parallel = 3 [skills] auto_handoff = true

几个参数值得说明：api_key_env指向环境变量名而不是直接写 Key，这样配置文件可以安全地进版本库；memory.index = true会为记忆文件建索引，避免每次把整份 markdown 塞进上下文；auto_handoff = true打开环节之间的自动交接，这是 Peaks-CLI 降低偏移的核心开关。

4. 安装与启动：npm 装 Peaks-CLI 和 Claude Code

配置就绪后开始装工具。两个包都用 npm 全局安装：

npm i -g peaks-cli npm i -g @anthropic-ai/claude-code

装完验证版本：

peaks -v claude --version

peaks -v能打印版本号就说明 CLI 本体没问题。如果提示 command not found，多半是 npm 全局 bin 目录不在 PATH 里，用npm config get prefix看一下路径，把它加进 PATH。

启动 Claude Code 有两种模式，区别在于权限确认的频率。普通模式直接输入：

claude

首次进入某个目录会问你是否信任该文件夹，选 "Yes, I trust this folder"。之后 AI 每次要写文件、执行命令都会弹确认，适合刚上手、想看清楚每一步在干什么的阶段。

另一种是 bypassPermissions 模式：

claude --permission-mode bypassPermissions

启动后界面会多出 bypass permissions 标识，也能用shift + tab在模式间切换。这个模式省去了大量手动确认，但要注意：它并不是无脑放行，遇到rm -rf这类不可逆操作依然会停下来让你确认，settings.json里deny的规则也照常生效。我的习惯是日常开发用 bypassPermissions 提效，涉及生产配置或数据库脚本时切回普通模式。

提示：模式一旦启动后再想切换，普通模式可以切到 bypass，反过来则要重开终端，所以启动前想清楚这次要干什么。

5. 跑通 peaks-solo：从项目分析到请求验证

工具装好、Claude Code 起来之后，进入 Peaks-CLI 的核心用法。在 Claude Code 的输入框里输入/会弹出技能列表，用 TAB 补全。最常用的入口是/peaks-solo，用自然语言描述需求即可。

第一次在一个已有项目里跑，建议先让它做项目分析：

/peaks-solo 分析当前项目结构，输出代码规范和架构说明

它会扫描项目，生成分析报告和规范 markdown 文件。这一步的价值在于：后续 AI 写代码时不仅遵守 ESLint 这类硬性检查，还会遵守这份规范文件里的约定，比如目录组织、命名风格、组件拆分粒度。

分析完成后会让你选择执行模式，模式不是写死的，是 LLM 根据你的描述推荐的，一般用它推荐的就行。接着描述具体需求，比如：

/peaks-solo 给用户列表页加一个按注册时间筛选的功能，需要改 UI 和接口调用

这时 Peaks-CLI 会根据需求调用 peaks-prd、peaks-ui、peaks-rd、peaks-qa 等技能的组合。关键在于 handoff：下一个技能启动前会拿到前面所有技能的汇总，所以从需求到 UI 到实现到测试，上下文是连贯的，不会每换一个环节就重新解释一遍。这既降低了偏移，也省了 token。

验证请求是否真的打通了 TaoToken 通道，有两个动作。一是在 Claude Code 里发一句最简单的对话，看是否正常返回；二是直接对 API 端点做一次请求：

curl -s https://taotoken.net/api/v1/messages \ -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-5", "max_tokens": 64, "messages": [{"role": "user", "content": "回复 ok 两个字母"}] }'

返回体里能看到content字段和正常文本，就说明 Key、端点、模型名三者都对上了。如果这一步失败，问题一定在配置层，不用去怀疑 Peaks-CLI。

跑通之后你会注意到项目里多了.peaks/memory/目录，每次用完 peaks 相关技能都会自动生成一份记忆 markdown，下次命中已有记忆时 AI 能更快理解业务。记忆本身是 LLM 生成的 markdown，直接全量塞进上下文会撑爆，所以 Peaks-CLI 引入了索引来加速检索。另外.peaks/_sub_agents下是子 agent 的拆分，大部分 skill 本质上是调度 Agent，会根据需求拆子任务，在保证质量的前提下并行推进。

6. 本篇常见错排查

配置和启动阶段最容易踩的坑集中在几处，按出现频率排一下。

报错401 Unauthorized或invalid api key：九成是环境变量没生效或 Key 写错。先echo $ANTHROPIC_AUTH_TOKEN确认有值，再检查settings.json里的env是否覆盖了 shell 里的变量。注意ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY是两个不同的变量名，Claude Code 认前者，写错就静默失败。

报错model not found：模型名和 TaoToken 通道支持的列表对不上。去接入文档核对当前可用模型名，别凭记忆写。config.toml和settings.json里的模型名要保持一致，否则会出现 Claude Code 能跑、Peaks-CLI 报错的分裂情况。

peaks -v无输出或 command not found：npm 全局 bin 不在 PATH。npm config get prefix拿到路径后加进 PATH，重开终端再试。Windows 上还要注意是否用了 nvm，nvm 切换 Node 版本后全局包会"消失"，需要在新版本下重装。

peaks-solo 初始化时报"操作被拦截"：这是门禁生效的正常现象，不是 bug。Peaks-CLI 对 LLM 的文件操作做了拦截，确认无误后放行即可。如果频繁被拦影响效率，检查settings.json的allow列表是否覆盖了你的高频操作。

记忆目录膨胀、响应变慢：.peaks/memory/下文件太多时检索会变慢。确认config.toml里memory.index = true已开启，定期清理过期的记忆文件。别手动删索引文件，让它自动重建。

handoff 后上下文丢失：检查auto_handoff是否为 true。如果手动关过，环节之间就不会自动传递汇总，表现为每换一个技能都要重新描述需求。

7. 把链路固定下来：日常调用与后续接入

跑通一次之后，建议把日常流程固定成三步：进项目目录 →claude --permission-mode bypassPermissions启动 →/peaks-solo描述需求。项目分析只在首次或架构大改后做，日常直接进需求描述。

如果你要长期用这套链路做编码和 Agent 任务，可以了解下 Coding Plan，地址是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，适合把 Claude Code + Peaks-CLI 作为主力开发方式的场景。想先单独验证模型对话效果，用模型对话页 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 快速试一句。Key 管理和接入细节分别在 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 。

最后说个实测下来的经验：Peaks-CLI 的记忆和 handoff 是它区别于裸用 Claude Code 的核心，但这两块都依赖你第一次的项目分析质量。分析阶段描述得越具体（技术栈、目录约定、团队规范），后面 AI 产出越贴你的预期。别跳过那一步直接写业务代码，省下的十分钟后面要用十次返工补回来。