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

# 在俄罗斯用 Claude Code：不用 VPN 怎么安装和使用

> Claude Code 在俄罗斯能不能用，不用 VPN、不用 Anthropic 账号怎么安装，怎么付款，遇到「Unable to connect to Anthropic services」和「Invalid API key」报错怎么办。

**先说结论：** Claude Code 这个程序本身是免费的，在俄罗斯可以用 npm 安装。用不了的是 Anthropic 账号：俄罗斯不在支持的国家名单里，而且从 2026 年 10 月 1 日起，俄罗斯的账号又开始被大批封禁。所以要把 Claude Code 接到 API 网关上：设好两个环境变量就能用，不用 VPN，不用 Anthropic 账号和订阅，用 USDT 付款，只为用掉的 token 付钱。

## Claude Code 在俄罗斯能用吗

| 方式 | 在俄罗斯能用吗？ | 问题在哪 |
| - | - | - |
| Claude Pro / Max 订阅，登录 Anthropic 账号 | 只能挂 VPN，而且有风险 | 俄罗斯不在支持的国家名单里；不收俄罗斯银行卡；2026 年 10 月起又一轮封号，付费账号也被封 |
| 用 Anthropic 控制台的密钥（按 API 付费） | 只能挂 VPN，而且有风险 | 问题同上，另外还要有外国银行的卡 |
| 通过 API 网关（例如 RuAPI） | **能，不用 VPN** | 需要网关的密钥和余额 |

> [!NOTE]
>
> 国家名单见 [Supported Regions Policy](https://www.anthropic.com/supported-countries) 页面（2026-10-22 查阅）：「Any country or region not listed is unsupported」（没列出的国家和地区都不支持），名单里没有俄罗斯。封号的消息来自 The Moscow Times 和 The Bell 的报道，2026 年 10 月。

## 在俄罗斯怎么安装 Claude Code

**1. Node.js 22 或更新版本**

用 `node --version` 看一下版本。没装 Node.js 或者版本太旧，就去 [nodejs.org](https://nodejs.org) 装 LTS 版本。

**2. 用 npm 安装**

```bash theme={null}
npm install -g @anthropic-ai/claude-code
claude --version
```

macOS、Linux 和 Windows（PowerShell）都是这条命令。`claude.ai` 的官方安装脚本在俄罗斯可能打不开，用 npm 装效果一样。

## 不用 Anthropic 账号，怎么接上 Claude Code

**1. RuAPI 密钥**

在 [www.ruapi.ai](https://www.ruapi.ai/?lng=zh-CN\&utm_source=docs\&utm_campaign=zh-claude-code-russia) 注册（邮箱、Google 或 Yandex 都行），充值，然后在控制台打开「**令牌管理**」→「**添加令牌**」，拿到一串 `sk-...`。

**2. 在 settings.json 里写地址和密钥**

打开 `~/.claude/settings.json`（Windows：`%USERPROFILE%\.claude\settings.json`；没有这个文件就新建一个），写入：

```json theme={null}
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.ruapi.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的RuAPI密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}
```

> [!WARNING]
>
> 地址末尾**不要**加 `/v1`，Claude Code 会自己加上 `/v1/messages`。

**3. 启动**

新开一个终端，进入项目文件夹，运行 `claude`。不用登录 Anthropic 账号。请求会出现在 RuAPI 控制台 →「**使用日志**」里。

更详细的设置，比如 `/model opus` 和 `/model haiku` 用哪个模型、用环境变量代替配置文件、Windows 上怎么配，见 [Claude Code 接入 RuAPI](/zh/integrations/claude-code.md)。

## 在俄罗斯怎么给 Claude Code 付款

不用订阅：只为 Claude Code 实际用掉的 token 付钱。

* **USDT 或 USDC**，走 TRC20、BEP20 或 Polygon 网络，5 USDT 起充，不需要外国银行卡。还没有 USDT 的话，可以用 SBP 拿卢布买：[分步教程](/zh/buy-usdt.md)，第一次大约要 15–30 分钟。
* **外国银行的卡**（Visa / Mastercard）也收。俄罗斯银行的卡，包括 Mir 卡，都不收。
* **提示缓存照样生效：** Claude Code 走的是 Anthropic 原生 API，所以它每一步都要重新发送的上下文，价格最多只有普通输入的十分之一。

怎么少花钱，见[Claude Code 和 Cline 怎么省钱](/zh/claude-code-cline-costs.md)。

## 报错和处理办法

| 看到什么 | 原因 | 怎么办 |
| - | - | - |
| `Unable to connect to Anthropic services` / `Failed to connect to api.anthropic.com: ERR_BAD_REQUEST` / `Claude Code might not be available in your country` | 有些版本的 Claude Code 第一次启动时会检查能不能连上 `api.anthropic.com`，就算设了 `ANTHROPIC_BASE_URL` 也一样。这个地址在俄罗斯连不上 | 把首次启动标记为已完成，见下文。再确认 `ANTHROPIC_BASE_URL` 已经设好 |
| `Invalid API key · Please run /login` 或 `401` | 密钥发错了地方，或者用错了密钥：没设 `ANTHROPIC_BASE_URL`（RuAPI 密钥被发给了 Anthropic），填的是 Anthropic 的 `sk-ant-...` 而不是 RuAPI 密钥，或者环境里还留着旧的 `ANTHROPIC_API_KEY` | 用 `/status` 查一下，再查环境变量，见下文。从 RuAPI 控制台重新复制密钥，不要带空格 |
| Claude Code 要你登录账号（`/login`） | 密钥没传到 Claude Code：比如写在了项目里的 `.claude/settings.json`，这种设置要等首次启动完成后才生效 | 把密钥写进用户主目录下的 `~/.claude/settings.json`，或者写进环境变量 |
| 警告 `Auth conflict` / `auth may not work as expected` | RuAPI 密钥和已保存的 Anthropic 账号登录同时生效 | 在 Claude Code 里执行 `/logout`，只留下 RuAPI 密钥 |
| `403`，余额不足 | 余额用完了 | [充值](/zh/topup.md) |
| `404` | `ANTHROPIC_BASE_URL` 末尾多了 `/v1` | 改成 `https://www.ruapi.ai` |
| `503`，找不到模型 | 模型名写错了 | 对照[价格页](https://www.ruapi.ai/pricing?lng=zh-CN\&utm_source=docs\&utm_campaign=zh-claude-code-russia)核对模型名 |

### 「Unable to connect to Anthropic services」怎么解决

这是 Claude Code 的已知问题（[GitHub 上的 issue](https://github.com/anthropics/claude-code/issues/26935)）：有些版本第一次启动时会去连 `api.anthropic.com`，不管你设没设 `ANTHROPIC_BASE_URL`。绕过的办法写在这个 issue 里，[另一个讨论](https://github.com/musistudio/claude-code-router/issues/494)里也有用户确认有效：把首次启动标记为已完成。

1. 关掉 Claude Code。
2. 打开 `~/.claude.json`（Windows：`%USERPROFILE%\.claude.json`）。这是**另一个**文件，不是 `settings.json`。
3. 在花括号里加一行 `"hasCompletedOnboarding": true`。如果文件是空的或者不存在，内容应该是：

   ```json theme={null}
   {
     "hasCompletedOnboarding": true
   }
   ```

   如果文件里已经有别的内容，要用逗号把这一行接上，不然 JSON 会坏掉。
4. 重新运行 `claude`。

### 「Invalid API key」：查一查请求发去了哪、带的是哪个密钥

在 Claude Code 里执行 `/status`，看这两行：

* `Anthropic base URL` 应该显示 `https://www.ruapi.ai`。没有这一行，说明 `ANTHROPIC_BASE_URL` 没传到 Claude Code，请求发去了 Anthropic。
* `Auth token` 应该写着 `ANTHROPIC_AUTH_TOKEN`。如果看到的是 `Login method` 加一个 claude.ai 账号，说明 RuAPI 密钥没被读到。

然后看看系统里设了哪些 Anthropic 变量：

```bash macOS / Linux theme={null}
env | grep ANTHROPIC
```

```powershell Windows (PowerShell) theme={null}
Get-ChildItem Env:ANTHROPIC*
```

* 应该有 `ANTHROPIC_BASE_URL=https://www.ruapi.ai`。
* 如果有 `ANTHROPIC_API_KEY`，里面还是旧密钥，就删掉它（或者改成 RuAPI 密钥）。RuAPI 密钥最好放在 `ANTHROPIC_AUTH_TOKEN` 里：这样 Claude Code 不会问你要不要用这个密钥。
* `settings.json` 里的变量，这个命令看不到，要直接打开文件看。同一个变量在系统和 `settings.json` 里都设了的话，以 `settings.json` 里的为准。
* 如果密钥放在 `ANTHROPIC_API_KEY` 里，Claude Code 会问一次要不要用它；当时答了「否」，之后它就会一声不响地忽略这个密钥。到 `/config` → `Use custom API key` 里把它打开。

> [!TIP]
>
> Claude Code 会在后台连 Anthropic 的服务器，用来检查更新、发送遥测数据。这些请求在俄罗斯可能发不出去，不影响通过 RuAPI 使用，但也可以关掉：在 `env` 里加一行 `"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"`。这样自动更新也会一起关掉，以后用 `npm install -g @anthropic-ai/claude-code@latest` 手动更新。

所有 API 错误码见[错误码](/zh/errors.md)页。

## 常见问题

> **2026 年在俄罗斯还能用 Claude Code 吗？**
>
> 能，只要接到 RuAPI：Claude Code 连的是 [www.ruapi.ai，这个地址在俄罗斯可以直接打开。不需要](http://www.ruapi.ai，这个地址在俄罗斯可以直接打开。不需要) Anthropic 账号和订阅，所以封号的事跟你没关系。

> **需要 VPN 吗？**
>
> 不需要。用 npm 安装不需要，日常使用也不需要：调用模型的请求只发到 [www.ruapi.ai。](http://www.ruapi.ai。)

> **Claude Code 能免费用吗？**
>
> 程序本身免费，模型要花钱。RuAPI 没有订阅，只为用掉的 token 付钱。新用户我们一般会马上送 \$0.05，用来试用 deepseek-flash；Claude Code 也可以[接 DeepSeek 用](/zh/integrations/claude-code-deepseek.md)，比 Claude 便宜好几倍。

> **要花多少钱？**
>
> 看用哪个模型、干多少活。比如 claude-sonnet-5-5：每 100 万输入 token \$2.40，每 100 万缓存读取 token \$0.12，每 100 万输出 token \$12（价格页 2026-10-22 的价格；你账号里的价格可能更低）。所有模型和价格见[价格页](https://www.ruapi.ai/pricing?lng=zh-CN\&utm_source=docs\&utm_campaign=zh-claude-code-russia)。

> **是原版 Claude 模型吗？**
>
> 是。都是 Anthropic 的原版模型，比如 claude-opus-5-5、claude-sonnet-5-5、claude-haiku-5-5，不降质量，不掉包。

> **能同时用 Anthropic 账号和 RuAPI 吗？**
>
> 能。用 [CC Switch](/zh/integrations/ccswitch.md) 点一下就能切换。

## 接下来

> **[在俄罗斯用 Claude Code：不用 VPN，不用账号](https://www.ruapi.ai/claude-code-v-rossii?lng=zh-CN\&utm_source=docs\&utm_campaign=zh-claude-code-russia)**
>
> 为什么在俄罗斯最好通过网关接 Claude Code。

> **[Claude Code 详细设置](/zh/integrations/claude-code.md)**
>
> 模型、环境变量、Windows。

> **[Claude Code 接 DeepSeek](/zh/integrations/claude-code-deepseek.md)**
>
> 还是那个 Claude Code，便宜好几倍。

> **[怎么用卢布买 USDT](/zh/buy-usdt.md)**
>
> Crypto Bot、Bybit P2P 或兑换商，三种方式。


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