Roo Code 是 VS Code 里的 AI 编程助手扩展，支持多种工作模式（写代码、架构设计、调试等）。它支持「OpenAI 兼容」提供方，可以接我们的接口。

KiloCode 和 RooCode 什么关系

KiloCode 是从 RooCode 分出来的分支，两者的配置方式基本一样。如果你用的是 KiloCode，那一页的说明同样适用。

安装

在 VS Code 扩展市场搜 Roo Code 安装。

配置

打开 Roo Code 的设置面板（面板顶部的齿轮图标）：

1. API 提供商（API Provider） → 选 OpenAI Compatible
2. Base URL → https://api.wxiai.com/v1
3. API Key → sk-你的APIKey
4. Model ID → grok-4.6

保存后回到对话面板开始用。

不要选它内置的 xAI / OpenAI 提供商

提供商列表里通常也有 xAI、OpenAI 这些选项——那些都是直连官方的，需要官方账号的 Key，不走我们。

必须选 OpenAI Compatible（OpenAI 兼容）。

⚠️ Base URL 要带 /v1

	填写内容
正确	https://api.wxiai.com/v1
错误	https://api.wxiai.com（少了 /v1）
错误	https://api.wxiai.com/v1/chat/completions（填太全）

Roo Code 会在你填的地址后面拼 /chat/completions。填到 /v1 为止。

判断方法见 Base URL 怎么填。

多个模式可以共用一套配置

Roo Code 的特色是多种工作模式（Code / Architect / Ask / Debug 等），每种模式可以单独指定模型。

配好一次之后，你可以在模式设置里给不同模式用不同的 Grok 模型：

• 日常写代码 → 用快一点的模型
• 架构设计 / 复杂调试 → 用推理能力强的模型

模型名都用 GET /v1/models 查到的值。

验证顺序

别一上来就让它改代码，分步验证：

① 普通对话能回  →  ② 能读文件  →  ③ 能改文件  →  ④ 多步任务

卡住时同时看两边：

• Roo Code 面板的报错
• https://api.wxiai.com 的调用日志

日志里没有请求 → 配置没生效（多半是 Base URL）。 日志里有请求但报错 → 看我们的错误信息。

长任务的两个建议

编程 Agent 会连续调用几十次，token 消耗比普通对话大得多——它每一轮都会把仓库文件、工具输出重新发一遍。

• 控制自动批准的范围：全自动跑长任务容易在一次错误里烧掉大量额度。建议只对读文件自动批准，写文件仍需确认。
• 盯住用量：在 https://api.wxiai.com 看消费记录。

常见报错

现象	原因	怎么办
401	Key 不对	重新复制，别带空格
404	Base URL 错了	确认是 https://api.wxiai.com/v1
model_not_found	模型名不对	用 GET /v1/models 查
对话正常但改不了文件	工具调用没通过	先只做对话，再逐项开权限
卡在「正在思考」很久	用了推理型模型 + 大上下文	换个更快的模型试

相关页

• Base URL 怎么填 —— 各工具填法对照
• KiloCode —— 同源的另一个插件
• Cursor —— 独立 IDE，配置方式不同