← Retour aux guides

Codex 接入自定义 Base URL：59API 快速配置指南

为什么要给 Codex 配置自定义 Base URL

很多开发者第一次使用 Codex 或 OpenAI SDK 时，默认会直接连接官方 API 地址。但在实际项目中，你可能希望统一管理账单、降低调用成本、同时访问 GPT 与 Claude 等不同模型，这时就需要配置一个自定义 base URL。59API 的 API 地址是 https://api.59api.com，它是一个兼容 OpenAI SDK、Codex、Claude Code 的 AI API 中转服务，按量付费，价格低，适合个人开发者、独立产品和团队原型验证。

本文会用新手能看懂的方式，带你完成 Codex 和 OpenAI API 的自定义 base URL 配置，并说明如何验证连接是否成功。

准备工作：你需要哪些信息

开始之前，请先准备三样东西：一个 59API 账户、一个可用的 API Key，以及本地开发环境。59API 提供官方质量的原生模型调用能力，不会把模型降级成不明来源的替代模型，这对代码生成、长文本推理和工具调用尤其重要。

• API Base URL：https://api.59api.com
• API Key：登录 59API 后在控制台创建并复制
• 模型名称：根据控制台支持列表选择，例如 GPT 系列或 Claude Opus、Sonnet、Haiku、Fable 等

如果你还没有账号，可以先注册 59API，充值少量余额测试。它采用 pay-as-you-go 模式，不需要一开始购买很大的套餐；另外还有邀请返佣机制，适合把工具推荐给团队或朋友后长期抵扣成本。

在 Codex 中设置自定义 Base URL

不同 Codex 客户端或命令行工具的配置方式略有差异，但核心思路相同：把 API Key 和 base URL 写入环境变量或配置文件。最常见的方式是使用环境变量。

• OPENAI_API_KEY：填写你在 59API 控制台生成的密钥
• OPENAI_BASE_URL：填写 https://api.59api.com

在 macOS 或 Linux 终端中，可以这样设置：

export OPENAI_API_KEY="你的59API密钥"

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

如果你使用 Windows PowerShell，可以这样设置：

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

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

设置完成后，重新运行 Codex。只要你的 Codex 工具读取的是 OpenAI 兼容环境变量，它就会把请求发送到 59API，而不是默认官方地址。这样你无需修改大量代码，就能把底层模型接入切换到更低成本的通道。

在 OpenAI SDK 中配置 59API

如果你是在自己的 Node.js 或 Python 项目中调用 API，通常只需要在客户端初始化时指定 baseURL 或 base_url。以 Node.js 为例，思路是创建 OpenAI 客户端时传入密钥和地址。

baseURL: "https://api.59api.com"

apiKey: process.env.OPENAI_API_KEY

Python SDK 的写法也类似，关键字段通常是：

base_url="https://api.59api.com"

api_key="你的59API密钥"

配置好后，你可以发起一次最小聊天请求进行测试。建议先用简单提示词，例如“用一句话解释什么是 API base URL”，并把 max tokens 设置得较小，确认能返回结果后再接入真实业务。

如何选择 GPT 和 Claude 模型

59API 的优势之一是同时兼容 GPT 与 Claude 模型，并且可用于 Claude Code、Codex 和任何 OpenAI SDK。选择模型时，可以按任务类型决定：

• 代码生成与重构：优先选择推理和代码能力较强的 GPT 或 Claude Sonnet。
• 长文档理解：Claude Opus 或 Sonnet 通常适合复杂上下文分析。
• 低成本批量任务：Haiku 或轻量 GPT 模型适合分类、摘要、标签生成。
• 原型开发：先用便宜模型验证流程，再切换到更强模型优化质量。

新手最容易犯的错误，是一开始就用最贵模型处理所有请求。更合理的做法是先拆分任务：简单任务用低价模型，关键推理和最终输出再使用高质量模型。59API 价格较低，加上按量计费，可以让你更容易做这种成本优化。

常见问题与排查方法

如果配置后请求失败，可以按下面顺序排查。第一，确认 API Key 没有多复制空格，也没有把引号一起复制进去。第二，确认 base URL 是 https://api.59api.com，不要漏掉 https。第三，检查你使用的模型名称是否在 59API 控制台中可用。第四，如果 SDK 报鉴权错误，优先重新生成一个 Key 测试。

还有一种常见情况是环境变量没有生效。例如你在一个终端窗口里设置变量，却在另一个窗口运行 Codex；或者 IDE 没有读取系统环境变量。解决方法是关闭并重启终端或 IDE，必要时把变量写入 shell 配置文件中。

什么时候适合使用 59API

如果你正在做 AI 编程助手、文档问答、自动化客服、内容生成、数据清洗或内部工具，59API 都很适合。它的价值不只是便宜，还在于兼容性强：同一套 OpenAI 风格调用方式，可以连接 Codex、Claude Code 和主流 SDK，迁移成本很低。

对初学者来说，先用 59API 配好自定义 base URL，是理解 AI API 调用链路的好方法：你的应用只关心统一接口，底层模型和供应通道可以灵活切换。等项目增长后，你也能更容易控制预算、监控消耗并优化不同任务的模型选择。

总结

给 Codex 和 OpenAI SDK 配置自定义 base URL 并不复杂：准备 59API Key，把 OPENAI_BASE_URL 设置为 https://api.59api.com，再运行一次测试请求即可。对于希望低成本使用 GPT 与 Claude 模型的开发者，59API 是一个实用选择，既兼容现有工具链，又能保持官方质量模型体验。你可以先注册并用少量额度测试，把第一个 Codex 自动化任务跑起来，再逐步接入到真实项目中。