Claude Code 国内使用完全指南
截至 2026-10-15，国内开发者把 Claude Code 的 ANTHROPIC_BASE_URL 指向 QCode（文档建议中国大陆用户使用 asia.qcode.cc 亚洲节点），用支付宝或微信支付充值即可使用；可调 claude-opus-5-5、claude-sonnet-5-5 等模型，同一把 key 也能接 Codex。
把这个工具接到 QCode 端点：一把 key 调 Claude、GPT 与国产模型。
- 按 token 计费，实时单价见 /models
- 支付宝、微信支付、信用卡、加密货币均可付款
- 充值后自助开通、立刻生效
为什么无法直接使用 Claude Code？
国内开发者面临三重障碍
网络访问限制
api.anthropic.com 在中国大陆无法直接访问
支付方式不兼容
Anthropic 官方只接受 Visa/MasterCard 等境外信用卡，不支持支付宝、微信支付、银联
官方支持地区
截至 2026-10-15，Anthropic Supported Regions Policy 的支持地区清单不含中国大陆
三种接入方式对比
官方订阅、官方 API 与 QCode 密钥怎么选
| 方案 | 可用范围 | 配置难度 | 支付方式 | 综合成本 | 推荐 |
|---|---|---|---|---|---|
| Claude 订阅（Pro / Max） | 仅限官方支持地区 | 需官方账号 | 境外信用卡 | 低 | ⚠️ |
| 官方 API Key（Console） | 仅限官方支持地区 | 需 Console 账号 | 境外信用卡 | 高 | ⚠️ |
| QCode.cc 订阅服务 | 多域名可切换 | 5 分钟 | 支付宝 / 微信 / 银行卡 | 低 | ✅ |
QCode.cc 一键接入教程
5 分钟完成配置，立即开始使用 Claude Code
获取专属 API Key
登录后在控制台创建你的 API Key（以 cr_ 开头），这是你调用 Claude Code 与 Codex 的凭证。
配置环境变量
在终端设置两个环境变量：ANTHROPIC_BASE_URL 填 https://api.qcode.cc/api（末尾不带斜杠），密钥放 ANTHROPIC_AUTH_TOKEN；工具只认 ANTHROPIC_API_KEY 时，填同一把 cr_ 密钥也能用。中国大陆用户，文档建议把域名换成 asia.qcode.cc。
验证连接
运行以下命令验证连接是否成功：
Claude Code 功能兼容情况
本地 CLI 能力（对话、读写文件、Bash、MCP、Skills、Plugins、子代理）照常可用；依赖 Anthropic 账号侧托管服务的功能（如云端会话、Remote Control）用第三方 API Key 时不可用
Claude Code Agent Teams
多 Agent 并行协作：Agent Teams 走同一条 Messages API 链路
MCP 协议集成
Model Context Protocol 完整透传，第三方工具无缝接入
Claude Hooks
自动化 Hooks 工作流，事件触发脚本正常运行
官方 Agent SDK
官方 Agent SDK（Python / TypeScript）同一把 key 直连，改 ANTHROPIC_BASE_URL 即可
Codex CLI
Codex CLI 走 OpenAI Responses 协议，base_url 填 https://api.qcode.cc/openai，可调 gpt-6.1-sol 等 GPT 系模型
流式响应 (SSE)
服务器发送事件（SSE）流式传输，回复边生成边显示
支持支付宝的灵活套餐
按需选择，随时扩容，无需境外信用卡；每日限额按北京时间 0 点重置
体验版
¥63/月
每日限额 $5
适合个人开发者日常使用
基础版
¥375/月
每日限额 $35
适合重度开发和小团队使用
标准版
¥860/月
每日限额 $85
适合高频使用和企业用户
常见问题
QCode 同时支持 OpenAI Codex / GPT-5.6
你的 QCode 套餐配额可同时用于 Claude Code 与 OpenAI Codex CLI，共享额度，无需重复购买。
深入：在中国用 Claude Code 的四个关键问题
Claude 在中国能用吗？先看官方支持地区清单
截至 2026-10-15，Anthropic 官方的 Supported Regions Policy（2026-05-12 生效）列出了提供其产品与服务的国家和地区，中国大陆不在这份清单里。
Supported Regions Policy 由 Anthropic 发布，上面引用的是 2026-05-12 生效的版本；Anthropic 自有产品与服务在哪些国家和地区提供，以该政策页面的最新版本为准。
Claude 订阅（Pro / Max）还是 QCode 密钥
QCode.cc 是独立的 API 接入服务，与 Anthropic 无隶属关系，也未获其背书。国内开发者用的是 QCode 的 cr_ 密钥：把 Claude Code 的 ANTHROPIC_BASE_URL 指向 QCode、密钥放进 ANTHROPIC_AUTH_TOKEN，再用支付宝或微信支付充值。QCode 通过单一 API 为你提供 claude-sonnet-5，无需另行管理 Anthropic 账户。同一把密钥还能调用 claude-opus-5-5、claude-sonnet-5-5 等其它 Claude 型号，可调型号以 /models 为准。
Claude Code 有两种用法：用 Claude 订阅登录，或用 API 凭证连接网关。官方文档写明，凭证变量生效时，请求带的是这把凭证而不是 claude.ai 订阅登录，订阅的用量限制也不适用；如果只设 ANTHROPIC_BASE_URL、不设凭证变量，已保存的 claude.ai 登录仍然是生效的凭证。所以接 QCode 时，ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个变量都要设。
QCode 文档写明，你在 Anthropic 或 OpenAI 的订阅不能在 QCode 使用，也不会被 QCode 消耗，两套是平行系统。QCode 自己的套餐是预付制：先充值，再买套餐，套餐从余额里扣；按 token 计费，各模型单价见 /models。个人套餐没有 4 小时窗口，每日限额按北京时间 0 点重置。
- Claude 订阅（Pro / Max）：官方客户端的会员，按月付费。
- 官方 API Key：Anthropic Console 的开发者密钥，按 token 计费，在官方平台充值。
- QCode 密钥（cr_ 开头）：一把 Key 调用 Claude、GPT 与主流国产模型，可用支付宝、微信支付充值。
国内付款与开通：从充值到拿到密钥
QCode 控制台把顺序写成三步：充值、买个人套餐或按量包、开始使用。人民币可用支付宝或微信支付（均不收手续费），人民币充值从 ¥30 起，按量包 ¥26 起、剩余余额可续买或买套餐；美元可用 Visa / Mastercard、Apple Pay、Google Pay 或加密货币（多币种多网络）。人民币与美元余额分开计，充值进入对应币种的余额。
余额到账后，到 qcode.cc/subscribe 选推荐套餐或自定义配置，这一步从余额扣款、不再刷卡；购买成功页会提示「Subscription Activated — Your API Key is created and ready to use」，cr_ 开头的密钥随即可以复制。不确定买哪一档，可以先买小档，之后随时升级不亏：买更高档套餐后发邮件到 hi@qcode.cc，旧套餐剩余时间价值按比例折算退回 QCode 余额。
- 支付宝、微信支付：充进人民币余额，无需境外信用卡。
- 银行卡、Apple Pay、Google Pay：支付成功后余额立即到账。
- 加密货币：0% 平台手续费，人工核对约 1 天。
- 当天额度不够：在控制台买加油包，加油包按北京时间次日凌晨 2 点单独重置。
国内配置细节：安装、持久化与常见报错
安装：官方 npm 包需要 Node.js 22 或更高版本；QCode 文档给出的国内镜像写法是 npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com。也可以运行文档里的一键配置脚本 curl -fsSL https://qcode.cc/install/claude-code.sh | bash（Windows 用 irm https://qcode.cc/install/claude-code.ps1 | iex），一条命令完成全部配置。
持久化：官方文档建议把 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 写进 ~/.claude/settings.json 的 env 块，这样后台会话也能用上；同一变量在 settings 文件和 shell 里都设了时，以 settings 文件为准。不要把密钥写进项目里的 .claude/settings.json，那个文件会随仓库提交。配好后在 Claude Code 里运行 /status，Anthropic base URL 一行显示 QCode 的地址、Auth token 一行写着 ANTHROPIC_AUTH_TOKEN，就说明已生效。
- 401：密钥无效或没传对，核对 cr_ 前缀是否完整；sk-ant- 开头的是 Anthropic 官方密钥，不是 QCode 密钥。
- 404：多半是路径前缀写错，或地址末尾多了一个斜杠；ANTHROPIC_BASE_URL 填 https://asia.qcode.cc/api 或 https://api.qcode.cc/api，不要带 /v1/messages。
- model_not_available_on_endpoint：把 Claude 模型填到了 OpenAI 协议的地址上，Claude 只能用 Anthropic 协议。
- 提示已达到每日费用限制：日限额按北京时间 0 点重置，当天不够可以买加油包。
- 安装时报 ETIMEDOUT：改用上面的国内镜像源。
更多常见问题
Claude 在中国能用吗？
截至 2026-10-15，Anthropic 的 Supported Regions Policy 列出的国家和地区里没有中国大陆。国内开发者可以用 QCode 的 cr_ 密钥在 Claude Code 里调用 Claude 模型，用支付宝或微信支付充值，接入地址按文档建议用 asia.qcode.cc。
我已经有 Claude Pro / Max 订阅，能在 QCode 用吗？
不能。订阅是官方客户端的会员，不包含可以转用的 API 额度；QCode 按 token 计费，两者互不相干、可以并存。同一个 Claude Code 既可以用订阅登录，也可以用 ANTHROPIC_BASE_URL 加 cr_ 密钥指向 QCode，取决于当前生效的是哪个凭证。
没有境外信用卡，在国内怎么付款？
用支付宝或微信支付充值人民币余额即可，无需境外信用卡；支付宝与微信支付都不收手续费，人民币充值从 ¥30 起，按量包 ¥26 起、剩余余额可续买或买套餐。也可以充美元余额，支持 Visa / Mastercard、Apple Pay、Google Pay 和加密货币（多币种多网络）。
通过 QCode 用 Claude Code，还需要 Anthropic 账号吗？
QCode 通过单一 API 为你提供 claude-sonnet-5，无需另行管理 Anthropic 账户。你需要的是一个 QCode 账号和 cr_ 开头的密钥；同一把密钥也能调用 claude-opus-5-5、claude-sonnet-5-5、claude-haiku-5-5 等，可调型号以 /models 为准。
在 Claude Code 里能选哪些模型？
Claude Code 走 Anthropic 协议，可以用 claude-opus-5-5、claude-sonnet-5-5、claude-sonnet-5、claude-haiku-5-5 等 Claude 型号，用 /model 命令切换；deepseek-v4-pro、glm-5.3 等国产模型也支持 Anthropic 协议。GPT 型号（如 gpt-6.1-sol、gpt-6-sol）请用 Codex 接入，base_url 填 https://asia.qcode.cc/openai 或 https://api.qcode.cc/openai。完整清单见 /models。
充值后多久能开始用？
银行卡、Apple Pay、Google Pay 支付成功后余额立即到账；微信支付确认可能需要几分钟，到账后页面自动更新；加密货币靠人工核对，约 1 天。余额到账后买好套餐，密钥随即生成，几分钟上手。
怎么确认 Claude Code 已经在用 QCode？
在 Claude Code 里运行 /status：Anthropic base URL 一行应显示你填的 QCode 地址，Auth token 一行应写着 ANTHROPIC_AUTH_TOKEN；如果看到的是指向 claude.ai 账号的 Login method，说明凭证变量没有生效。每次请求的模型、上下文长度和用量，也可以在 probe.qcode.cc 输入自己的密钥查看。