1. 为什么你的 Claude Code 需要一个 settings.json 骨架
Claude Code 是 Anthropic 推出的终端 AI 编程助手，能直接在命令行里读写代码、跑测试、改 Bug。但很多人装完之后发现：每次启动都像面对一个陌生人，项目背景要重讲一遍，回答风格也飘忽不定。oh-my-claudecode 这个项目就是来解决这件事的——它给 Claude Code 加了一层持久记忆和人格配置，让助手记住你的技术栈、代码偏好和项目结构。
不过 oh-my-claudecode 本身只负责“记忆层”，真正决定 Claude Code 走哪条 API 通道、用哪个 Key、加载哪些环境变量的，是settings.json。这篇就聚焦这个配置文件的落地：给你一份可直接复制的骨架，把 oh-my-claudecode 和 TaoToken 的 API 通道接起来，最后用启动验证确认助手真的在按你的配置响应。
适合谁看：已经在用 Claude Code、想把它变成专属编程助手的开发者；手里有 TaoToken API Key、想把模型调用统一到一个通道的人；以及被settings.json各种字段绕晕、想要一份能跑起来的最小骨架的人。
2. TaoToken 前置：Key、通道与目录约定
TaoToken 在这里的角色是统一的 API 通道。Claude Code 默认走 Anthropic 官方端点，而通过settings.json里的env字段，你可以把ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址，再用一个 Key 完成鉴权。这样 oh-my-claudecode 的记忆层不变，底层模型请求走统一入口，换模型、换项目都不用改代码。
先做三件事：
第一，拿到 API Key。登录 TaoToken 控制台，在 API Keys 页面创建一个新 Key，复制保存。地址是 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，创建后只显示一次，别关页面再复制。
第二，确认 API 基地址。TaoToken 的 API 入口是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为ANTHROPIC_BASE_URL的值。
第三，规划目录。oh-my-claudecode 的记忆文件（SOUL.md、USER.md、MEMORY.md、AGENTS.md）建议放在项目根目录的.claude/下，settings.json放在~/.claude/settings.json（全局）或项目级.claude/settings.json。全局配置对所有项目生效，项目级配置只对当前仓库生效，两者会合并，项目级优先。
提示：如果你同时用多个模型通道，建议把 Key 写进环境变量而不是硬编码进
settings.json，避免提交到 Git 时泄露。下面骨架里我会用占位符标注。
3. 可复制的 settings.json 配置骨架
下面这份骨架是实测能跑通的最小集合。字段分三块：env管 API 通道，permissions管工具权限，memory管 oh-my-claudecode 的记忆加载。你可以直接复制，把sk-你的TaoTokenKey换成自己的 Key。
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的TaoTokenKey", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514", "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8192" }, "permissions": { "allow": [ "Read", "Write", "Edit", "Bash(git status)", "Bash(npm run test:*)", "Bash(npm run lint)" ], "deny": [ "Bash(rm -rf:*)", "Bash(curl:*)" ] }, "memory": { "enabled": true, "directory": ".claude/memory", "files": { "soul": "SOUL.md", "user": "USER.md", "memory": "MEMORY.md", "agents": "AGENTS.md" }, "autoLoad": true } }几个关键点解释一下。ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址后，Claude Code 的所有模型请求都会走这个通道，不再直连官方端点。ANTHROPIC_MODEL填你账号下可用的模型名，不确定就先留空，让 Claude Code 用默认值。permissions.allow里我放开了读写和几个安全的 Bash 命令，deny里挡掉了删除和外部请求，这是防止助手误操作的第一道闸。
memory块是 oh-my-claudecode 的接入点。directory指向记忆文件存放位置，autoLoad: true表示每次启动自动加载 SOUL.md 和 USER.md。如果你还没建这些文件，先建一个空的SOUL.md，内容写一行“你是一个简洁、代码优先的编程助手”，就能看到效果。
项目级配置可以只覆盖差异部分，比如某个前端项目想换模型：
{ "env": { "ANTHROPIC_MODEL": "claude-haiku-4-20250514" } }放在项目根目录.claude/settings.json，启动时它会和全局配置合并，只改模型这一项。
4. 验证请求：启动 Claude Code 并确认配置生效
配置写完不算完，得验证助手真的在按你的设置响应。分三步走。
第一步，检查配置是否被正确读取。在项目根目录执行：
claude --config ~/.claude/settings.json --print-config如果输出里能看到ANTHROPIC_BASE_URL是https://taotoken.net/api，说明通道配置生效。看不到就检查 JSON 语法，常见问题是多了个逗号或少了引号。
第二步，启动交互式会话，发一条测试请求：
claude进入后输入：
请用一句话说明当前项目用的是什么技术栈，然后写一个 hello world 函数。如果 oh-my-claudecode 的记忆加载正常，助手应该能引用你USER.md里写过的技术栈信息。如果它回答“我不知道你的技术栈”，说明记忆文件没被加载，回去检查memory.directory路径和autoLoad字段。
第三步，确认请求走的是 TaoToken 通道。在另一个终端窗口执行：
curl -s https://taotoken.net/api/v1/models \ -H "Authorization: Bearer sk-你的TaoTokenKey" | head -c 300能返回模型列表 JSON，说明 Key 和通道都通。如果返回 401，是 Key 错了；返回 404，是地址拼错了，注意ANTHROPIC_BASE_URL不要带/v1后缀，Claude Code 会自己拼。
实测下来，三步都通过后，你重启 Claude Code 会发现它记得上次聊的项目背景，回答风格也稳定了。这就是 oh-my-claudecode 加 TaoToken 通道的组合效果。
5. 本篇常见错排查
配置过程中最容易卡在几个地方，我按出现频率排一下。
报错Invalid API key或 401。先确认ANTHROPIC_API_KEY的值没有多余空格，Key 复制时别把换行带进去。再确认这个 Key 在 TaoToken 控制台是启用状态。如果 Key 没问题，检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api/带尾斜杠，去掉尾斜杠再试。
报错settings.json parse error。这是 JSON 语法问题。用python -m json.tool ~/.claude/settings.json校验一下，它会告诉你第几行出错。最常见的是注释——JSON 不支持//注释，想写说明就单独放个 README。
助手不记得项目背景。检查memory.directory指向的目录里是否真的有SOUL.md和USER.md。oh-my-claudecode 不会自动创建这些文件，需要你手动建。另外autoLoad必须是true，否则每次都要手动触发加载。
模型名报model not found。ANTHROPIC_MODEL填的模型名必须是你 TaoToken 账号下可用的。不确定就先删掉这一行，让 Claude Code 用默认模型，跑通后再逐个试。模型对话页面可以帮你确认哪些模型可用： https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 。
权限被拒，助手无法写文件。检查permissions.allow里有没有Write和Edit。如果你只放了Read，助手只能读不能改。但别为了省事把deny清空，rm -rf这类命令该挡还是挡。
多个终端同时启动导致记忆冲突。oh-my-claudecode 的记忆文件是本地文件，并发写入会互相覆盖。建议一次只开一个 Claude Code 会话，或者给不同项目用不同的memory.directory。
6. 把配置沉淀成你的专属助手
骨架跑通之后，真正让 Claude Code 变成“你的”助手的，是往里填内容。SOUL.md写人格和回答风格，比如“代码优先、少解释、用 TypeScript 严格模式”；USER.md写你的技术栈和项目约定；MEMORY.md让它跨会话记住长期事项。这些文件不用一次写完，用着用着往里补就行。
如果你打算长期在多个项目里用这套配置，建议把全局settings.json和记忆文件模板放到一个私有仓库里，新机器 clone 下来改个 Key 就能用。Coding Plan 页面有关于长期编码场景的通道说明，可以对照着调整模型和 token 上限： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。
接入文档里有settings.json全部字段的说明，遇到骨架里没覆盖的字段可以去查： https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。配置这东西，跑通一次之后就是复制粘贴的事，真正花时间的是把记忆文件养起来——但那部分，才是它变成你专属助手的关键。
