跳转到主要内容
Codex CLI 可以通过环境变量或本地配置文件连接 APIAny.AI。适合在终端、编辑器和自动化开发流程中使用统一模型接口。

准备工作

  • 已安装 Codex CLI。
  • 已在 APIAny.AI 控制台 创建 API Key。
  • 已准备一个要使用的模型 ID。

安装

npm install -g @openai/codex

配置 API Key

~/.codex/auth.json 中写入:
{
  "OPENAI_API_KEY": "sk-xxxxxxxxxxxx"
}

配置 config.toml

~/.codex/config.toml 中添加:
model = "gpt-5.5"
model_provider = "apiany"

[model_providers.apiany]
name = "APIAny.AI"
base_url = "https://apiany.ai/v1"
wire_api = "responses"
requires_openai_auth = true
保存后重新打开终端,运行 codex 或执行一次测试:
codex "用一句话介绍你自己"

推荐模型

模型 ID适用场景
gpt-5.5适合复杂推理、编码和生产级工作流,优先推荐。
gpt-5.4适合高级对话、Agent 和通用生产任务。
gpt-5.4-mini速度、质量和成本均衡,适合日常高频使用。
gpt-4o-mini适合简单对话、翻译和轻量任务,速度快、成本低。
claude-sonnet-4-6适合 Claude 兼容配置的长文本、写作和编码任务。
gemini-3.5-flash适合 Gemini 兼容配置的快速多模态任务。

常见问题

返回 401 或认证失败

确认 API Key 已完整复制,前后没有多余空格,并且已经在 APIAny.AI 控制台中启用。

模型无法选择或调用失败

手动输入模型 ID,并确认该模型在 模型目录 中可用。不同工具可能不会自动拉取模型列表。

Base URL 应该怎么填

OpenAI 兼容配置通常使用 https://apiany.ai/v1;Claude 兼容配置通常使用 https://apiany.ai;需要完整接口地址的工具使用 https://apiany.ai/v1/chat/completions