> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moxus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Roo Code

> 在 Roo Code 中配置 Moxus AI OpenAI 兼容服务商。

Roo Code 是 VS Code 中的智能体插件，适合让模型读取项目文件、执行命令并修改代码。接入 Moxus AI 时，选择 OpenAI Compatible 或自定义 OpenAI 服务商。

## 配置值

| 项        | 值                                         |
| -------- | ----------------------------------------- |
| Provider | OpenAI Compatible / OpenAI Compatible API |
| Base URL | `https://moxus.ai/v1`                     |
| API Key  | `sk-你的密钥`                                 |
| Model ID | 在“模型广场”复制完整模型名称                           |

## 配置步骤

<Steps>
  <Step title="安装 Roo Code">
    在 VS Code 扩展市场安装 Roo Code。
  </Step>

  <Step title="打开 API 配置">
    进入 Roo Code 的 API Configuration 或模型设置页面。
  </Step>

  <Step title="选择 OpenAI 兼容服务商">
    Provider 选择 OpenAI Compatible 或自定义 OpenAI。
  </Step>

  <Step title="填写接口信息">
    Base URL 填写 `https://moxus.ai/v1`，API Key 填写 Moxus AI 的 `sk-` 密钥。
  </Step>

  <Step title="填写模型名称">
    Model ID 使用“模型广场”中的完整模型名称。
  </Step>
</Steps>

## 使用建议

* 首次测试先使用 Ask 或只读任务，确认接口和模型可用。
* 允许插件执行命令前，先看清它要运行的命令。
* 为 Roo Code 单独创建 API 密钥，并设置额度上限。
* 跨文件修改会消耗更多上下文，建议明确任务范围。

<Warning>
  Roo Code 可能读取文件、运行命令或修改代码。只在可信项目中使用，并谨慎授予自动执行权限。
</Warning>

## 常见问题

<AccordionGroup>
  <Accordion title="应该选 OpenAI 还是 OpenAI Compatible？">
    优先选择 OpenAI Compatible 或自定义 OpenAI。Base URL 填 `https://moxus.ai/v1`。
  </Accordion>

  <Accordion title="模型支持工具调用吗？">
    取决于你选择的模型。需要工具调用或复杂代码编辑时，请在“模型广场”选择对应能力更强的模型。
  </Accordion>

  <Accordion title="插件请求很多怎么办？">
    减少自动审批，缩小文件范围，并给 Roo Code 使用的 API 密钥设置额度上限。
  </Accordion>
</AccordionGroup>

## 相关文档

* [API 密钥](/zh/platform/account-and-keys)
* [控制台与用量](/zh/platform/dashboard-and-usage)
