1. Roo Code 提示词配置到底在配什么
Roo Code 里的提示词（Prompts）配置，说白了就是给 AI 编程助手写"岗位说明书"。你告诉它在这个模式下该扮演什么角色、能用哪些工具、遇到什么情况该走什么流程，它才会按你的预期干活。很多人装了 Roo Code 之后直接开写，结果发现 AI 一会儿帮你改文件、一会儿又只肯聊天，问题基本都出在提示词配置项没对齐。
这套配置项适合谁？适合已经在用 Roo Code 做日常开发、但觉得 AI 输出不稳定、想通过配置把行为固定下来的同学。也适合正在跟 AI 编程共学课程、需要一套可复制配置骨架的人。Roo Code 的提示词由三块组成：全局的语言与自定义规则、不同模式下的提示词、以及支持性提示词。其中"不同模式下的提示词"是核心，Code、Architect、Ask、Debug 四种模式各自有角色定义、API 配置、可用工具、模式特定自定义指令四个配置项。
我这次要解决的具体问题是：把这套提示词配置落到settings.json里，同时把模型通道统一接到 TaoToken，避免每个模式各配一个 Key、改起来到处找。下面直接给可复制的骨架和接入步骤。
2. 用 TaoToken 统一 Key 与 API 通道
Roo Code 支持 OpenAI 兼容接口，所以接入 TaoToken 的思路很简单：把 Base URL 指向 TaoToken 的 API 地址，Key 用 TaoToken 生成的统一 Key，然后在 Roo Code 里按模式选择对应模型。这样 Code 模式用擅长写代码的模型，Architect 模式用擅长规划的模型，但底层走的是同一个 Key 和同一个通道，管理成本直接降下来。
TaoToken 的 API 地址是https://taotoken.net/api，注意这个地址不带任何查询参数。官网入口在https://taotoken.net/?utm_source=taotoken_aicg_blog_end，注册后在控制台生成 API Key 即可。控制台地址是https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite，模型对话入口在https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite。
注意：Roo Code 的 API Configuration 里，Provider 选 "OpenAI Compatible"，Base URL 填
https://taotoken.net/api，不要在后面加/v1之外的路径，也不要带 UTM 参数，否则请求会 404。
如果你后面要跑长期编码任务或者 Agent 流程，可以看下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite。接入文档在https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite，遇到字段对不上时优先查这里。
3. 可复制的 settings.json 骨架
Roo Code 的配置存在 VS Code 的 settings.json 里，键名以roo-cline开头。下面这份骨架覆盖了全局规则、四种模式的提示词和 API 配置，你可以直接粘进去再改模型名。
{ "roo-cline.customInstructions": "始终用中文回答。代码注释用中文。修改文件前先说明改动点。", "roo-cline.modeApiConfigs": { "code": { "apiProvider": "openai", "openAiBaseUrl": "https://taotoken.net/api", "openAiApiKey": "sk-你的TaoToken密钥", "openAiModelId": "claude-sonnet-4-20250514" }, "architect": { "apiProvider": "openai", "openAiBaseUrl": "https://taotoken.net/api", "openAiApiKey": "sk-你的TaoToken密钥", "openAiModelId": "claude-sonnet-4-20250514" }, "ask": { "apiProvider": "openai", "openAiBaseUrl": "https://taotoken.net/api", "openAiApiKey": "sk-你的TaoToken密钥", "openAiModelId": "claude-sonnet-4-20250514" }, "debug": { "apiProvider": "openai", "openAiBaseUrl": "https://taotoken.net/api", "openAiApiKey": "sk-你的TaoToken密钥", "openAiModelId": "claude-sonnet-4-20250514" } }, "roo-cline.modeRoleDefinitions": { "code": "你是一名资深全栈工程师，负责直接编写和修改代码。", "architect": "你是一名系统架构师，负责收集信息并输出详细实施计划，不直接改业务代码。", "ask": "你是一名技术顾问，只回答问题，不修改任何文件。", "debug": "你是一名调试专家，负责定位问题根因并给出修复方案。" }, "roo-cline.modeSpecificCustomInstructions": { "architect": "先使用 read_file 或 search_files 收集上下文，再输出 markdown 计划。计划写入 docs/plan.md。", "code": "改动前先列出受影响文件，改完给出验证命令。" } }几个关键点说明。modeApiConfigs里每个模式都指向同一个 Base URL 和 Key，模型 ID 可以按模式换，比如 Architect 用推理强的、Code 用写码快的。modeRoleDefinitions对应角色定义，modeSpecificCustomInstructions对应模式特定自定义指令。可用工具那一栏在默认四种模式下不允许改，所以骨架里没写，这是 Roo Code 的限制，不是配置漏了。
提示：如果你想把 Architect 的指令单独放文件里，可以在工作区根目录建
.clinerules-architect，内容写模式特定自定义指令，Roo Code 会自动加载。
4. 验证配置是否生效
改完 settings.json 必须重启 Roo Code，否则旧配置还在内存里。重启方式：VS Code 里按Ctrl+Shift+P，输入Developer: Reload Window回车。窗口重载后，打开 Roo Code 面板，切到 Code 模式，发一条提示词确认模型正常响应：
请用一句话说明你当前扮演的角色，并列出你可以使用的工具类型。如果配置生效，返回内容应该包含"资深全栈工程师"这类角色描述，并且能说出读取文件、编辑文件、执行命令等工具。如果返回的是默认的通用回答，说明modeRoleDefinitions没被读到，检查键名拼写和 JSON 是否合法。
再验证 API 通道是否走通。在 Code 模式下发一条需要读文件的指令：
读取当前目录下的 package.json，告诉我项目名称和依赖数量。正常情况它会调用 read_file 工具，返回文件内容并总结。如果报 401，说明 Key 不对；如果报 404，说明 Base URL 写错了，检查是不是多加了/v1或 UTM 参数。如果报模型不存在，说明openAiModelId填的模型名 TaoToken 不支持，去模型对话页面确认可用模型名。
5. 本篇常见错排查
配置改了没反应：九成是没重启窗口。Roo Code 读的是启动时的配置，改完必须 Reload Window。另外确认你改的是用户级还是工作区级 settings.json，工作区级会覆盖用户级。
JSON 语法错误导致整份配置失效：VS Code 对 settings.json 的容错有限，多一个逗号整段就不生效。建议改完看编辑器有没有红色波浪线，或者用Ctrl+Shift+P跑Preferences: Open Settings (JSON)确认。
Base URL 带错路径：TaoToken 的 API 地址就是https://taotoken.net/api，Roo Code 的 OpenAI Compatible 模式会自动补/v1/chat/completions。如果你手动写成https://taotoken.net/api/v1，就会变成/api/v1/v1/...，直接 404。
模式特定指令不生效：检查键名是modeSpecificCustomInstructions而不是customInstructions，后者是全局的。另外.clinerules-architect文件名大小写敏感，必须是全小写加连字符。
支持性提示词按钮点了没反应：Enhance Prompt、Explain Code 这些按钮依赖当前模式的 API 配置。如果当前模式没配 Key，按钮会静默失败。切到 Code 模式再试。
切换模式后模型变了：这是预期行为，因为每个模式可以配不同模型。如果你希望所有模式用同一个模型，把modeApiConfigs里四个模式的openAiModelId写成一样即可。
6. 把配置固定下来，后续少折腾
提示词配置这件事，配一次能省很多重复沟通。我的做法是把这份 settings.json 骨架存进 dotfiles 仓库，换机器时直接同步，Key 用环境变量注入而不是硬编码。Roo Code 支持在openAiApiKey里填${env:TAOTOKEN_API_KEY}这种形式，这样配置文件可以公开，Key 留在本地环境变量里。
如果你还在选模型阶段，可以先去模型对话页面https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=models&utm_campaign=rewrite试几条提示词，确认哪个模型在你的场景下输出最稳，再把模型 ID 填进配置。接入细节对不上时查接入文档https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite，里面有完整的字段说明和示例请求。长期跑编码任务的话，Coding Plan 页面https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite有对应的额度方案，按自己的调用量选就行。
