KodaCode（Koda）：用 RuAPI 密钥接入自己的 Claude、GPT 和 DeepSeek，无需 VPN 和境外银行卡
Koda 是俄罗斯的 AI 编程助手：有桌面应用 Koda Desktop、VS Code 和 JetBrains 插件，还有终端工具 Koda CLI。默认用的是它自家的 koda-base 和 koda-pro 模型，外部模型要扣套餐积分。除此之外，Koda 还能用你自己的密钥接入任何 OpenAI 兼容的模型，这类请求 Koda 不计费。填上地址 https://www.ruapi.ai/v1 和 RuAPI 密钥，就能把 Claude、GPT、Gemini 和 DeepSeek 加进模型列表，按 token 计费，用 USDT 付款。
更新于：
from openai import OpenAI
client = OpenAI(
api_key="sk-...",
base_url="https://www.ruapi.ai/v1",
)
resp = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)配置 Koda 之前，可以先在终端里测一下密钥（cURL 标签）：示例调用的是 deepseek-flash，注册后马上就能用。在 Koda 里，同样的值填进 Base URL（https://www.ruapi.ai/v1）和 API 密钥两栏，模型 ID 一栏填价格页上的模型 ID。
什么时候需要在 Koda 里用自己的密钥
外部模型的积分很快就用完。
Koda 里的 Claude、GPT 等外部模型按各自的系数扣 RC，免费套餐从第二个月起外部模型额度为零，付费的 Pro 套餐干脆不含外部模型额度，只能另买加量包（kodacode.ru/tariffs，2026-11-03）。用自己密钥接入的模型完全不扣 Koda 积分：费用只付给发密钥的那家（docs.kodacode.ru，2026-11-03）。
想用某个特定的模型，而不是列表里现成的。
Koda 提供哪些外部模型由 Koda 团队决定。走 RuAPI，可以按 ID 自己挑：复杂重构用 claude-sonnet-5-5 或 claude-opus-5-5，代码审查用 gpt-5.4，大批量的便宜修改用 deepseek-flash——同一个密钥可以在 Koda 里同时加好几个这样的连接。
想看清每次请求花了多少钱。
RC 是个约定单位，大约等于一次普通请求，而智能体完成一个任务通常要 10–15 次请求（docs.kodacode.ru，2026-11-03）。RuAPI 控制台的「使用日志」会逐条列出每次请求用的模型、token 数和美元金额。余额用 USDT 充值，没有订阅。
怎么把 RuAPI 接到 Koda：3 步
按 Koda CLI 和 VS Code 插件 1.3.0 版（2026-10-30）核对。普通 Koda 账号可以添加自己的模型；企业版和 SaaS 账号只能用 Koda 托管的模型（docs.kodacode.ru，2026-11-03）。RuAPI 是独立服务，和 Koda 的开发公司没有关联：接入用的是 Koda 自带的「自定义模型」功能。Koda 的文档是俄语的，下面的界面名称按意思译成了中文。
注册 RuAPI 并充值
注册 www.ruapi.ai 可以用邮箱，也可以用 Google 或 Yandex 账号。充值用 USDT，5 USDT 起，从 TRC20、BEP20、TON、Polygon 里选一个网络；USDC 同样可以。USDT 可以用卢布通过 SBP 买，docs.ruapi.ai/zh/buy-usdt 有分步说明。境外银行的卡也能用来付款。
新账号通常自带的 $0.05 足够在 Koda 里测通连接：体验余额下能用 claude-haiku-5-5、deepseek-flash 和 gpt-6-luna，其他模型要等首次充值。
给 Koda 建一个密钥
控制台 →「令牌管理」→「添加令牌」。Koda 在智能体模式下会自己一个接一个地发请求，所以最好给密钥设预算：关掉「无限额度」，填一个金额。单独的密钥还能让你在「使用日志」里看清 Koda 自己花了多少。
在 Koda 里添加模型
- Koda Desktop：设置 →「模型」标签（登录 Koda 账号后才显示）。「模型名称」随便起，比如 RuAPI Sonnet 5.5。Base URL：把预填的 https://api.openai.com/v1 换成 https://www.ruapi.ai/v1。「API 密钥」填你的 sk-…。「模型标识」填价格页上的 ID，比如 claude-sonnet-5-5；Base URL 和密钥填好后，Koda 会自动列出可选模型。点「添加模型」。
- Koda CLI：输入 /model，在列表最下面选「[+] Add custom model (OpenAI-compatible)」（添加自定义的 OpenAI 兼容模型）。填 Name（名称）、Model ID（模型 ID）、Base URL（https://www.ruapi.ai/v1）和 API key（密钥）。CLI 会用 /models 核对 ID，并把连接存进 ~/.config/koda/credentials.json；在 /model 里它会带上 (custom) 标记。按文档的说法，Koda Desktop 的模型也是通过 CLI 保存的。
- VS Code 和 JetBrains 插件：自己的模型写在 ~/.koda/config.yaml 里（Windows 是 %USERPROFILE%/.koda/config.yaml）。在 models 列表里加一条：name: RuAPI DeepSeek Flash、provider: openai、model: deepseek-flash、apiBase: https://www.ruapi.ai/v1、apiKey: sk-…、roles: [chat, edit, agent, plan]，再加 capabilities: [tool_use]。roles 明确写出来，模型就只用于聊天、编辑、智能体和规划，不会被拿去做代码补全；capabilities: [tool_use] 让它在智能体模式下能调用工具。原有的 Koda Models 那条保留，那是内置模型。
- Koda Desktop 和 CLI 里的「上下文大小（token）」一栏可以不填。RuAPI 的模型列表里不带窗口大小，所以不填时 Koda 按 200,000 token 算。deepseek-flash 和 claude-sonnet-5-5 的窗口是 1,000,000 token：智能体需要很长的历史就填大一点，否则留空即可——上限越小，Koda 越早压缩历史，每次请求也越便宜。
接入地址和密钥说明：docs.ruapi.ai/zh/quickstart · 工具调用：docs.ruapi.ai/zh/function-calling · 错误码：docs.ruapi.ai/zh/errors
Koda 里填什么
Koda Desktop → 设置 → 模型
Base URL：https://www.ruapi.ai/v1
API 密钥：sk-…
模型标识：claude-sonnet-5-5
Koda CLI → /model →「[+] Add custom model」
Base URL：https://www.ruapi.ai/v1
API key：sk-…
Model ID：deepseek-flash
插件 → ~/.koda/config.yaml
provider: openai
apiBase: https://www.ruapi.ai/v1
apiKey: sk-…
model: gpt-5.4
roles: [chat, edit, agent, plan]
capabilities: [tool_use]
付款
USDT / USDC，5 USDT 起
境外银行发行的卡
不用订阅
Koda 可用的模型价格
程序员最常选的几款模型（美元／100 万 token，照价格页的显示价）。RuAPI 余额只扣 Koda 实际发出和收到的 token，Koda 的积分一点也不扣。
| model | input $/M | output $/M |
|---|---|---|
| deepseek-flash | $0.17 读缓存 $0.0120 | $1.44 |
| gpt-5.4-mini | $0.90 读缓存 $0.0900 | $5.40 |
| claude-haiku-5-5 | $0.12 读缓存 $0.0120 >100K: $0.60 | $0.60 >100K: $3.00 |
| deepseek-v4-pro | $1.58 读缓存 $0.0600 | $4.75 |
| gpt-5.4 | $3.00 读缓存 $0.30 >272K: $6.00 | $18.00 >272K: $27.00 |
| claude-sonnet-5-5 | $2.40 读缓存 $0.12 | $12.00 |
| claude-opus-5-5 | $4.80 读缓存 $0.24 | $24.00 |
input 指新发送的输入 token，「读缓存」指模型从缓存拿到的输入 token，output 指回复 token。Koda 智能体每次都会把累积的全部历史重新发一遍，所以有没有缓存对账单影响很大。GPT 和 DeepSeek 不用任何设置，就会把不变的请求开头放进缓存。我们在 Koda CLI 1.3.0 的代码里没找到 cache_control 标记（2026-11-03 核对），所以 Koda Desktop 和 Koda CLI 里 Claude 的标记由 RuAPI 来打：智能体下一步在 5 分钟内发出时才打（docs.ruapi.ai/zh/prompt-caching）。
价格表里灰色的「>100K」是厂商对超长提示的定价：请求越过这个长度门槛后，整单都按这一档算。
用 Koda 自家模型，还是用自己的 RuAPI 密钥
| 通过 RuAPI 接自己的模型 | 按套餐用 Koda 的模型 | |
|---|---|---|
| 怎么付费 | USDT 余额，按 token 扣费，没有订阅 | Free、Pro、Pro+、Ultra 套餐（卢布）和 RC 加量包 |
| 有哪些模型 | RuAPI 目录里的任何模型，按 ID 选：Claude、GPT、Gemini、DeepSeek、Qwen、GLM、Kimi | koda-base、koda-pro，以及 Koda 团队接入的外部模型 |
| 请求在哪里处理 | 经 RuAPI 网关交给境外模型厂商（运营方 CYBERBIT PTE. LTD.，新加坡） | 据 Koda 介绍，koda-base 和 koda-pro 在俄罗斯境内处理，符合俄罗斯第 152 号联邦法（个人数据法） |
| 在哪里能用 | Koda Desktop 在设置里加，Koda CLI 用 /model 加，插件写 config.yaml | Koda 所有产品，包括不限量的代码补全 |
依据 kodacode.ru/tariffs 和 docs.kodacode.ru，2026-11-03 核对。两者可以并用：自己的模型和 Koda 的模型放在同一个列表里，随时切换。