# 中国大陆以外用户上手

QCode.cc 上的一切对你都一样，只有**三件事**的选择不同：用哪个货币充值、把工具指向哪个接入域名、读
哪种语言的文档。本页把这三件事走一遍，细节都链到对应页面。

## 1. 注册账号

用 [qcode.cc](https://qcode.cc) 右上角的 **Sign Up**，用邮箱地址注册。注册完直接进控制台，它的副标题
是 *“Manage your API keys, top-up and usage”* —— 详见[控制台使用指南](/docs/reference/dashboard-guide)。

## 2. 用美元充值

充值页每个货币有自己的页签：*“CNY and USD balances are separate. Recharge amount will be added to the
corresponding currency balance.”* 中国大陆以外一般用 **USD** 页签，目前这一页提供：

- **Credit / Debit Card（信用卡 / 借记卡）** —— *“Credit / Debit card fee {rate}”*，在新窗口完成。
- **Cryptocurrency（加密货币）** —— *“0% platform fee · ~1d manual reconcile”*：链上转账、人工核对，
  所以付出的不是手续费而是一小段等待。

USD 页签上印着的限额：*“Minimum $1”* / *“Maximum $2,000”*。俄罗斯的付款通道（SBP、俄罗斯银行卡）只在
俄语界面出现，它们让你付卢布、把余额记成美元。含支付宝与微信（CNY）的完整对比见
[付款方式总览](/docs/reference/payment-methods)，加密货币细节见
[Crypto Payment Guide](/docs/reference/crypto-payment)。

## 3. 买套餐并复制 key

套餐是在控制台里用余额买的——**Buy a Plan** 打开订阅页，有 **Recommended Plans** 和 **Custom
Configuration** 两个页签。成功后页面写着 *“Subscription Activated — Your API Key is created and ready to
use”*。key 以 `cr_` 开头（见 [FAQ](/docs/reference/faq)），一把 key 三种协议都能用。

## 4. 选对接入域名

三个域名对应同一个账户、同一把 key，只是路由不同（权威说明在
[Endpoints & API Paths](/docs/getting-started/endpoints-and-api-paths)）：

| 域名 | 面向用户 | 什么时候用 |
|---|---|---|
| `api.qcode.cc` | 全球（Route 53 按延迟调度） | 中国大陆以外的默认选择，它会挑最近的节点 |
| `us.qcode.cc` | 北美 / 欧洲（备用） | 全球地址对你这边不稳定时 |
| `asia.qcode.cc` | 亚洲（备用） | 你在亚洲且全球地址不稳定时 |

控制台里 **API Access Address** 区块在任何非中文界面都会把 `https://api.qcode.cc` 标成推荐，另外两个
列在 **Backup** 行。填的时候要按工具补到协议前缀，并且**结尾不要带斜杠**：

```bash
export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_key"
claude
```

`/api` 是 Anthropic 通道（Claude Code），`/openai` 是 Codex 通道，`/gemini` 是 Google 通道——逐工具的
对照表在[环境变量](/docs/getting-started/environment)。

## 5. 安装工具

控制台的 **One-Click Setup (Recommended)** 区块会替你把界面语言写好：非中文界面显示的命令带
`--lang en`，而中文界面打印的命令不带任何语言参数。朴素形式是：

```bash
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang en
curl -fsSL https://qcode.cc/install/codex.sh | bash -s -- --lang en
```

脚本会用延迟测试挑最快的接入点，然后向你要 `cr_` key（输入不回显），需要时装好 Node.js 和 CLI，最后
发一条测试请求。Windows 用的是 `irm … | iex` 形式。完整说明与回滚方式在
[一键安装脚本](/docs/getting-started/one-click-install)，接着看
[快速开始](/docs/getting-started/quick-start) 或 [Codex 快速开始](/docs/getting-started/codex-quick-start)。

## 6. 读你语言的文档

文档站顶部有语言菜单——搜索框旁边那个 **🌐** 按钮，列出了文档已发布的语言。选一项会记住这个选择（一个
与 qcode.cc 共用的 cookie），并把当前页面切到该语言的地址下。每个页面都可以按语言直接寻址，因此链接
可以定向分享：

```text
https://docs.qcode.cc/docs/<category>/<slug>            no prefix: your browser language decides, Chinese is the fallback
https://docs.qcode.cc/en/docs/<category>/<slug>         English
https://docs.qcode.cc/<lang>/docs/<category>/<slug>     any other published language
```

如果某页还没有你的语言版本，就读英文页，URL 尾巴保持不变。要让**工具**用你的语言回答而不是英文，见
[语言设置](/docs/usage/language-settings)。

## 7. 跨时区的客服

在线支持在 UTC+8 的工作时段：*“Weekdays 10:00 - 21:00 (UTC+8) online response”*，非工作时间的消息
*“checked intermittently, replies may be delayed”*。控制台的 **Contact Us** 按钮在右下角，通向 Telegram
和邮件；[hi@qcode.cc](mailto:hi@qcode.cc) 全天可收，升级套餐、要发票、付款卡住都走邮件。接入点的实测
数据是公开的：[probe.qcode.cc](https://probe.qcode.cc)。

## 另外值得知道

- **你的 Claude / ChatGPT 订阅不会被使用，也不会被消耗。** QCode 跑自己的套餐——见
  [Subscriptions vs API Keys vs QCode Keys](/docs/reference/subscription-vs-api-key)。
- **退款：** 已开通的额度不退，只有 [FAQ](/docs/reference/faq) 列出的少数例外；升级时旧套餐未使用的
  部分会折回余额。
- **报销票据：** 严格意义上的发票是中国大陆专属服务；中国大陆以外需要合同、对公转账和正式发票的公司，
  走[企业团队版指南](/docs/reference/enterprise-guide)。
- **价格**按 token 计，与 [qcode.cc/models](https://qcode.cc/models) 同步：[计费说明](/docs/reference/billing)。

## 相关页面

- [控制台使用指南](/docs/reference/dashboard-guide)
- [付款方式总览](/docs/reference/payment-methods)
- [Crypto Payment Guide](/docs/reference/crypto-payment)
- [Endpoints & API Paths](/docs/getting-started/endpoints-and-api-paths)
- [环境变量](/docs/getting-started/environment)
- [一键安装脚本](/docs/getting-started/one-click-install)
- [Claude Code 入门介绍](/docs/getting-started/introduction)
- [语言设置](/docs/usage/language-settings)
- [故障排查指南](/docs/reference/troubleshooting)