← Volver a las guías

Claude Code 接入教程：59API 配置与计费 FAQ

为什么开发者会反复问这个问题

很多开发者第一次用 Claude Code，卡住的并不是模型能力，而是两件小事：地址填错、密钥填错。官方客户端默认连接官方服务，想换成 59API 的线路，就必须明确告诉它把请求发到哪里、用哪一把密钥。59API 是独立第三方 AI API 中转服务：一个账号、一把 API key、一个 API 主机 https://api.59api.com，就能调用 Claude、GPT、Gemini、DeepSeek 以及其他模型。它不是任何厂商的官方渠道，也不是授权经销方，只是一个把请求接入与计费统一起来的中转层。

计费方式是预付余额，按请求的真实 token 用量扣费，没有月费，余额不过期；月卡和周卡是可选的，不是必买项。对开发者来说，这意味着你可以先用小额充值跑通流程，看看链路和账单是否符合预期，再决定是否加大用量，而不是先被一笔固定月费绑住。充值门槛也足够低：¥10、¥50、¥100、¥200、¥500、¥1000 可选，支持微信支付和银行卡，可开票。所有价格以人民币结算，并按每 100 万 tokens 标注，输入、输出、缓存读取三项分开计价。把这些数字摊开，你在写第一行代码之前就能估出一次任务大概要花多少，而不是等账单出来才发现超支。

接入 Claude Code 的正确配置方式

在 Claude Code 或 Claude Desktop 里接入 59API，只需要两个设置项。把环境变量 ANTHROPIC_BASE_URL 设为 https://api.59api.com，把 ANTHROPIC_AUTH_TOKEN 设为 YOUR_59API_KEY，其中 YOUR_59API_KEY 换成你自己在 59API 后台拿到的密钥即可。两个值都填好之后，客户端发出的请求就会走 59API 的 API 主机，token 用量也按 59API 的价格结算。

这里有一个必须说清楚的限制：Claude 模型只能通过正版 Claude Code 或 Claude Desktop 客户端调用，客户端版本需要是 Claude Code 2.1.285 或更新版本。不能用 OpenAI SDK、cURL 或其他任何客户端去请求 Claude 模型。这不是配置技巧问题，而是协议与调用链路的硬性要求——把 ANTHROPIC_BASE_URL 指向 59API 之后，能否跑通取决于你使用的确实是正版 Claude Code 客户端，而不是一个长得像的第三方壳子。

如果你习惯用配置文件而不是环境变量，那么最终生效的值仍然只有两个：主机地址必须是 https://api.59api.com，不要自行加 /v1 或其他后缀；密钥必须是 59API 生成的 key。配置完成后，可以先发一个很短的问题验证链路是否通，再开始正式任务。

哪些客户端能配 59API，哪些不能

这是 FAQ 里最常被问错的一条。59API 的接入方式按模型家族区分：Claude 走 Anthropic 原生协议，只能在正版 Claude Code 或 Claude Desktop（2.1.285 及以上）里用；Gemini 走 Google 原生协议，只能在 Gemini CLI 里用，配置是 GOOGLE_GEMINI_BASE_URL=https://api.59api.com 和 GEMINI_API_KEY=YOUR_59API_KEY，它不是 OpenAI 兼容协议，也不能挂在 /v1/chat/completions 上。

另一条线是 Codex、OpenAI SDK、cURL 以及 OpenAI 兼容客户端，例如 Cursor、Cherry Studio、Cline 和 OpenCode，它们只能调用 GPT、DeepSeek 以及其他既非 Claude 也非 Gemini 的模型。配置方式是 base_url 填 https://api.59api.com/v1，聊天接口填 https://api.59api.com/v1/chat/completions。换句话说，一个账号一把 key 覆盖多模型没错，但不同模型家族要放进对的客户端里，这一点没有例外。

Claude 模型价格与账单示例

59API 的 Claude 价格按每 100 万 tokens 计，人民币结算。几个常用档位：Claude Sonnet 5.5（claude-sonnet-5-5）输入 ¥8、输出 ¥40、缓存读取 ¥0.7；Claude Opus 5.5（claude-opus-5-5）输入 ¥11、输出 ¥52、缓存读取 ¥0.5；Claude Haiku 4.5（claude-haiku-4-5-20251001）输入 ¥2.5、输出 ¥12、缓存读取 ¥0.2；Claude Fable 5.1（claude-fable-5-1）输入 ¥26、输出 ¥130、缓存读取 ¥1.6。

看一组具体账单更直观。假设 Claude Sonnet 5.5 跑 3M 输入 + 0.5M 输出、不使用缓存，在 59API 上是 ¥44；同样用量按官方标价 $11（约 ¥79.2）计算，59API 约为官方标价的 56%。再看 Claude Opus 5.5，2M 输入 + 0.5M 输出不用缓存，在 59API 是 ¥48，官方标价 $18（约 ¥129.6），59API 约为官方标价的 37%。Claude Haiku 4.5 跑 5M 输入 + 1M 输出不用缓存，在 59API 是 ¥24.5，官方标价 $10（约 ¥72），约为官方标价的 34%。这些例子说明：日常主力用 Sonnet 5.5，复杂任务切 Opus 5.5，长上下文或批处理压成本用 Haiku 4.5，都是能算清楚的账。

按量付费之外，月卡和周卡怎么选

如果你在 Claude Code 里是重度使用，可以再看看可选的卡。卡有自己的 key，只能调用对应家族的模型，并且只从卡里扣费：它不会回落到钱包余额，余额 key 也不会动用卡里的额度。未用完的额度不结转。需要提醒的是，卡的额度与上限是卡片计量单位，写的是 $，不是官方标价的美元，不要直接换算成官方价格。

以 Claude 家族为例：C-PRO 入门版 ¥599，额度 $610，周上限 $230；C-PRO 标准版 ¥1099，额度 $1100，周上限 $410；C-PRO 旗舰版 ¥1721，额度 $1750，周上限 $640。C-MAX 标准版 ¥2299，额度 $2350；C-MAX 旗舰版 ¥3599，额度 $3700，周上限 $1350。周卡方面，【周卡】C-PRO $290 是 ¥289，额度 $290；【周卡】C-MAX $570 是 ¥559，额度 $570。卡片按卡内计量价格 × 2.4 消耗。

怎么选？先按量付费跑一周，把真实用量记下来，再对照卡的价格和周上限做决定；用量忽高忽低、需要压低单次支出，按量付费更灵活；用量稳定且集中在某个家族，卡的额度结构可能更合适。开户、充值和价格都在 59API 站点完成，先把配置跑通，再谈规模化，这一步的顺序对任何人都一样。

Docs