1. 为什么我要在 Roo Code 里折腾提示词配置Roo Code 是 VS Code 里的一款 AI 编程插件能读项目文件、改代码、跑终端命令适合想把 AI 真正嵌进本地开发流的人。但很多人装完就发现一个问题它默认的提示词太“通用”了生成的代码风格飘忽今天用 var明天用 const项目规范全靠每次对话里重复叮嘱。我一开始也是这样每次开新会话都要把技术栈、命名习惯、禁用写法重新说一遍效率极低。后来我把注意力放到 Roo Code 的提示词分层配置上同时把模型调用通道统一到 TaoToken用一套 Key 管住 DeepSeek 等模型的请求。这样做的直接好处是项目规则写在文件里模型通道写在配置里两边都不用在对话里反复交代。这篇就把我实际跑通的 settings.json 骨架、.clinerules 写法、以及验证调用链路的完整动作拆开讲你可以直接复制改。核心检索词先摆清楚Roo Code 提示词配置是什么——它是通过全局设置、项目级规则文件、模式定制三层把“你希望 AI 怎么干活”固化成可复用配置能做什么——让代码生成自动遵守团队规范、让不同模式Code/Architect/Ask/Debug各司其职适合谁——本地 AI 编程工具使用者、想统一多模型 Key 的开发者、被重复提示词折磨过的人。2. TaoToken 前置统一 Key 与 API 通道在动 Roo Code 配置之前先把模型通道准备好。TaoToken 在这里的角色是统一 API 通道你申请一个 Key就能在 Roo Code 里以 OpenAI 兼容格式调用 DeepSeek 等模型不用为每个模型单独维护一套地址和密钥。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 。操作顺序建议这样先注册账号进控制台创建 API Key拿到形如sk-xxxx的字符串。控制台地址带 deep linkhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite API Keys 管理页在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。如果你后面要长期跑编码任务或 Agent可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。注意Key 只存在本地配置文件或环境变量里不要提交到 Git 仓库。我习惯用.env加.gitignore的方式隔离。这里有个容易混淆的点TaoToken 的 API 基址填到 Roo Code 里时通常要带上/v1后缀取决于插件对 OpenAI 兼容接口的拼接方式。我实测下来Base URL 填https://taotoken.net/api/v1能正常走通 chat completions。如果你填了不带/v1的地址报 404先检查这一处。3. 可复制配置settings.json 骨架与 .clinerulesRoo Code 的配置分两块一块是 VS Code 的settings.json管模型通道和全局行为一块是项目根目录的.clinerules管项目级提示词规则。下面是我跑通的骨架。3.1 settings.json 模型通道配置在 VS Code 里按CtrlShiftP输入Preferences: Open User Settings (JSON)加入下面这段。注意这是用户级设置如果你只想对某个项目生效可以放到.vscode/settings.json。{ roo-cline.apiProvider: openai, roo-cline.openAiBaseUrl: https://taotoken.net/api/v1, roo-cline.openAiApiKey: sk-你的TaoToken密钥, roo-cline.openAiModelId: deepseek-chat, roo-cline.openAiModelInfo: { maxTokens: 8192, contextWindow: 65536, supportsImages: false, supportsPromptCache: false }, roo-cline.customInstructions: 始终用中文回答代码注释用中文禁止使用 var。 }几个参数说明apiProvider选openai是因为 TaoToken 走 OpenAI 兼容协议openAiModelId填你要用的模型名比如deepseek-chatmaxTokens和contextWindow按模型实际能力填填大了请求会被拒。customInstructions是全局提示词适合放跨项目通用的要求。3.2 .clinerules 项目级规则在项目根目录新建.clinerules文件无扩展名内容按你的技术栈写。下面是一个 React TypeScript 项目的例子# 项目技术栈 - 框架React 18 TypeScript 5 - 状态管理Zustand - 样式Tailwind CSS - 测试Vitest Testing Library # 代码规范 - 函数长度不得超过 50 行 - 所有导出函数必须写 JSDoc 注释 - 禁用 var统一用 const/let - 禁止使用 any必要时用 unknown 加类型守卫 - 组件文件用 PascalCase工具函数用 camelCase # 生成要求 - 新增组件时同时生成对应的 .test.tsx - 修改代码时先说明改动点再给 diff这个文件会被 Roo Code 自动读取并注入到系统提示词里。我试过在对话里故意让它写一个超过 50 行的函数它会主动拆分成多个小函数说明规则确实生效了。3.3 模式定制提示词Roo Code 有 Code、Architect、Ask、Debug 等模式每个模式可以单独配提示词。在设置界面找到Mode-Specific Custom Instructions给不同模式写不同规则。比如 Debug 模式你是一个故障排查专家。收到报错时 1. 先复述错误信息确认理解无误 2. 列出 2-3 个最可能的原因按概率排序 3. 对每个原因给出验证命令 4. 不要直接改代码先让我确认原因Architect 模式则强调先出架构图和数据流不写具体实现。这样切模式就等于切“人格”比每次在对话里重新描述省事得多。4. 验证请求确认调用链路走通配置写完必须验证否则你不知道是 Key 错了、地址错了还是模型名错了。我一般分两步走。第一步用 curl 直接打 TaoToken 的接口排除 Roo Code 插件本身的干扰curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoToken密钥 \ -d { model: deepseek-chat, messages: [{role: user, content: 用一句话说明什么是提示词配置}], max_tokens: 100 }如果返回 JSON 里有choices[0].message.content说明 Key 和通道都没问题。如果返回 401检查 Key 是否复制完整返回 404检查地址是否带/v1返回 400 且提示 model 不存在检查模型名拼写。第二步回到 Roo Code 里发一条测试消息。我习惯用这个提示词“读取当前项目的 .clinerules告诉我里面定义了哪些代码规范。” 如果它能准确列出你写的规则说明项目级提示词注入成功如果它说找不到文件检查.clinerules是否在项目根目录、文件名有没有拼错。成功的结果长这样它列出“函数不超过 50 行、禁用 var、必须写 JSDoc”等条目并且后续生成代码时确实遵守。到这一步提示词配置和调用链路就都验证完了。5. 本篇常见错排查配置过程中我踩过的坑集中在这几类你对照排查。报错 401 Unauthorized九成是 Key 问题。检查settings.json里openAiApiKey有没有多余空格或者 Key 是否已在控制台被删除。另外注意别把 Key 写进.clinerules那个文件是提示词规则不解析密钥。报错 404 Not FoundBase URL 拼接问题。TaoToken 的 API 根是https://taotoken.net/api但 OpenAI 兼容接口在/v1下。Roo Code 有些版本会自动补/v1有些不会。我的做法是显式写https://taotoken.net/api/v1然后观察请求日志确认最终 URL。模型不遵守 .clinerules先确认文件在项目根目录且无扩展名。其次规则别写太长太抽象像“写高质量代码”这种它没法执行要写成“函数不超过 50 行”这种可判定的。最后检查是不是在 Ask 模式下测试的Ask 模式偏问答不一定触发代码生成规则。上下文窗口报超限contextWindow填太大实际模型没那么大。DeepSeek 系列一般填 65536 比较稳。如果你不确定先填小一点跑通再调。切换模型后配置失效Roo Code 的模型配置是按 provider 存的你换了openAiModelId但没改openAiBaseUrl可能还在打旧地址。改完配置后重启 VS Code 窗口Developer: Reload Window再测。6. 把通道和提示词分开管后面省事我现在的工作流是TaoToken 管通道和 Key.clinerules管项目规则settings.json管全局偏好三者互不干扰。换项目时只改.clinerules换模型时只改settings.json里的模型名Key 始终是同一个。这样比在每个项目里重复配 Key、每次对话重复说规范要清爽得多。如果你主要做长期编码或 Agent 任务可以了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。想直接在网页里验证模型输出用模型对话https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 配置卡住时翻文档比瞎试快。Claude Code 相关接入看 https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecode-anthropicutm_campaignrewrite 。最后留一个我常用的调试习惯在.clinerules末尾加一行“每次生成代码后用一句话说明你遵守了哪条规则”。这样你能直观看到提示词有没有被吃进去比猜要靠谱。
