← Retour aux guides

8步把 Claude Code、Codex 等 AI CLI 指向自定义 API Base URL

把“Base URL”理解对：它不是官网地址

AI CLI 需要的是 API 服务入口，而不是产品官网或控制台链接。接入 59API 时，先使用 https://api.59api.com 作为 Base URL；是否需要由客户端自动补上 /v1，取决于该 CLI 的协议实现。不要凭习惯手动多加一层 /v1，否则很容易出现 404。

• OpenAI 兼容客户端通常请求 /v1/chat/completions、/v1/responses 或 /v1/models。
• Anthropic 兼容客户端通常请求 /v1/messages。
• 最稳妥的做法是先查看 59API 控制台的接入说明，再确认 CLI 实际发出的请求路径。

先创建独立 API Key，别混用生产密钥

在 59API 创建一个专门给本机 CLI 使用的 Key，并妥善保存。按环境、团队或项目分别创建密钥，后续排查额度、轮换泄露密钥和统计成本都会更简单。59API 按量计费，适合把日常编码、脚本生成和自动化任务拆分管理。

OpenAI 兼容 CLI：优先设置两个环境变量

多数 OpenAI 兼容 CLI、SDK 包装器和内部工具都会读取 OPENAI_API_KEY 与 OPENAI_BASE_URL。在 macOS 或 Linux 终端中，可先执行：export OPENAI_API_KEY="你的59API密钥"；export OPENAI_BASE_URL="https://api.59api.com"。然后在同一个终端会话启动 CLI，避免新变量没有被读取。

Codex 或其他基于 OpenAI 协议的命令行工具若支持配置文件，也可寻找 base_url、api_base 或 endpoint 字段。环境变量与配置文件同时存在时，要确认优先级；不少工具会让命令行参数覆盖配置文件，配置文件再覆盖环境变量。

Claude Code：使用 Anthropic 对应变量

Claude Code 这类 Anthropic 协议客户端，应设置 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL。例如：export ANTHROPIC_API_KEY="你的59API密钥"；export ANTHROPIC_BASE_URL="https://api.59api.com"。设置后重新启动 Claude Code，再发起一个简短任务验证即可。

如果你的版本没有读取 ANTHROPIC_BASE_URL，可运行 CLI 的 --help，搜索 endpoint、base-url、provider 或 environment 等选项。部分旧版本会把服务商地址写在 JSON、YAML 或 TOML 配置中，原则仍然相同：保留原有 API Key 字段，只替换请求入口。

不要猜模型 ID，先按控制台列表填写

Base URL 配对成功，不代表模型名一定正确。不同 CLI 可能默认调用固定模型，也可能要求手动传入 model 参数。请以 59API 控制台列出的可用模型 ID 为准，再选择 Claude Opus、Sonnet、Haiku、Fable 或 GPT 系列。模型名错误通常返回 400 或“model not found”，这和 Base URL 配错是两类问题。

用一次小请求定位 401、404 与 429

• 401 或 403：通常是 API Key 无效、变量未生效，或密钥前后多了空格。
• 404：通常是 Base URL 后重复拼接 /v1，或 CLI 使用了该中继未开启的接口路径。
• 400：优先检查模型 ID、请求格式，以及客户端是否发送了不兼容参数。
• 429：检查账户余额、并发限制和 CLI 的自动重试策略，不要无限重试。

建议先让 CLI 完成“用一句话解释当前目录结构”之类的小任务，再逐步开启长上下文、并行代理或批量脚本。这样可以更快判断是连接问题、模型问题还是工作流本身的问题。

把密钥放进安全位置，而不是提交进仓库

不要把 Key 写进 shell 脚本、项目配置或 Git 仓库。个人本机可放入 shell profile 或系统密钥链；团队环境更适合使用 CI/CD 的 Secret、密码管理器或部署平台的环境变量。提交前可用 git diff 检查，防止 .env 文件被误纳入版本控制。

为什么值得用 59API 作为自定义入口

对于需要频繁切换 Claude 与 GPT 的开发者，59API 提供统一入口、按量付费和很有竞争力的价格，同时保持原生官方质量，不需要为了节省成本接受模型降级。它兼容 Claude Code、Codex 和 OpenAI SDK，能减少迁移现有 CLI 工作流的配置成本；推荐返利机制也适合有协作推广需求的开发者。准备测试时，可以先注册 59API，创建小额度 Key，用一次真实 CLI 任务验证你的配置。

Tarifs · Docs