> ## 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.

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

> 把 RuAPI 作为自定义提供商（Custom provider）接入 Kilo Code 的详细步骤：DeepSeek、GPT、Gemini 等走 OpenAI 协议，Claude 走 Anthropic 协议。不用 VPN，用 USDT 付款。

[Kilo Code](https://kilo.ai) 是开源的编程智能体，可以在 VS Code、JetBrains 和终端里用：自己读改文件、运行命令。它默认让你登录 Kilo 账号、付钱给 Kilo，但也可以接自己的密钥。RuAPI 用一个密钥就能调用 Claude、GPT、Gemini、DeepSeek、GLM、Qwen 和 Kimi，在俄罗斯不用 VPN 也能用。余额用 USDT 充值，不需要境外银行发行的卡。

## 接入方式

在 Kilo Code 里，第三方服务是作为「自定义提供商」（**Custom provider**）接入的。接 RuAPI 建议建两个：

| 提供商 | Provider API | Base URL | 哪些模型 |
| - | - | - | - |
| `ruapi` | **OpenAI Compatible** | `https://www.ruapi.ai/v1` | DeepSeek、GPT、Gemini、GLM、Qwen、Kimi 等 |
| `ruapi-claude` | **Anthropic Messages** | `https://www.ruapi.ai/v1` | Claude：`claude-opus-5-5`、`claude-sonnet-5-5`、`claude-haiku-5-5` |

Claude 最好作为第二个提供商、走 Anthropic 协议接入：这样请求是 Claude 的原生格式，提示缓存会生效。Claude 走 OpenAI Compatible 也能用，但没有缓存，长任务会贵好几倍。

<Note>
  和 Cline、Roo Code 不同，这里两个提供商的地址末尾都**带** `/v1`：Kilo 会自己在后面补上需要的路径。
</Note>

## 准备工作

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

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

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

## DeepSeek、GPT 等模型的提供商

<Steps>
  <Step title="打开提供商设置">
    在侧边栏打开 Kilo Code → ⚙️（**Settings**）→ **Providers** 标签页。滚到最下面，点 **Custom provider**。
  </Step>

  <Step title="填写弹窗">
    | 字段 | 填什么 |
    | - | - |
    | **Provider ID** | `ruapi` |
    | **Display name** | `RuAPI` |
    | **Provider API** | `OpenAI Compatible` |
    | **Base URL** | `https://www.ruapi.ai/v1` |
    | **API key** | 你的 RuAPI 密钥 `sk-...` |
    | **Models** | 填好地址和密钥后，Kilo 会自动加载模型列表，勾选需要的，例如 `deepseek-flash`、`deepseek-v4-pro`、`gpt-5.4`、`glm-5.3` |
  </Step>

  <Step title="保存">
    点 **Submit**。RuAPI 的模型会出现在模型选择列表里。
  </Step>
</Steps>

如果模型列表没加载出来，检查地址和密钥后再点一次 **Fetch models**，或者手动填写模型名。准确的模型名见[价格页](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=zh-kilo-code)，要一字不差，连同前缀和大小写（例如 `kimi/kimi-k3`）。

## Claude 的提供商

<Steps>
  <Step title="再加一个提供商">
    ⚙️ → **Providers** → **Custom provider**。
  </Step>

  <Step title="填写弹窗">
    | 字段 | 填什么 |
    | - | - |
    | **Provider ID** | `ruapi-claude` |
    | **Display name** | `RuAPI Claude` |
    | **Provider API** | `Anthropic Messages` |
    | **Base URL** | `https://www.ruapi.ai/v1` |
    | **API key** | 同一个 RuAPI 密钥 `sk-...` |
    | **Models** | `claude-sonnet-5-5`、`claude-opus-5-5`、`claude-haiku-5-5`——列表没加载出来就手动填 |
  </Step>

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

## 选模型和第一个任务

在 Kilo Code 的聊天窗口里打开模型列表，选择例如 **RuAPI Claude → claude-sonnet-5-5** 或 **RuAPI → deepseek-flash**。然后打开项目文件夹，写一个任务：

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

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

选哪个模型：

| 任务 | 模型 |
| - | - |
| 难的任务、做设计 | `claude-opus-5-5` |
| 日常写代码 | `claude-sonnet-5-5` |
| 大量日常修改、花钱少 | `deepseek-flash`（DeepSeek 会自动缓存） |

## 怎样不多花钱

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

## 常见问题

<AccordionGroup>
  <Accordion title="401 / 密钥不对">
    确认粘贴的是完整的 RuAPI 密钥 `sk-...`，没有多余空格，**Base URL** 是 `https://www.ruapi.ai/v1`。
  </Accordion>

  <Accordion title="模型列表加载不出来">
    检查地址和密钥后点 **Fetch models**。还不行就手动填模型名，从[价格页](https://www.ruapi.ai/pricing?utm_source=docs\&utm_campaign=zh-kilo-code)复制。
  </Accordion>

  <Accordion title="找不到模型（404 或 503）">
    模型名必须和 RuAPI 上的一字不差。Claude 模型在 `RuAPI Claude` 提供商里选，其他模型在 `RuAPI` 里选。
  </Accordion>

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

## 接下来

* [Cline](/zh/integrations/cline) 和 [Roo Code](/zh/integrations/roo-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.