← Volver a las guías

从零配置任意 AI CLI：自定义 Base URL 接入 59API

为什么 AI CLI 需要自定义 Base URL

多数 AI 命令行工具默认请求官方 API 地址，但它们通常也允许通过环境变量或配置文件覆盖 Base URL。这个能力适合统一网关、内部代理、区域网络优化，以及按成本选择模型供应渠道。59API 提供兼容 Claude Code、Codex 和 OpenAI SDK 的 API 中转服务，基础地址为 https://api.59api.com，可按量付费调用 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型。对于需要频繁在终端编码、自动化脚本或 CI 中调用模型的开发者，这种按实际用量结算的方式更容易控制预算。

第一步：确认 CLI 使用的协议

先分辨工具走的是 Anthropic 协议还是 OpenAI 协议。Claude Code 一般读取 Anthropic 风格的密钥和地址配置；Codex、OpenAI 官方 SDK，以及大量兼容工具通常读取 OpenAI 风格配置。Base URL 不能只看名称相同，还要与客户端发送的请求格式匹配。59API 已提供相应兼容能力，因此在配置前应查阅当前 CLI 的文档，确认它要求的是 ANTHROPIC_BASE_URL、OPENAI_BASE_URL，还是配置文件中的 base_url 或 baseURL 字段。

• Anthropic 兼容客户端：设置服务地址、API Key，并保留客户端要求的模型名称。
• OpenAI 兼容客户端：设置 OPENAI_API_KEY 和 OPENAI_BASE_URL，SDK 中通常使用 baseURL 参数。
• 不支持自定义地址的 CLI：检查是否存在 provider、endpoint、proxy 或环境变量覆盖选项。

第二步：创建密钥并设置环境变量

注册 59API 后，在控制台创建 API Key。不要把密钥写入 Git 仓库、Shell 历史共享脚本或前端代码；本地开发可放在当前终端会话、受权限保护的环境文件或密钥管理器中。以 OpenAI 兼容工具为例，可在 macOS 或 Linux 终端执行 export OPENAI_API_KEY=你的59API密钥，再执行 export OPENAI_BASE_URL=https://api.59api.com。Windows PowerShell 则使用 $env:OPENAI_API_KEY 和 $env:OPENAI_BASE_URL 设置当前会话变量。

对于 Anthropic 兼容客户端，常见做法是设置 ANTHROPIC_API_KEY，并将 ANTHROPIC_BASE_URL 指向 https://api.59api.com。变量名称以工具实际文档为准：有些客户端要求完整 API 根路径，有些只接受主机地址。首次接入时，先在独立终端会话中设置，验证成功后再写入 shell 配置、CI Secret 或团队部署平台的安全变量。

第三步：在 Claude Code、Codex 和 SDK 中验证

配置完成后，使用一个简短、低成本的请求验证连通性，例如让工具总结当前目录中的一个小文件，或请求模型返回一句固定文本。先确认请求是否成功、模型名是否可用、账单是否正常记录，再开始长上下文任务。Claude Code 可继续按既有工作流执行编码、审查和解释任务；Codex 或其他 OpenAI 兼容 CLI 则应沿用原有命令，仅让底层请求转向新的 Base URL。

OpenAI SDK 的关键是初始化客户端时显式传入 baseURL=https://api.59api.com，并从环境变量读取 apiKey。生产环境不要硬编码这两个值，应由部署平台注入。这样本地、测试和生产环境可以使用不同密钥，也可以在不改业务代码的情况下切换网关。

第四步：排查常见失败并上线

• 401 或 403：检查 API Key 是否完整、是否有多余引号，以及变量是否在启动 CLI 的同一终端中生效。
• 404：通常是协议或路径不匹配。核对该工具要求的 Base URL 格式，而不是自行拼接未知路径。
• 模型不可用：确认模型标识与客户端协议一致，并先用控制台支持的模型列表测试。
• CI 失败：确认 Secret 已注入运行步骤，且日志未打印密钥或完整请求头。

上线后建议记录请求量、失败率、模型选择和单任务成本，并为高成本模型设置预算告警。59API 的优势在于以较低成本提供官方质量的原生模型能力，而非降级替代模型；再结合按量付费和推荐返利，适合个人开发者与团队逐步迁移现有 AI CLI 工作流。需要实际配置时，可先注册 59API，创建一个专用于测试环境的密钥完成首轮验证。

Precios · Docs