企业官网建设流程全解析

1. Claude Code Auto memory 自动记忆功能到底解决了什么问题

Claude Code 的 Auto memory 自动记忆功能，简单说就是给 Claude 配了一个随身笔记本。它在和你协作的过程中，会主动把一些它认为以后还用得上的信息记下来，比如这个项目用 pnpm 而不是 npm、构建命令要加某个特殊 flag、上次那个 CORS 报错最后是怎么解的。下次你新开一个会话，它会先把这些笔记翻一遍，直接进入状态，不用你从头再介绍一遍项目背景。

这个功能适合谁？我觉得有三类人特别需要。第一类是长期维护同一个项目的开发者，项目里有很多不成文的约定，比如错误码格式、日志规范、目录结构习惯，这些东西写不进 README，但每次新会话都要重复交代，很烦。第二类是经常在多个项目之间切换的人，每个项目的构建工具、测试命令都不一样，靠脑子记容易串。第三类是想把模型调用通道统一管理的开发者，因为 Claude Code 本身支持自定义 API 地址，配合 Auto memory 可以把项目级的调用习惯也沉淀下来。

Auto memory 默认就是开启的，不需要额外配置。它的存储路径在~/.claude/projects/你的项目名/memory/下面，每个项目一个独立文件夹，里面全是普通的 Markdown 文件，你随时可以打开看、编辑、删掉。核心文件叫MEMORY.md，相当于目录页，列出其他子文件的索引，比如调试经验在debugging.md、API 规范在api-conventions.md。Claude 每次启动只读MEMORY.md的前 200 行，了解"我有哪些记忆、分别在哪"，真正用到某块知识时才按需去读对应文件。这个设计和 Skill 的思路一样：先看目录，按需加载，省上下文空间。

但这里有个现实问题：很多开发者用 Claude Code 时，模型调用通道是分散的，有的走官方、有的走自建、有的走第三方，项目记忆里记的构建命令和调试经验，换一个通道可能就对不上了。所以这篇的重点不是单纯讲 Auto memory 怎么用，而是把它和 TaoToken 的 API 地址配置结合起来，让记忆内容和调用通道保持一致。下面我会先讲清楚 Auto memory 的文件结构和触发时机，然后给出可复制的 settings 配置片段，把 API 地址填成 TaoToken 的，最后演示一次记忆写入和读取的完整验证动作。

2. TaoToken 前置准备与 Claude Code 接入配置

在动 Auto memory 之前，得先把 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 ，注意这个地址后面不加 UTM 参数，直接填就行。

你需要先拿到一个 API Key。登录之后进控制台，在 API Keys 页面创建一个新的 Key，复制出来备用。这个 Key 就是后面配置里要填的ANTHROPIC_AUTH_TOKEN或者ANTHROPIC_API_KEY，具体用哪个取决于你的 Claude Code 版本和配置方式。

Claude Code 的配置有两种常见方式。一种是环境变量，适合临时测试或者 CI 环境；另一种是写进 settings 文件，适合长期使用。我建议用 settings 文件，因为 Auto memory 本身也是按项目存的，配置跟着项目走更清晰。

先看环境变量方式，在终端里执行：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="你的TaoToken API Key" export ANTHROPIC_MODEL="claude-sonnet-4-20250514"

这三行分别指定了 API 地址、认证 Token 和默认模型 ID。注意ANTHROPIC_BASE_URL填的是https://taotoken.net/api，不要多加斜杠或者路径。ANTHROPIC_MODEL填你实际要用的模型 ID，这个 ID 在 TaoToken 的模型列表里能查到。

如果你用的是 Claude Code 的 settings 文件方式，路径通常在~/.claude/settings.json或者项目级的.claude/settings.json。项目级配置优先级更高，适合不同项目用不同通道的场景。内容大概长这样：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken API Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }

这个 JSON 片段可以直接复制，把你的TaoToken API Key替换成真实 Key 就行。注意 JSON 里不能有注释，也不能有多余逗号。如果你用的是 TOML 格式的配置（某些版本支持），写法是：

[env] ANTHROPIC_BASE_URL = "https://taotoken.net/api" ANTHROPIC_AUTH_TOKEN = "你的TaoToken API Key" ANTHROPIC_MODEL = "claude-sonnet-4-20250514"

配置写完之后，Claude Code 启动时会读取这些环境变量，把请求发到 TaoToken 的 API 地址。这里有个关键点：Auto memory 记录的内容里，如果涉及构建命令、调试经验，这些是项目级的，和调用通道无关；但如果涉及模型调用习惯，比如"这个项目统一用某个模型 ID"，那配置里的ANTHROPIC_MODEL就要和记忆内容保持一致，否则会出现记忆里写的是 A 模型、实际调用走的是 B 模型的情况。

另外，如果你之前用过 CC Switch 或者 Cline MCP 这类工具，它们也会读写 Claude Code 的配置。CC Switch 是一个配置切换工具，Cline MCP 是另一个客户端的 MCP 配置。不管用哪个，核心三件套都是一样的：Base URL 填https://taotoken.net/api，Key 填 TaoToken 的 API Key，Model ID 填你要用的模型。这三样对齐了，Auto memory 记下来的调用习惯才有意义。

配置完成后，建议先跑一个最简单的验证请求，确认通道是通的。在终端里执行：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: 你的TaoToken API Key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [{"role": "user", "content": "回复 OK"}] }'

如果返回里有正常的content字段，说明通道没问题。这一步很重要，因为如果通道本身不通，后面 Auto memory 的验证会分不清是记忆功能的问题还是网络配置的问题。

3. 可复制的 settings 配置片段与 Auto memory 路径对齐

这一节把配置片段和 Auto memory 的存储路径对齐讲清楚。很多人配完 API 地址就以为完事了，结果 Auto memory 记的东西和实际调用对不上，问题往往出在路径和项目名的对应关系上。

Auto memory 的存储路径是~/.claude/projects/你的项目名/memory/。这里的"项目名"不是随便起的，它和 Claude Code 启动时的工作目录有关。通常 Claude Code 会用当前工作目录的某种哈希或者规范化名称作为项目标识。你可以先启动一次 Claude Code，然后去看~/.claude/projects/下面多了哪个文件夹，那个就是你的项目名。

假设你的项目名是my-app，那么记忆文件夹就是~/.claude/projects/my-app/memory/。里面初始可能只有MEMORY.md，随着使用会多出debugging.md、api-conventions.md、build-commands.md、preferences.md等文件。MEMORY.md的内容大概长这样：

# 项目记忆索引 ## 构建命令 见 build-commands.md — 使用 pnpm，测试命令有特殊 flag ## 调试经验 见 debugging.md — CORS 问题、Redis 连接超时的解法 ## API规范 见 api-conventions.md — 错误格式、验证规则

这个文件是 Claude 每次启动只读前 200 行的目录页。它不存具体内容，只存"哪类知识在哪个文件里"。真正的内容分散在子文件中，比如build-commands.md里可能写着：

# 构建命令 - 包管理器：pnpm（不要用 npm） - 开发启动：pnpm dev - 测试：pnpm test -- --runInBand - 构建：pnpm build

现在把 settings 配置和这个路径对齐。假设你的项目级 settings 文件在my-app/.claude/settings.json，内容如下：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken API Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" }, "memory": { "enabled": true, "path": "~/.claude/projects/my-app/memory" } }

注意memory.path这一项，不同版本的 Claude Code 对 memory 配置的支持程度不一样。有些版本不需要显式写 path，它会自动根据项目名推导；有些版本支持显式指定。如果你不确定，可以先不写memory这一段，用默认路径，等确认项目名之后再补上。

这里有个容易踩的坑：如果你在多个目录下启动 Claude Code，但项目名推导规则不一致，可能会出现记忆文件夹对不上的情况。我的做法是，在项目根目录下固定启动 Claude Code，不要在不同子目录里来回切。这样项目名稳定，记忆文件夹也稳定。

另外，如果你用 CC Switch 管理多个配置，注意 CC Switch 切换的是环境变量层面的配置，它不会自动改 Auto memory 的路径。所以切换配置后，要确认当前项目的记忆文件夹还是原来那个。Cline MCP 的情况类似，它管的是 MCP 服务配置，和 Auto memory 是两套东西，不要混在一起。

配置写完后，可以用一个简单的命令检查 JSON 格式是否正确：

cat ~/.claude/settings.json | python3 -m json.tool

如果输出格式化后的 JSON 没有报错，说明格式没问题。如果报Expecting property name enclosed in double quotes之类的错，通常是多了逗号或者用了单引号。

还有一点，ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY这两个变量名，不同版本的 Claude Code 可能认其中一个。如果你填了ANTHROPIC_AUTH_TOKEN但请求返回 401，可以试试换成ANTHROPIC_API_KEY。反过来也一样。这个在排障章节会详细讲。

4. 验证请求与 Auto memory 写入读取的完整演示

配置对齐之后，来演示一次完整的记忆写入和读取。这个过程分三步：先让 Claude 记一条信息，然后检查记忆文件是否真的写了，最后新开一个会话看它能不能读出来。

第一步，启动 Claude Code，在项目目录下执行：

cd ~/projects/my-app claude

进入交互界面后，输入一条明确的记忆指令：

记住，我们这个项目用 pnpm 不用 npm，测试命令是 pnpm test -- --runInBand

Claude 收到后，会判断这是一条值得记录的项目约定，然后写入记忆。你可以紧接着输入/memory查看当前记忆状态。如果一切正常，它会显示已经记录了这条构建命令相关的信息。

第二步，退出 Claude Code，去检查记忆文件。执行：

ls -la ~/.claude/projects/my-app/memory/

你应该能看到MEMORY.md以及可能的build-commands.md。打开build-commands.md：

cat ~/.claude/projects/my-app/memory/build-commands.md

如果里面出现了类似"包管理器：pnpm"、"测试命令：pnpm test -- --runInBand"的内容，说明写入成功。如果只有MEMORY.md而没有子文件，可能是 Claude 把内容直接写进了MEMORY.md，或者判断这条信息还不够具体。你可以手动编辑MEMORY.md补上索引，或者再给一条更明确的指令。

第三步，验证读取。完全退出 Claude Code，重新启动一个新会话：

claude

新会话启动时，Claude 会读取MEMORY.md的前 200 行。你可以直接问它：

我们这个项目用什么包管理器？测试命令是什么？

如果它回答 pnpm 和pnpm test -- --runInBand，说明读取成功。注意，它不一定每次都去读子文件，如果MEMORY.md的索引里已经写了"构建命令见 build-commands.md"，它可能会先读索引，需要细节时再读子文件。这是按需加载的设计，不是 bug。

为了更直观地验证 API 通道和记忆功能是协同工作的，可以在新会话里让它执行一个需要调用模型的任务，比如：

帮我写一个简单的 package.json 脚本，用上我们项目的测试命令

如果它生成的脚本里用了pnpm test -- --runInBand，说明它既读到了记忆，又通过 TaoToken 的通道正常调用了模型。这一步把记忆验证和通道验证合在一起了。

如果你在验证过程中遇到请求失败，可以先单独测通道：

curl -s https://taotoken.net/api/v1/messages \ -H "x-api-key: 你的TaoToken API Key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model":"claude-sonnet-4-20250514","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}' | head -c 500

如果这个 curl 返回正常，但 Claude Code 里报错，那问题在 Claude Code 的配置读取上，不在通道上。如果 curl 也失败，先检查 Key 和地址。

还有一个细节：Auto memory 的写入不是每次对话都触发。它有两种触发方式，一种是你主动说"记住"，另一种是它自己判断信息将来有用。官方没有公开具体判断算法，但从实际表现看，它主要记这几类：构建工具命令、调试问题和解法、项目不成文规矩、个人风格偏好。所以如果你给的信息太泛，比如"这个项目很重要"，它可能不记。要给具体的、可复用的信息。

5. 本篇常见错误排查：401、local proxy failed、reading choices、OAuth

这一节把配置和验证过程中最容易遇到的几个报错集中讲一下。这些报错我都在实际环境里碰到过，按下面的顺序排查基本能定位。

第一个，401 未授权。报错信息通常是：

API Error: 401 Unauthorized

或者：

{"type":"error","error":{"type":"authentication_error","message":"invalid x-api-key"}}

原因通常是 Key 填错了，或者变量名用错了。先确认ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY哪个生效。有些版本只认其中一个。你可以两个都填上试试：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的TaoToken API Key", "ANTHROPIC_API_KEY": "你的TaoToken API Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }

如果还是 401，检查 Key 有没有多余空格，或者是不是复制的时候漏了字符。另外确认 Key 没有过期或被禁用。

第二个，local proxy failed。报错信息：

Error: local proxy failed to start

或者：

connect ECONNREFUSED 127.0.0.1:xxxx

这个通常和本地代理设置有关。Claude Code 某些版本会尝试启动本地代理来转发请求。如果你之前配过HTTP_PROXY或HTTPS_PROXY环境变量，可能会冲突。检查一下：

env | grep -i proxy

如果有输出，先临时清掉：

unset HTTP_PROXY unset HTTPS_PROXY unset ALL_PROXY

然后重新启动 Claude Code。注意，这里说的是清掉本地代理环境变量，不是让你去用什么网络工具，只是避免本地代理配置干扰正常的 API 请求。

第三个，reading choices。报错信息：

Error: reading 'choices' of undefined

这个报错通常出现在响应格式不符合预期的时候。Claude Code 期望的是 Anthropic 格式的响应，如果 API 地址填错了，返回了 OpenAI 格式的响应，就会报这个错。检查ANTHROPIC_BASE_URL是不是填成了https://taotoken.net/api，不要填成带/v1/chat/completions的地址。Anthropic 格式的端点是/v1/messages，不是/v1/chat/completions。

第四个，OAuth 相关报错。报错信息：

OAuth token expired

或者：

Failed to refresh OAuth token

这个通常出现在你之前用官方登录方式认证过，配置里残留了 OAuth 相关的 token。解决办法是清掉旧的认证信息，改用 API Key 方式。检查~/.claude/下面有没有credentials.json之类的文件，如果有，先备份再删掉，然后重新用 API Key 配置。

ls -la ~/.claude/ mv ~/.claude/credentials.json ~/.claude/credentials.json.bak

然后重新启动 Claude Code，它会用 settings 里的 API Key 认证。

除了这四个，还有一个常见问题是记忆不生效。表现是：明明说了"记住"，但新会话里问它，它说不记得。排查步骤：先确认~/.claude/projects/你的项目名/memory/目录存在且有写权限；再确认MEMORY.md里有对应的索引条目；最后确认新会话启动时工作目录和之前一致，项目名没变。如果项目名变了，记忆文件夹就对不上了。

如果以上都排查完还是有问题，可以去 TaoToken 的接入文档页面看最新的配置说明，地址是 https://taotoken.net/api ，文档里有针对不同客户端的配置示例。另外，模型对话页面可以用来单独测试模型是否正常响应，地址是 https://taotoken.net/api ，进去之后选模型发一条消息，看返回是否正常。这一步能把模型问题和配置问题分开。

6. 把 Auto memory 和 TaoToken 通道一起用起来的实际建议

Auto memory 这个功能，用好了确实省事，但它不是万能的。我的经验是，把它当成项目级的"工作笔记"，而不是"知识库"。工作笔记的特点是：记具体的命令、具体的报错、具体的约定，不记泛泛的道理。比如"用 pnpm"比"用好的包管理器"有用，"CORS 报错加 Access-Control-Allow-Origin"比"注意跨域问题"有用。

配合 TaoToken 的通道，我建议把模型 ID 也写进记忆里。比如在preferences.md里加一条：

# 个人偏好 - 默认模型：claude-sonnet-4-20250514 - API 通道：TaoToken（https://taotoken.net/api） - 长任务用 Coding Plan，短验证用模型对话

这样新会话启动时，Claude 读到这条，就知道当前项目默认走哪个通道、用哪个模型。当然，实际调用还是由 settings 里的ANTHROPIC_MODEL决定，记忆里的这条只是给 Claude 一个上下文参考，让它知道"这个项目的习惯是什么"。

如果你经常做长期编码或者 Agent 类的任务，可以考虑用 Coding Plan，地址是 https://taotoken.net/api ，里面有更详细的套餐说明。短平快的验证，比如测一个模型能不能正常返回，用模型对话页面就够了。API Keys 的管理在控制台，地址是 https://taotoken.net/api ，创建和吊销 Key 都在那里。

最后说一个我踩过的坑：Auto memory 的MEMORY.md前 200 行是启动时必读的，所以这个文件不要写太长。如果你手动往里加内容，尽量保持精简，把详细内容放到子文件里。否则 200 行被占满，后面的索引就读不到了。我一般让MEMORY.md控制在 50 行以内，只放分类和文件名，具体内容全放子文件。这样启动快，按需加载也准。

还有一个实用技巧：定期清理记忆。项目做久了，debugging.md里会堆很多已经过时的报错解法。每隔一段时间翻一下，把不再适用的删掉，或者归档到archive/子目录。记忆文件是普通 Markdown，你直接用编辑器改就行，改完 Claude 下次启动就会读到新的。不用重启什么服务，也不用重新配置。

如果你在配置过程中遇到通道问题，优先去 API Keys 页面确认 Key 状态，再去接入文档对照配置示例。模型本身的问题，用模型对话页面单独测一下就能定位。这三步走完，大部分问题都能自己解决。