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_sourcetaotoken_aicg_blog_end注册后在控制台生成 API Key 即可。控制台地址是https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite模型对话入口在https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite。注意Roo Code 的 API Configuration 里Provider 选 OpenAI CompatibleBase URL 填https://taotoken.net/api不要在后面加/v1之外的路径也不要带 UTM 参数否则请求会 404。如果你后面要跑长期编码任务或者 Agent 流程可以看下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite。接入文档在https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite遇到字段对不上时优先查这里。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 里按CtrlShiftP输入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 的容错有限多一个逗号整段就不生效。建议改完看编辑器有没有红色波浪线或者用CtrlShiftP跑Preferences: Open Settings (JSON)确认。Base URL 带错路径TaoToken 的 API 地址就是https://taotoken.net/apiRoo 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_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite试几条提示词确认哪个模型在你的场景下输出最稳再把模型 ID 填进配置。接入细节对不上时查接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite里面有完整的字段说明和示例请求。长期跑编码任务的话Coding Plan 页面https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite有对应的额度方案按自己的调用量选就行。