1. 为什么要在 Claude Code 和 Trae 里装 skills
如果你同时用 Claude Code 和 Trae 写代码,大概率会遇到一个很别扭的情况:两个工具各自维护一套技能(skills),配置分散、Key 也分散,换台机器就得重新配一遍。skills 本质上是给 AI 编程助手挂载的「能力插件」,比如前端设计规范、系统化调试流程、代码审查清单,装上之后模型在对应场景会自动调用这些能力,而不是每次靠你在对话里反复描述。
问题在于,Claude Code 走的是.claude/skills目录加settings.json,Trae 走的是自己的技能与命令面板加config.toml,两边的安装命令、目录结构、鉴权方式都不一样。更麻烦的是,skills 运行时要调用模型,如果你用的是官方通道,Key 和额度是分开算的,多工具切换时很容易乱。
这篇就聚焦一件事:用npx把 skills 装进 Claude Code 和 Trae,再把两个工具的模型调用统一指向 TaoToken 的 API 通道,用一份 Key 跑通。适合已经在用这两个工具、想把手动配置收敛成一套的人。下面所有命令和配置都可以直接复制,我会给出settings.json和config.toml的骨架,最后用一次真实调用验证配置是否生效。
2. 前置准备:TaoToken 统一 Key 与 npx 环境
在装 skills 之前,先把两样东西准备好:一个是能用的统一 Key,一个是能跑npx的 Node 环境。
TaoToken 在这里扮演的角色是「统一入口」——Claude Code 和 Trae 都通过它来调用模型,你只需要维护一份 API Key 和一个 base URL,不用在两个工具里分别填不同的厂商配置。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,注册后在控制台生成 Key。
具体操作路径是这样:登录后进入控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 创建一个新 Key,复制出来先存好。API 的基础地址是 https://taotoken.net/api ,注意这个地址后面不加任何查询参数,配置里直接写这个就行。
Node 环境方面,npx是随 npm 一起装的,只要你的 Node 版本在 16 以上基本都能用。验证一下:
node -v npm -v npx -v三条命令都能输出版本号就说明环境没问题。如果npx -v报错,说明 npm 装得不完整,重装一次 Node LTS 版本即可。
提示:skills 的安装命令会临时下载
skills这个包,第一次执行时会问你Ok to proceed? (y),输入y回车就行。这不是报错,是 npx 在确认是否安装临时依赖。
3. 可复制配置:settings.json 与 config.toml 骨架
这一节是核心,两个工具的配置文件我都给出完整骨架,你按自己的 Key 替换即可。
3.1 Claude Code 的 settings.json
Claude Code 的配置一般放在用户目录下的.claude/settings.json,项目级的话放在项目根目录的.claude/settings.json。统一走 TaoToken 通道的骨架如下:
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "你的_TaoToken_Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" }, "permissions": { "allow": [ "Bash(npx skills:*)", "Read(.claude/skills/**)" ] } }这里三个环境变量的作用分别是:ANTHROPIC_BASE_URL把请求指向 TaoToken 的 API 通道,ANTHROPIC_AUTH_TOKEN填你刚才生成的 Key,ANTHROPIC_MODEL指定默认模型。permissions.allow里放行npx skills命令和 skills 目录读取,避免 Claude Code 每次执行都弹权限确认。
3.2 Trae 的 config.toml
Trae 的配置走 TOML 格式,通常在用户配置目录下的config.toml。骨架如下:
[model] provider = "anthropic" base_url = "https://taotoken.net/api" api_key = "你的_TaoToken_Key" model = "claude-sonnet-4-20250514" [skills] enabled = true install_dir = ".trae/skills" auto_load = true[model]段负责把 Trae 的模型调用指向 TaoToken,[skills]段开启技能加载并指定安装目录。auto_load = true表示启动时自动扫描 skills 目录,省得每次手动刷新。
注意:两个配置文件里的 Key 是同一份,这就是「统一 Key」的意义——换 Key 时只改一处逻辑,两个工具同步生效。实际维护时建议把 Key 放在环境变量里,配置文件里用占位符引用,避免明文提交到仓库。
4. 用 npx 安装 skills 并验证调用
配置写好后,开始装 skills。Claude Code 和 Trae 的安装命令结构类似,都是npx skills add <owner/repo@skill> --agent <工具名>,区别在--agent参数。
4.1 先查找 skill
以安装一个前端设计相关的 skill 为例,先搜索:
npx skills find frontend第一次执行会提示安装skills包,输入y回车。搜索完成后会列出匹配的仓库和 skill 名称,找到你要的那个,记下完整的owner/repo@skill标识。
4.2 给 Trae 安装
npx skills add fcakyon/claude-codex-settings@anthropic-frontend-design --agent trae-cn执行完成后,Trae 的 skills 目录下会生成对应文件夹,打开 Trae 的设置面板,在「技能与命令」里能看到新装的 skill 已经同步进来。
4.3 给 Claude Code 安装
npx skills add https://github.com/obra/superpowers --skill systematic-debugging --agent claude-code装完后在.claude/skills目录下会生成systematic-debugging文件夹,重启 VS Code 后 Claude Code 就能识别到这个 skill。
4.4 验证配置是否生效
装完 skill 只是第一步,真正要验证的是「skill 能不能通过 TaoToken 通道正常调用模型」。最直接的办法是在 Claude Code 里触发一次 skill 调用,观察请求是否走通。
你也可以先用一个最小请求验证 API 通道本身:
curl https://taotoken.net/api/v1/messages \ -H "x-api-key: 你的_TaoToken_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字段和模型回复,说明 Key 和 base URL 都对。接着在 Claude Code 里让模型执行一个需要 skill 的任务,比如触发systematic-debugging,看它是否按 skill 定义的流程走。Trae 那边同理,在对话里调用刚装的 skill,观察是否正常返回。
想单独测试模型对话是否通畅,也可以直接用模型对话页面 https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 发一条消息,确认通道没问题再回到工具里排查。
5. 本篇常见错误排查
装 skills 和配通道的过程中,有几个坑几乎每次都会遇到,我按出现频率排一下。
第一个:npx skills卡在Ok to proceed?不动。这不是卡死,是在等你输入。直接敲y回车。如果你在 CI 或脚本里跑,加--yes参数跳过确认。
第二个:装完 skill 但工具里看不到。Claude Code 需要重启 VS Code 才会重新扫描.claude/skills;Trae 需要在设置里手动刷新一次技能列表。另外确认--agent参数写对了,trae-cn和claude-code不能混用,装错 agent 目录就不会被识别。
第三个:调用时报 401 或鉴权失败。九成是 Key 填错或者 base URL 写成了带路径的形式。ANTHROPIC_BASE_URL和base_url都只写到https://taotoken.net/api,不要在后面拼/v1/messages,SDK 会自己补。Key 复制时注意别带前后空格。
第四个:模型名不识别。ANTHROPIC_MODEL和model字段要填 TaoToken 支持的模型标识,填错会返回模型不存在。不确定的话先用模型对话页面试一下哪个模型名能用,再写进配置。
第五个:skills 装了但模型不调用。检查auto_load是否为true,以及 skill 目录是否在配置的install_dir下。有些 skill 需要特定触发词才会激活,不是装上就自动生效,得在对话里给出对应场景。
6. 把统一 Key 用顺之后的下一步
配置跑通之后,日常维护其实很轻:Key 只在 TaoToken 控制台换,两个工具的配置文件不用动;skills 用npx skills add增量装,装错了直接删目录。真正省事的地方在于,Claude Code 和 Trae 共享同一条 API 通道,额度、模型、鉴权都是同一套,不用再对着两个后台分别充值和对账。
如果你后面要长期跑编码任务或者接 Agent 流程,可以看下 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,它更适合高频调用的场景。接入细节和参数说明都在接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 里,遇到配置对不上的时候翻一下比瞎试快。Claude Code 相关的专项说明在 ClaudeCodeAnthropic https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ,skills 和模型通道的配合方式那里写得更细。
最后留一个我自己的习惯:把两个配置文件里的 Key 换成环境变量引用,比如"ANTHROPIC_AUTH_TOKEN": "${TAOTOKEN_KEY}",这样配置文件可以放心进版本库,Key 只存在本机环境里。换机器时导出一下环境变量,skills 目录用npx skills add重装一遍,五分钟就能恢复整套环境。