← Back to Blog

Claude Code 无限速接入完全指南:3 分钟配置

Zivv13 min read
Claude Code配置指南教程

Claude Code 是目前体验最好的 AI 编程工具之一,但官方账号的速率限制让重度用户很难受:一个大型重构做到一半弹出 rate limit,等几分钟甚至几小时才能继续。这篇文章手把手教你用 Zivv 接入 Claude Code 与 Codex,彻底告别限速,全程大约 3 分钟,文末附完整的配置对照表、报错速查表和 FAQ。

为什么 Claude Code 特别容易被限速

官方对每个账号都有两类限制:API 计费账号有 RPM(每分钟请求数)与 TPM(每分钟 Token 数)配额;订阅账号则按时间窗口计算用量,窗口内打满只能干等重置。

普通聊天很难碰到这些上限,但 Claude Code 完全不同:

  • 它是 Agent 式工具,你的一条指令背后是几十轮模型调用:读文件、改代码、跑命令、看结果、再修改
  • 读取多文件上下文时,单轮请求就可能携带几万甚至几十万 Token
  • 大型重构、全仓库搜索、批量修测试这类任务,一次会话就能打满整个配额窗口

换句话说,被限速不是因为你「用得太狠」,而是这类工具的形态天然高耗。靠省着用解决不了问题,只会把工作节奏切得稀碎。

更麻烦的是限速的时点完全不可控。它不会挑你休息的时候出现,恰恰相反:越是全力冲刺的时段——上线前的连环修复、跨模块的大改动——消耗越猛,越容易在最不该停下的时刻被掐断。工程师被打断一次心流,重新进入状态往往要十几分钟,这个隐性成本比等待本身更贵。

Zivv 是怎么做到无限速的

Zivv 是 AI API 中转站,针对 Claude Code 提供专门的 Claude MAX 分组:底层是 Claude 订阅账号池,请求在池内自动轮换调度,单个账号的窗口限制被整个池子摊平,你拿到的是原生 Anthropic 协议接口和无速率限制的使用体感。

对使用方来说没有任何黑盒改造——Claude Code 官方就支持通过环境变量切换后端,Zivv 完整兼容 Anthropic 协议,所以只需要改两个环境变量,工具调用、上下文管理、终端交互都和接官方时完全一致。

这也意味着迁移是完全可逆的:任何时候想回官方,删掉环境变量即可,没有锁定。你不需要「相信」任何宣传,花三分钟接上,跑一个真实的重构任务对比一下连续性和稳定性,数据会替产品说话。顺带一提,Zivv 的产品与全部代码完全自研,不是开源网关套壳,这决定了账号池调度、计费和用量统计这些核心环节都是可控、可持续迭代的。

快速开始(3 分钟)

Step 1:注册 Zivv 并充值

  1. 访问 zivv.pro,用邮箱注册账号
  2. 充值最低 ¥10 即可开始,汇率 ¥1 = $1,人民币直付,价格低至官方几折
  3. 按量计费,用多少扣多少,没有月费,也没有「本月不用就浪费」的订阅焦虑

Step 2:创建 API Key

  1. 登录控制台,进入「API Key」页面
  2. 点击创建新 Key,分组选择 Claude MAX(专为 Claude Code 优化),名称随意,建议写清用途,比如 claude-code-macbook
  3. 复制 sk- 开头的 Key 并妥善保存,完整值只在创建时展示一次。丢了也不要紧,删掉重建只要十秒,所以宁可重建,也不要把 Key 存在聊天记录或共享文档里

Step 3:配置环境变量

macOS / Linux 在终端执行:

export ANTHROPIC_BASE_URL=https://zivv.pro
export ANTHROPIC_AUTH_TOKEN=sk-your-key-here
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://zivv.pro"
$env:ANTHROPIC_AUTH_TOKEN="sk-your-key-here"
claude

注意两点:ANTHROPIC_BASE_URLhttps://zivv.pro不要在后面加 `/v1`(那是 OpenAI 协议的路径);Key 用的是 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY,写错变量名是最常见的翻车点。

Step 4:永久生效

上面的写法只对当前终端窗口有效。想一劳永逸,macOS / Linux 把变量写进 shell 配置文件:

echo 'export ANTHROPIC_BASE_URL=https://zivv.pro' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN=sk-your-key-here' >> ~/.zshrc
source ~/.zshrc

用 bash 的把 ~/.zshrc 换成 ~/.bashrc。Windows 在「系统属性 → 环境变量」里新建这两个用户变量,或用 setx 命令写入,之后新开的终端都会自动带上。

两个安全提醒:如果你的 dotfiles 在多台机器间同步甚至公开托管,不要把 Key 明文写进去——把 Key 单独放在一个不入库的本地文件里,再在 shell 配置中引用它;另外改完配置后记得开个新终端验证,老窗口里的进程仍然带着旧环境变量。

Step 5:验证连通

最直接的验证是让 Claude Code 跑一句话:

claude "用一句话解释什么是闭包"

能正常返回即接入成功。如果想在进入客户端之前先确认网络与 Key 有效,可以直接请求模型列表:

curl https://zivv.pro/v1/models \
  -H "Authorization: Bearer sk-your-key-here"

返回模型数组说明 Key 和线路都没问题,剩下的只是客户端配置。反过来,如果这条 curl 都不通,就先解决网络或 Key 的问题,不要急着在客户端里反复重试——那只会把两类问题搅在一起。

Codex 用同一个 Key 接入

Codex 走 OpenAI 协议,Zivv 同样兼容,而且用的是同一个 Key,无需分别申请:

export OPENAI_BASE_URL=https://zivv.pro/v1
export OPENAI_API_KEY=sk-your-key-here
codex

注意这里的 Base URL 要带 /v1,与 Claude Code 的写法正好相反。Cursor、Cline、Cherry Studio 等支持自定义端点的客户端也一样,在设置里填 https://zivv.pro/v1 加 Key 即可。

不少人会同时开着 Claude Code 和 Codex 交叉干活:一个负责主线开发,一个并行跑小任务或者做第二意见验证。两个工具共用同一份余额、同一个控制台,用量按模型分开可查,不需要在两个平台之间倒腾账户和充值。

多设备与多项目怎么管 Key

公司电脑、家里电脑、服务器上的自动化任务,建议各建一个 Key,而不是一个 Key 到处贴:

  • 控制台按 Key 看用量,哪台设备、哪个项目在消耗一目了然
  • 某台设备出问题或转手时,只撤销对应 Key,其余不受影响
  • 给实验性质的脚本单独设额度,就算跑飞了也烧不穿整个余额
  • 创建 Key 不额外收费,管理成本几乎为零

命名建议带上设备和用途,比如 claude-code-macbookcodex-ci。三个月后回来对账时,你会感谢现在多花的这十秒钟。

费用怎么算,会不会很贵

Zivv 按量计费:充值汇率 ¥1 = $1,人民币直付,调用时按各模型单价从余额扣除,价格低至官方几折。对 Claude Code 重度用户来说,这套模式有两个直接好处:

  • 没有订阅时间窗口,也就没有「打满等重置」这回事,用多少付多少
  • 不用的时候零支出,不存在订阅费白交的问题

最低充 ¥10 就能完整跑通本文流程。先小额试用、确认体验后再加大投入,是最稳妥的路径。想进一步系统性压低整体 AI 支出(选模型、优化 Prompt、缓存与批处理),控制台的用量数据配合分模型定价可以做得非常细:哪天用了多少、哪个模型占大头,都有据可查,成本完全透明。

配置对照表

工具协议Base URLKey 变量 / 位置
Claude CodeAnthropichttps://zivv.proANTHROPIC_AUTH_TOKEN
CodexOpenAIhttps://zivv.pro/v1OPENAI_API_KEY
Cursor / ClineOpenAIhttps://zivv.pro/v1客户端设置内填写
Cherry StudioOpenAIhttps://zivv.pro/v1模型服务设置内填写
Gemini 协议调用Geminihttps://zivv.pro/v1beta请求头或 SDK 参数

记住一条规律就不会错:Anthropic 协议不加 `/v1`,OpenAI 协议要加 `/v1`,Gemini 协议用 `/v1beta`。

常见报错速查

现象原因解法
401 / invalid api keyKey 复制不完整、带空格,或写到了错误变量重新复制 Key,确认变量名是 ANTHROPIC_AUTH_TOKEN
404 not foundClaude Code 的地址误加了 /v1Base URL 只填 https://zivv.pro
仍弹官方登录 / 仍被限速环境变量没生效,客户端还连着官方重启终端,echo 检查两个变量是否存在
请求超时本地网络或代理拦截了域名检查代理规则,先用 curl 验证连通
模型不可用Key 分组不含目标模型控制台确认分组,或参考 404 排查指南

表里覆盖不到的报错,优先找响应正文里的错误字段而不是只看客户端弹窗,对照错误码说明基本都能定位。

常见问题 FAQ

Q:数据会不会泄露? A:不会。Zivv 不存储 Prompt 和 Response 正文,仅记录用量数据(模型、Token 数、时间)用于计费和看板展示,所有请求全程加密传输。对内容敏感的团队,这个「只记账、不留文」的边界是可以拿去过安全评审的。

Q:账号池会不会用完导致断供? A:不会。持续补充和维护账号池是 Zivv 的核心运营工作,池子规模与健康度有专门监控,这也是产品与全部代码完全自研带来的可控性。

Q:如何切换回官方? A:删除或注释那两个环境变量、重启终端即可,一秒切换,两边互不影响,可以随时对比体验。

Q:支持哪些模型? A:Anthropic 全系之外,OpenAI(gpt-5.5 / gpt-5.4)和 Gemini(gemini-3.5-flash 等)共 100+ 模型都能用同一个 Key 调用,完整列表见模型广场

Q:团队多人怎么接入? A:不要共享一个 Key。用团队功能给每个成员发独立 Key、设独立预算,共享余额统一充值,用量按成员和模型维度可查,谁的脚本在烧钱一眼就能看出来。

Q:用了 Zivv 还需要保留官方订阅吗? A:看个人习惯。两套配置互不冲突:不少用户保留一个轻量订阅做日常问答,重度编码全部走 Zivv;也有用户直接全量迁移,按量付费用多少花多少。切换成本只有两个环境变量,随时可以调整策略。

写在最后

Claude Code 的价值在于连续的心流:它连续工作,你连续思考。限速打断的不只是请求,还有你的工作节奏。两个环境变量的改动成本,换来的是稳定不断供的开发体验——这笔账很好算。如果配置过程中卡在了某一步,按上面的报错速查表逐项核对,九成问题不出五分钟就能解决。

现在就注册 Zivv 创建你的第一个 Key,更多 Vibe Coding 工具的接入方案见编程工具接入,细节配置与排查见 Claude Code 文档