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

# Roo Code 接入 RuAPI：用 Claude、DeepSeek、GPT 写代码

> 在 VS Code 里把 Roo Code 接到 RuAPI 的详细步骤：Claude 走 Anthropic 提供商（有提示缓存），DeepSeek、GPT、Gemini 走 OpenAI Compatible，每个模式用自己的配置。不用 VPN，用 USDT 付款。

[Roo Code](https://roocode.com) 是 VS Code 里的编程智能体：能跨多个文件写代码、改代码，运行命令，有「架构师」「写代码」「调试」等多种模式。它用哪个模型，取决于你配置的提供商。RuAPI 用一个密钥就能调用 Claude、GPT、Gemini、DeepSeek、GLM、Qwen 和 Kimi，在俄罗斯不用 VPN 也能用。余额用 USDT 充值，不需要境外银行发行的卡。

## 选哪种接法

| 哪些模型 | Roo Code 里的 API Provider | 地址 | 原因 |
| - | - | - | - |
| Claude：`claude-opus-5-5`、`claude-sonnet-5-5`、`claude-haiku-5-5` | **Anthropic** | `https://www.ruapi.ai` | 提示缓存生效：智能体每一步都会重复发送的上下文，价格至少便宜 10 倍 |
| DeepSeek、GPT、Gemini、GLM、Qwen、Kimi 等其他模型 | **OpenAI Compatible** | `https://www.ruapi.ai/v1` | 一个地址接所有其他模型 |

<Warning>
  Claude 也可以走 **OpenAI Compatible**，但这样请求不走缓存，长任务会贵好几倍。Claude 请选 **Anthropic**。
</Warning>

Roo Code 把连接设置存在「配置档案」（configuration profile）里。建议建两个档案，比如 `RuAPI Claude` 和 `RuAPI DeepSeek`，在聊天里直接切换。

## 准备工作

<Steps>
  <Step title="RuAPI 密钥">
    在 [www.ruapi.ai](https://www.ruapi.ai/?utm_source=docs\&utm_campaign=zh-roo-code) 注册、充值（[充值方法](/zh/topup)），然后打开控制台 → **令牌管理**，点击 **添加令牌**。密钥以 `sk-` 开头。
  </Step>

  <Step title="最新版 Roo Code">
    在 VS Code 扩展市场搜索「Roo Code」安装，或更新到最新版。
  </Step>
</Steps>

<Tip>
  不需要银行卡：余额可以用 USDT 充值。还没有 USDT 的话，可以按[这篇教程](/zh/buy-usdt)用卢布购买。也支持境外银行发行的卡。
</Tip>

<Note>
  如果你的 Roo Code 界面是俄语的，字段名称会被翻译，但顺序和含义不变。
</Note>

## Claude 的配置档案（Anthropic 提供商）

<Steps>
  <Step title="新建档案">
    在侧边栏打开 Roo Code → ⚙️ → **Providers**。点档案列表旁边的 **+**，给档案起名，例如 `RuAPI Claude`。
  </Step>

  <Step title="填写字段">
    | 字段 | 填什么 |
    | - | - |
    | **API Provider** | `Anthropic` |
    | **Anthropic API Key** | 你的 RuAPI 密钥 `sk-...` |
    | **Use custom base URL** | 勾选，填 `https://www.ruapi.ai`——末尾**不带** `/v1` |
    | **Model** | 日常用 `claude-sonnet-5-5`，难的任务用 `claude-opus-5-5` |
  </Step>

  <Step title="保存">
    点 **Save**。
  </Step>
</Steps>

<Note>
  如果 **Model** 列表里没有你要的模型，请更新 Roo Code：Anthropic 的模型列表是写在扩展里的，随新版本增加。
</Note>

## DeepSeek、GPT 等模型的配置档案（OpenAI Compatible）

<Steps>
  <Step title="再建一个档案">
    ⚙️ → **Providers** → **+**，起名，例如 `RuAPI DeepSeek`。
  </Step>

  <Step title="填写字段">
    | 字段 | 填什么 |
    | - | - |
    | **API Provider** | `OpenAI Compatible` |
    | **Base URL** | `https://www.ruapi.ai/v1`——末尾**带** `/v1` |
    | **API Key** | 你的 RuAPI 密钥 `sk-...` |
    | **Model** | 准确的模型名，例如 `deepseek-flash`、`deepseek-v4-pro`、`gpt-5.4` 或 `glm-5.3` |
  </Step>

  <Step title="检查模型参数">
    在模型参数里：

    * **Image Support**：GPT、Gemini 和 `deepseek-flash` 打开；`deepseek-v4-pro` 不支持图片。
    * **Context Window**：模型的上下文窗口大小。不要填得比模型实际支持的大，否则长任务会报「超出上下文长度」的错误。
    * **Input Price / Output Price**：可以不填。如果填上[价格页](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=zh-roo-code)上的价格（每 100 万 token），Roo Code 会显示每个任务的大概花费。
  </Step>

  <Step title="保存">
    点 **Save**。
  </Step>
</Steps>

所有模型的准确名称见[价格页](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=zh-roo-code)。名称要一字不差，连同前缀和大小写（例如 `kimi/kimi-k3`）。

<Note>
  Roo Code 只能用支持工具调用（tool calling）的模型。RuAPI 的主要文本模型——Claude、GPT、Gemini、DeepSeek、GLM、Qwen、Kimi——都支持；生成图片和视频的模型不能用在 Roo Code 里。
</Note>

## 每个模式用自己的模型

Roo Code 有好几种模式：**Architect**（设计和规划）、**Code**（改代码）、**Ask**（问代码相关的问题）、**Debug**（找错误）、**Orchestrator**（把大任务拆成几部分）。每种模式可以用自己的配置档案。Roo Code 会记住你在每种模式下选的档案，也可以在设置的 **Prompts** 标签页里固定下来。

效果好的搭配：

| 模式 | 档案和模型 |
| - | - |
| Architect、Orchestrator | `RuAPI Claude`，用 `claude-opus-5-5` |
| Code、Debug | `RuAPI Claude` 用 `claude-sonnet-5-5`，或 `RuAPI DeepSeek` 用 `deepseek-flash` |
| Ask | `RuAPI DeepSeek`，用 `deepseek-flash`——便宜又快 |

## 第一个任务和检查

打开项目文件夹，选 **Code** 模式，写一个任务，例如：

```
给 config.ts 里的 parseConfig 函数加上错误处理
```

要确认请求确实走了 RuAPI，打开控制台 → **使用日志**：会出现带模型和费用的记录。如果 Claude 走的是 Anthropic，从第二、三步开始，记录详情里能看到有多少 token 来自缓存。

## 怎样不多花钱

* **换话题就开新任务。** 上下文每一步都在变长，而且每次都整段发送。
* **强模型只用在需要的地方。** 规划用 Opus，日常修改和提问用便宜的模型。
* **单独的密钥加额度上限。** 给 Roo Code 单独建一个密钥，在控制台 → **令牌管理**里设好额度上限。

## 常见问题

<AccordionGroup>
  <Accordion title="401 / Invalid API Key">
    * 确认粘贴的是完整的 RuAPI 密钥 `sk-...`，没有多余空格。
    * **Anthropic** 提供商的地址是 `https://www.ruapi.ai`，**不带** `/v1`；**OpenAI Compatible** 的地址是 `https://www.ruapi.ai/v1`，**带** `/v1`。
  </Accordion>

  <Accordion title="Model Not Found / 404 / 503">
    模型名必须和 RuAPI 上的一字不差，请从[价格页](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=zh-roo-code)复制。
  </Accordion>

  <Accordion title="400：「enabled」is not supported for this model">
    最新的 Claude 模型（Opus 4.7 及以后，以及所有第五代模型）只支持自适应思考（adaptive thinking）。如果旧版 Roo Code 给这类模型打开了带 token 预算的思考，请求会被拒绝。请更新 Roo Code，或者在模型设置里关掉思考。
  </Accordion>

  <Accordion title="工具调用出错">
    确认选的是文本模型，而不是生成图片或视频的模型。如果某个模型反复出错，换一个试试，例如 `claude-sonnet-5-5` 或 `deepseek-flash`。
  </Accordion>

  <Accordion title="400：The reasoning_content in the thinking mode must be passed back">
    DeepSeek 在思考模式下，如果任务做到一半换了模型或档案，可能出现这个错误。大多数情况下 RuAPI 会自动修正后重发请求。如果还报错，开一个新任务。
  </Accordion>
</AccordionGroup>

## 接下来

* [Cline](/zh/integrations/cline) 和 [Kilo Code](/zh/integrations/kilo-code)：类似的 VS Code 智能体。
* [Claude Code](/zh/integrations/claude-code)：Anthropic 官方的命令行智能体。
* [模型与价格](/zh/models)：有哪些模型可用。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.