AI CLI 自定义 Base URL 实战：Claude Code、Codex 与 OpenAI SDK 配置指南

API · ZH · 2026-09-12

许多 AI CLI 默认连接官方接口，但开发环境、团队网关、企业代理或成本控制场景，往往需要把请求指向自定义 Base URL。真正容易出错的地方不在于修改一个地址，而在于确认协议、路径、密钥和模型名称是否匹配。下面这份指南适合 Claude Code、Codex 以及使用 OpenAI 兼容接口的其他命令行工具。

先判断 CLI 使用哪种协议

第一步不是直接替换网址，而是确认客户端的 API 协议。Claude Code 通常使用 Anthropic 协议，重点配置项是 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。Codex 以及多数 OpenAI SDK 则使用 OpenAI 兼容协议，常见配置项是 OPENAI_BASE_URL 和 OPENAI_API_KEY。

如果工具支持 provider、endpoint 或 base_url 配置，优先使用它的正式配置项。环境变量适合临时测试，配置文件适合长期使用，但不要把真实 API 密钥提交到 Git 仓库、Shell 历史记录或公开日志中。

用 59API 作为自定义入口

59API 是面向 Claude 和 GPT 模型的 AI API relay，入口地址为 https://api.59api.com。它按用量付费，适合希望降低固定订阅成本、同时保留原生模型能力的开发者。可用模型包括 Claude Opus、Sonnet、Haiku、Fable 以及 GPT 系列；其定位是接入官方质量模型，而不是通过降级模型来压低价格。

使用前先在 59API 控制台注册并创建 API Key。Anthropic 客户端通常填写 https://api.59api.com；如果 OpenAI 兼容客户端要求带版本路径，则在 base_url 中填写 https://api.59api.com/v1。不要机械地重复拼接路径，例如客户端已经自动添加 /v1 时，就不要再填写带两次 /v1 的地址。

Claude Code 配置步骤

在 macOS 或 Linux 的当前终端中，可以先执行：export ANTHROPIC_BASE_URL="https://api.59api.com"，再执行：export ANTHROPIC_API_KEY="你的59API密钥"，最后启动 claude。Windows PowerShell 对应写法是：$env:ANTHROPIC_BASE_URL="https://api.59api.com" 和 $env:ANTHROPIC_API_KEY="你的59API密钥"。

如果 Claude Code 版本使用配置文件，也可以把相同的 Base URL 和密钥写入其 provider 配置。启动后发送一个简短请求，确认返回内容、模型选择和计费记录都正常，再用于长上下文或自动改代码任务。

Codex 与 OpenAI 兼容 CLI

对于读取 OpenAI 环境变量的 Codex 版本，可设置 OPENAI_BASE_URL="https://api.59api.com/v1" 和 OPENAI_API_KEY="你的59API密钥"，然后启动 codex。若当前版本使用 TOML 或 JSON 配置，则在对应 provider 的 base_url 字段填写同一地址，并将 provider 指向 OpenAI-compatible 服务。

其他 OpenAI SDK 的原则完全相同。例如 Python 客户端的初始化逻辑应使用 api_key="你的59API密钥" 和 base_url="https://api.59api.com/v1"。模型参数仍需填写 59API 控制台支持的准确模型 ID，不要只凭显示名称猜测。Claude 模型则应通过 Anthropic 兼容客户端及其对应模型 ID 调用。

配置完成后的检查清单

协议：确认 CLI 使用 Anthropic 还是 OpenAI 兼容协议。
地址：确认是否需要 /v1，避免漏写或重复拼接。
密钥：使用 59API 创建的 Key，并检查当前终端是否真的读取到了它。
模型：使用控制台列出的准确模型 ID，先用低成本模型验证连接。
请求：发送一个短请求，确认响应、延迟和用量记录。
安全：不要在命令、截图、CI 日志或代码仓库中暴露 Key。

常见错误怎么排查

遇到 404，通常是 Base URL 的路径层级不对，检查客户端是否会自动补充 /v1。遇到 401 或 403，优先检查密钥、环境变量名称和终端会话，而不是立即更换模型。出现 model not found 时，核对模型 ID、协议和账户权限。若请求仍然走官方地址，检查项目级配置是否覆盖了全局环境变量，也要留意 HTTP_PROXY、HTTPS_PROXY 等代理变量。

如果你需要同时使用 Claude 和 GPT，又希望按实际用量控制预算，可以先用一个小任务验证 59API，再逐步迁移日常 CLI 工作流。注册 59API 后即可按需调用支持的原生模型；此外，平台还提供推荐返利，适合团队或开发者分享给有相同需求的同事。

शुरू करने के लिए तैयार?

कुछ ही मिनटों में Claude और GPT जोड़ें, सबसे कम कीमत पर। साइन अप करें और API key पाएं।

मुफ़्त साइन अप