← Voltar aos guias

实战：让 Claude Code、Codex 等 AI CLI 指向 59API 自定义地址

先理解：AI CLI 实际只需要三项配置

无论是 Claude Code、Codex，还是团队内部封装的命令行工具，本质上都要知道三件事：API Key、模型名称和 Base URL。默认情况下，CLI 会请求官方地址；只要它支持环境变量或配置文件，就可以改为请求 59API。59API 的服务地址是 https://api.59api.com，提供按量付费的 Claude（Opus、Sonnet、Haiku、Fable）和 GPT 模型，并保持原生官方质量，适合希望控制开发成本的个人与团队。

开始前，请在 59API 控制台创建 API Key。不要把 Key 写进 Git 仓库、Shell 历史记录或前端代码；推荐先放进当前终端环境变量，确认可用后再写入安全的本地配置。

示例一：为 Claude Code 设置 59API 地址

macOS 和 Linux 终端中，先执行以下命令，再从同一个终端启动 Claude Code：

export ANTHROPIC_API_KEY="你的59API_KEY"

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

claude

Claude Code 会继续使用 Anthropic 协议，但请求将转发到 59API。模型名应使用 59API 控制台展示的可用标识；如果你的项目已在 Claude Code 配置中指定模型，通常无需改动。PowerShell 用户可使用：$env:ANTHROPIC_API_KEY="你的59API_KEY"；$env:ANTHROPIC_BASE_URL="https://api.59api.com"；claude。

若想长期生效，可将 export 命令写入 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc。注意：团队共享的 dotfiles 不应包含真实密钥，可以只保留变量名，并在本机通过密码管理器注入值。

示例二：让 Codex 使用 OpenAI 兼容接口

对于使用 OpenAI 兼容协议的 Codex 或其他 CLI，通常需要把 Base URL 指向带 /v1 的接口根路径：

export OPENAI_API_KEY="你的59API_KEY"

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

codex

部分 Codex 版本优先读取配置文件而非 OPENAI_BASE_URL。此时可在 ~/.codex/config.toml 中设置自定义供应商，关键字段是 model_provider、base_url、env_key 和 wire_api。base_url 填 https://api.59api.com/v1，env_key 填 OPENAI_API_KEY；wire_api 则按当前 Codex 版本要求选择 responses 或 chat。改完后重新打开终端，避免旧进程仍持有原来的环境变量。

示例三：用 OpenAI SDK 先做连通性验证

在把地址接入复杂 CLI 前，建议先用一个最小请求排除 Key、网络和模型名问题。Python 示例：

from openai import OpenAI

client = OpenAI(api_key="你的59API_KEY", base_url="https://api.59api.com/v1")

response = client.chat.completions.create(model="控制台中的模型标识", messages=[{"role":"user","content":"用一句话确认连接成功"}])

print(response.choices[0].message.content)

若该脚本返回正常内容，说明 OpenAI 兼容链路已通；随后把相同的 Key、Base URL 和模型标识复制到 CLI 即可。对于不确定协议的工具，先查看其 --help、README 或 config 命令：搜索 base_url、endpoint、api_url、OPENAI_BASE_URL、ANTHROPIC_BASE_URL 等字段。

常见错误与成本控制建议

• 404 或路径错误：Anthropic 协议通常使用 https://api.59api.com；OpenAI 兼容客户端通常使用 https://api.59api.com/v1。不要机械地给所有客户端重复添加 /v1。
• 401 未授权：确认 CLI 启动时读取的是新 Key，并检查是否有同名旧环境变量覆盖它。
• 模型不存在：不要猜测模型 ID，以 59API 控制台列出的名称为准。
• 费用难以追踪：为不同项目创建独立 Key，并在测试阶段限制并发和最大输出长度。

59API 的按量计费模式很适合先小规模验证，再逐步迁移日常编码工作流；其较低成本、原生模型能力和推荐返利机制，也能让长期使用更易预算。现在可以注册 59API，创建一个测试 Key，用上面的最小示例验证你的 AI CLI 自定义 Base URL。

Preços · Docs