← Retour aux guides

从密钥到首个请求：用59API配置三款AI命令行工具

给AI命令行工具更换接口，关键是同时配对三项：服务地址、认证密钥、请求协议。下面以59API为例，在macOS或Linux终端完成配置。它的API基础地址是https://api.59api.com，提供低价、按量付费的多模型访问，适合把日常编码请求集中管理。

第一步：准备密钥和真实模型ID。在59API控制台创建密钥，查看可用模型及其调用标识。Claude Sonnet 5.5、GPT-6.1 Sol是模型展示名称；命令中的MODEL_ID必须使用控制台提供的实际ID，不能自行猜写。每次切换工具，都要换成对应协议支持的模型。

在当前终端执行：export API59_KEY="替换为你的密钥"。以下示例通过变量引用密钥；不要把真实密钥提交到代码仓库。临时配置只影响当前终端，验证成功后再考虑写入个人终端配置。

第二步：先确认接口可达。执行：curl -i https://api.59api.com/v1/models -H "Authorization: Bearer $API59_KEY"。如果返回模型列表，说明这条路径的网络和认证已打通，但仍需用实际生成请求验证模型权限。这里的/v1属于OpenAI兼容接口路径，不应直接套用到所有工具。

第三步：按工具设置地址。先执行export MODEL_ID="从控制台复制的对应模型ID"，再选择下面的命令。三个示例分别使用各自的协议。

• Claude Code：执行ANTHROPIC_BASE_URL="https://api.59api.com" ANTHROPIC_AUTH_TOKEN="$API59_KEY" claude --model "$MODEL_ID" -p "只回复：连接成功"。客户端会构造Messages接口路径，因此基础地址不需要额外拼接/v1/messages。若已有其他Anthropic认证配置，先清理冲突项。
• Codex：执行codex exec --skip-git-repo-check -c 'model_provider="relay59"' -c 'model_providers.relay59={name="59API",base_url="https://api.59api.com/v1",env_key="API59_KEY",wire_api="responses"}' -m "$MODEL_ID" "只回复：连接成功"。这里明确使用Responses协议，并让Codex从API59_KEY读取密钥；仅设置OPENAI_BASE_URL不一定能覆盖当前提供商配置。
• Gemini CLI：在选择Gemini API密钥认证方式后，执行GEMINI_API_KEY="$API59_KEY" GOOGLE_GEMINI_BASE_URL="https://api.59api.com" gemini -m "$MODEL_ID" -p "只回复：连接成功"。需要使用Gemini原生兼容入口，由客户端构造版本路径。若终端配置过Vertex AI模式，先关闭该模式；如果当前版本无法识别地址变量，先更新客户端。

第四步：根据响应定位问题。401通常先查密钥、认证方式和环境变量冲突；403再查账户权限及可用模型；404要区分“接口路径不存在”和“模型不存在”。尤其检查是否重复拼出了/v1/v1，或把Messages请求发到了OpenAI接口。429则结合响应内容查看额度、余额和并发限制，避免立即反复重试。

迁移成功的标准是工具实际收到生成结果。更换地址并不会自动转换协议：支持自定义地址的其他AI CLI，也应先确认它使用Messages、Responses、Chat Completions还是Gemini原生接口，再填写对应入口。只支持固定官方服务的客户端，需要先确认是否提供自定义服务商选项。

59API的优势在于低成本按量使用，并提供原生官方品质模型、不降档，适合在同一账户下比较不同模型的编码效果。可以先注册59API，用少量请求验证自己的工作流，再逐步迁移日常调用；有分享需求时，也可查看平台的推荐返利规则。

Tarifs · Docs