← Back to all guides

AI CLI 自定义 Base URL：接入 59API 的完整教程

许多 AI CLI 默认连接官方 API，但你也可以把请求指向兼容的自定义服务，从而统一密钥、切换模型或降低调用成本。本文以 59API 为例，演示如何配置 Claude Code、Codex、OpenAI SDK，以及其他支持环境变量的命令行工具。

一、先理解 Base URL 和 API Key

Base URL 是客户端发送请求的服务器地址，API Key 则负责身份验证。两者不是一回事：更换 Base URL 不会自动生成密钥，仍需在服务商控制台创建自己的 Key。

59API 提供 Claude Opus、Sonnet、Haiku、Fable 以及 GPT 系列模型的按量付费访问，使用原生官方质量模型，不需要为固定套餐预付高额费用。其 API 兼容 Claude Code、Codex 和 OpenAI SDK，入口地址是 https://api.59api.com。

二、注册并准备密钥

• 打开 59API 官网，注册或登录账户。
• 进入 API Key 页面，创建一个新密钥，并复制完整内容。
• 确认账户余额或支付方式可用，再进行首次请求。
• 把密钥保存到密码管理器或系统密钥环，不要提交到 Git 仓库、聊天记录或前端代码。

如果通过邀请链接注册，还可以按平台当前规则获得推荐返利；具体比例和有效期应以账户页面显示的信息为准。

三、配置 Claude Code

在 macOS 或 Linux 终端中，先设置环境变量：

export ANTHROPIC_BASE_URL=https://api.59api.com

export ANTHROPIC_API_KEY=你的59API密钥

Windows PowerShell 可使用：

$env:ANTHROPIC_BASE_URL="https://api.59api.com"

$env:ANTHROPIC_API_KEY="你的59API密钥"

然后启动 Claude Code，并在工具内选择你账户可用的 Claude 模型。如果命令行启动后仍连接官方地址，检查变量是否在同一个终端会话中生效，也可执行 echo $ANTHROPIC_BASE_URL 进行确认。部分旧版本或第三方封装可能使用 ANTHROPIC_AUTH_TOKEN，此时应参考该版本的认证说明，避免同时设置互相冲突的变量。

四、配置 Codex 或其他 OpenAI 兼容 CLI

OpenAI 兼容客户端通常需要带版本路径的地址。先尝试设置：

export OPENAI_BASE_URL=https://api.59api.com/v1

export OPENAI_API_KEY=你的59API密钥

如果工具支持配置文件，也可以把 provider 的 base_url 写成上述地址，并将认证变量指定为 OPENAI_API_KEY。Codex 不同版本的配置字段可能略有差异；重点是 provider 必须使用 OpenAI 兼容协议，且不要把 /v1 重复拼接两次。

如果服务商文档明确要求根地址不带 /v1，就应严格使用 https://api.59api.com。判断方法是查看客户端实际请求路径：客户端会自动补全 /v1 时不要再手动添加；不会补全时才使用带版本路径的地址。

五、在 OpenAI SDK 中验证

以 Python SDK 为例，初始化客户端时显式指定 base_url：

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"], base_url="https://api.59api.com/v1")

随后使用服务商支持的模型名称发送一次短请求。若返回正常文本，说明密钥、网络和 Base URL 均已生效。Node.js、Go 等 SDK 的做法相同：找到 client 初始化参数中的 baseURL 或 base_url，并将其改为 59API 对应地址。

六、常见错误排查

• 401 或 403：检查 Key 是否复制完整、是否已过期，以及变量名是否正确。
• 404：通常是 /v1 重复或缺失，按照客户端是否自动拼接路径进行调整。
• 模型不存在：模型名称必须使用 59API 控制台或文档列出的名称，不能直接假设官方名称完全一致。
• 请求超时：先用 curl 或其他简单客户端测试网络，再排查 CLI 自身代理和超时设置。
• 仍请求官方服务：检查配置文件是否覆盖了环境变量，并重启 CLI 会话。

七、让配置长期可用

确认测试成功后，可把环境变量写入 shell 的配置文件，或使用 .env、系统密钥环和 CI/CD Secret 管理。生产环境建议为不同项目创建独立 Key，设置额度提醒，并定期轮换密钥。

如果你需要以较低成本调用 Claude 和 GPT，同时保持官方质量模型兼容性，可以注册 59API，创建按量使用的 API Key，再按照本文将现有 AI CLI 指向自定义 Base URL。

Pricing · Docs