1. 为什么你的 Claude Code 只会写代码改 Bug
很多人装好 Claude Code 或 Codex 之后,用了几次就放下了,原因出奇地一致:只会让它写函数、改报错、跑命令。用完即走,下次打开还得重新解释一遍背景。这不是工具不行,是你还没让它真正“看见”你的工作现场。
我试过把同一段只读扫描指令丢给刚配好的 Claude Code,它列出来的东西让我有点意外——它从我桌面的文件夹命名、项目结构、反复出现的文档类型里,推断出我同时在维护内容、工具和交付流程。这些判断不是靠我自我介绍得来的,是靠它真的读了文件。
问题在于,这三步玩法每一步都在烧 Token。只读扫描要遍历目录、读文件头、分析结构;判断工作类型要把前面读到的内容全部塞进上下文;落地 Skills 又要基于前面的分析反复推理。一轮下来,请求次数和上下文长度都不小。如果模型通道没配好,要么中途断掉,要么每一步都得重新配一次 Key,体验很割裂。
所以正确的顺序是:先把模型通道固定下来,再跑那三步。TaoToken 在这里的角色很简单——它只给你一把 Key 和一个 Base URL,扫描、判断、生成 Skills 这些动作仍然由 Claude Code / Codex 自己完成。通道固定之后,后面每一次 Skill 调用都走同一条路,不用为每一步单独重配。
这篇就按这个顺序写:先拿 Key,再改配置,然后跑三步扫描,最后把重复工作流沉淀成 5-10 个本地 Skills。每一步都有可复制的命令和配置,新手照着做就行。
2. 前置准备:拿到 TaoToken 的 Key 和 Base URL
在把那段只读分析指令贴进 Claude Code 之前,先花两分钟把通道准备好。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册账号,进控制台创建一把 API Key。创建的时候给它起个能认出来的名字,比如claude-code-scan,方便以后区分不同用途的 Key。
创建完成后你会拿到两样东西:一把以sk-开头的 Key,和一个 Base URL。Base URL 填https://taotoken.net/api,注意结尾不要多加/v1或者斜杠,Claude Code 和 Codex 都会自己拼接路径。Key 只显示一次,复制下来先存到安全的地方,后面配置要用。
如果你用的是 Claude Code,配置写在settings.json;如果用的是 Codex,配置写在config.toml。两个文件的路径和字段名不一样,下面分开说。这里不需要你懂什么网络原理,只需要把两个值填对位置就行。
注意:Key 不要提交到 Git 仓库,也不要贴在公开的 issue 里。建议放在环境变量或者本地配置文件,并且确认该文件在
.gitignore里。
3. 可复制配置:settings.json 与 config.toml 怎么填
3.1 Claude Code 的 settings.json
Claude Code 读取配置的位置通常在用户目录下的.claude/settings.json,你也可以在项目根目录放一份项目级配置。打开文件,把模型通道相关的字段改成下面这样:
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你创建的那把Key" } }如果你之前已经配过别的字段,只改ANTHROPIC_BASE_URL和ANTHROPIC_API_KEY这两项,其他保持原样。改完保存,重启 Claude Code 让配置生效。验证是否读到了配置,可以在 Claude Code 里问一句“你现在用的 Base URL 是什么”,它应该能反映出你填的地址。
3.2 Codex 的 config.toml
Codex 的配置一般在~/.codex/config.toml。用编辑器打开,加入或修改模型提供方这一段:
model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"然后在你的 shell 环境里导出 Key:
export TAOTOKEN_API_KEY="sk-你创建的那把Key"如果你用的是 Windows PowerShell,对应写成:
$env:TAOTOKEN_API_KEY="sk-你创建的那把Key"保存后重启 Codex。env_key这个字段的意思是让 Codex 去环境变量里找 Key,而不是把 Key 明文写在配置文件里,这样更安全一些。
3.3 两个配置的对照
| 项目 | Claude Code | Codex |
|---|---|---|
| 配置文件 | .claude/settings.json | ~/.codex/config.toml |
| Base URL 字段 | ANTHROPIC_BASE_URL | base_url |
| Key 字段 | ANTHROPIC_API_KEY | env_key指向的环境变量 |
| 生效方式 | 重启 Claude Code | 重启 Codex |
配置改完之后,先别急着跑三步扫描。用一条最简单的请求确认通道通了,再进入正式流程。
4. 验证请求:先跑一条最小请求确认通道
在 Claude Code 里输入一句最简单的指令,比如“用一句话说明当前目录下有哪些文件类型”。如果它能正常返回,说明 Base URL 和 Key 都生效了。如果报 401,多半是 Key 复制错了或者多了空格;如果报连接错误,检查 Base URL 是不是写成了https://taotoken.net/api/带了多余斜杠。
Codex 这边可以用一条短命令验证:
codex "列出当前目录的文件数量"返回正常就说明通道没问题。这一步看起来简单,但能帮你把配置问题和模型问题分开——如果最小请求都失败,那后面三步扫描肯定也跑不通,先解决通道再往下走。
通道确认之后,就可以进入正式的三步玩法了。下面每一步我都给出可以直接复制的指令,以及它大概会消耗多少上下文、你该关注什么结果。
5. 三步扫描:从只读分析到落地 5-10 个 Skills
5.1 第一步:只读扫描桌面与常用项目目录
把下面这段完整指令贴进 Claude Code 或 Codex:
请扫描我的桌面、下载目录、文档目录和常用项目目录,先只做只读分析,不要修改任何文件。 请你完成三件事: 1. 列出 10 件你根据我的电脑内容判断出可以长期帮我做的事情。 2. 根据这些文件和项目,判断我是一个什么样的人、主要做什么工作、有哪些重复任务。 3. 给我设计一个长期协作计划,并把适合沉淀的 5-10 个工作流整理成 Skills 方案。 要求: - 不要读取或输出任何密钥、账号、隐私内容。 - 不要删除、移动、修改任何文件。 - 先给我分析报告,再给我可执行计划。 - 输出要具体,不要泛泛而谈。这一步的关键词是“只读”。指令里明确写了不要修改任何文件,所以它只会读目录结构、文件头和部分内容来做判断。扫描范围建议先限定在桌面、下载、文档和两三个常用项目目录,不要一上来就扫整个磁盘,否则上下文会爆掉,请求也会变慢。
跑完之后你会拿到一份分析报告。报告里通常会提到你反复出现的文件类型、项目命名习惯、以及它认为你在做的几类工作。这时候不要急着让它生成 Skills,先看第二步。
5.2 第二步:让它判断你是谁、在做什么
接着上一步的上下文,继续输入:
根据你刚才看到的内容,判断一下我是一个什么样的人?我主要在做什么工作?我有哪些长期目标和重复任务?这一步会消耗比较多的上下文,因为它要把第一步读到的内容重新过一遍。这也是为什么通道要提前固定好——如果中途 Key 失效或者 Base URL 变了,这一步就得从头再来。
它的回答可能会把你归类成内容创作者、独立开发者、技术型运营,或者同时做内容和交付的人。重点不是它给你贴什么标签,而是它指出的“重复任务”列表。这些重复任务就是后面 Skills 的原材料。
5.3 第三步:把重复工作流沉淀成 5-10 个 Skills
最关键的一步。继续输入:
请把上面最适合自动化的 5 个工作流,做成本地 Skills。每个 Skill 都要包含触发场景、执行步骤、注意事项和验收标准。它会给每个 Skill 定义四样东西:什么时候触发、具体怎么做、有什么坑、怎么算做完。比如一个“公众号流程”Skill,触发场景可能是你说“按我的公众号流程处理一下”,执行步骤包括改写语气、保留链接、加粗重点,验收标准是输出格式符合你之前的习惯。
落地之后,这些 Skills 存在本地,每次调用都走同一条模型通道。你不需要为每个 Skill 单独配 Key,也不需要每次重新解释背景。说出触发句,它就知道该走哪套流程。
提示:第一次生成的 Skills 不一定完全贴合你的习惯。跑几次之后,把不满意的地方反馈给它,让它调整触发场景和验收标准,迭代两三轮就顺了。
6. 本篇常见错排查
报 401 或鉴权失败:先检查 Key 有没有复制完整,前后有没有空格。Claude Code 看ANTHROPIC_API_KEY,Codex 看env_key指向的环境变量是否真的导出了。在终端里echo $TAOTOKEN_API_KEY确认一下。
报连接超时或 404:Base URL 写成https://taotoken.net/api,不要加/v1,不要加结尾斜杠。Claude Code 和 Codex 会自己拼接具体路径,你多写一段反而会 404。
扫描到一半上下文超限:把扫描范围缩小。先只扫桌面和一个项目目录,跑通之后再逐步加目录。一次性扫太多文件,上下文长度会超出模型窗口,请求会被截断。
Skills 生成得很泛:在第三步的指令里加一句“每个 Skill 必须给出一个具体的触发句示例和一个可检查的验收标准”。泛泛而谈通常是因为验收标准没写清楚,它不知道做到什么程度算完成。
改了配置但没生效:Claude Code 和 Codex 都需要重启才会重新读配置文件。改完保存后完全退出再打开,不要只关窗口。
Codex 找不到 config.toml:确认路径是~/.codex/config.toml,如果目录不存在就手动创建。Windows 下~对应你的用户目录,比如C:\Users\你的用户名\.codex\config.toml。
7. 通道固定之后,Skill 调用才真正连贯
三步扫描跑完,你手里应该有一份分析报告和 5-10 个本地 Skills。这时候再回头看,真正让这套流程跑顺的不是某一条指令写得多好,而是模型通道从头到尾没变过。扫描、判断、生成 Skills、后续每次触发 Skill,全部走同一个 Base URL 和同一把 Key。
如果你还没配通道,现在就可以打开 https://taotoken.net/api-keys 创建 Key,然后按第 3 节的配置填进 Claude Code 或 Codex。配好之后回到第 5 节,把那段只读扫描指令贴进去,按顺序跑完三步。跑通之后,你可以直接在模型对话里试试触发句,看看 Skill 是不是按你定义的流程走。长期做编码和 Agent 的话,Coding Plan 那条线也值得看一下,通道固定之后切换成本很低。接入过程中遇到报错,先对照第 6 节排查,大部分问题都出在 Key 和 Base URL 这两个值上。