三大核心编程工具

Codex CLI

本文介绍 Codex CLI 接入 EasyApi 的配置流程,包括所需条件、配置方法和连接验证。

1安装

需要 Node.js 22 或更高版本。已安装 Codex 的可跳过。

终端
npm install -g @openai/codex
codex --version

2推荐:CC Switch 一键导入

先安装 CC Switch,然后:

  1. 打开控制台 API 密钥,找到要用的 Key,点击该行的「CC Switch」。
  2. 在弹窗里选择「Codex」,浏览器会唤起 CC Switch 完成导入。
  3. 回到 CC Switch 的 Codex 页面,对本站供应商点「启用」。
  4. 进入项目目录运行 codex。

3可选:写入配置文件

Codex 通过 config.toml 指定自定义供应商。把 YOUR_API_KEY 换成你的密钥。

手动方式:顶层键放在 ~/.codex/config.toml 最前面,easyapi 段放在末尾,其他内容保留
model_provider = "easyapi"

[model_providers.easyapi]
name = "EasyApi"
base_url = "https://api.easyapi.cc/v1"
experimental_bearer_token = "YOUR_API_KEY"
wire_api = "responses"
requires_openai_auth = false
或复制这段到终端执行:自动合并并备份原文件为 config.toml.bak,不下载任何东西
node - <<'EOF'
const fs = require("fs"), path = require("path")
const file = path.join(require("os").homedir(), ".codex", "config.toml")
fs.mkdirSync(path.dirname(file), { recursive: true })
let lines = []
if (fs.existsSync(file)) {
  fs.copyFileSync(file, file + ".bak")  // 先备份原文件
  lines = fs.readFileSync(file, "utf8").split(/\r?\n/)
}
// 去掉顶层的 model_provider 和旧的 [model_providers.easyapi] 段,其他内容原样保留
let top = true, skip = false
lines = lines.filter(line => {
  const table = line.match(/^\s*\[([^\]]+)\]/)
  if (table) { top = false; skip = ["model_providers.easyapi", "model_providers.dtrading"].includes(table[1].trim()); return !skip }
  if (skip) return false
  return !(top && /^\s*(model_provider)\s*=/.test(line))
})
while (lines.length && !lines[0].trim()) lines.shift()
while (lines.length && !lines[lines.length - 1].trim()) lines.pop()
const head = ["model_provider = \"easyapi\"", ""]
const tail = ["", "[model_providers.easyapi]", "name = \"EasyApi\"", "base_url = \"https://api.easyapi.cc/v1\"", "experimental_bearer_token = \"YOUR_API_KEY\"", "wire_api = \"responses\"", "requires_openai_auth = false", ""]
fs.writeFileSync(file, [...head, ...lines, ...tail].join("\n"))
console.log("已安全合并至 " + file + " (已备份原文件为 config.toml.bak)")
EOF

字段说明

base_url 带 /v1;wire_api = "responses" 表示走 Responses 协议,Key 绑定的分组必须支持 OpenAI 协议。接入时不指定默认模型,保留客户端已有模型设置。

4可选:临时用一次

不改配置文件,通过命令行参数覆盖本次启动。先在当前终端设密钥,再在同一个终端启动:

1. 设置当前终端密钥
export EASYAPI_API_KEY='YOUR_API_KEY'
2. 在项目目录启动
codex -c 'model_provider="easyapi"' -c 'model_providers.easyapi.name="EasyApi"' -c 'model_providers.easyapi.base_url="https://api.easyapi.cc/v1"' -c 'model_providers.easyapi.env_key="EASYAPI_API_KEY"' -c 'model_providers.easyapi.wire_api="responses"' -c 'model_providers.easyapi.requires_openai_auth=false'

5验证

进入项目目录运行 codex,能读取项目并回复即接入成功。

  • 报 401 / 403 / 429 见 错误码。
  • 提示模型不可用:先到 模型广场 确认模型名,再检查 Key 绑定的分组是否支持 OpenAI 协议。
EasyApi Logo
EasyApi

一个接口接入 Claude、GPT 等主流 AI 模型,兼容 Anthropic / OpenAI 原生协议。

© 2026 EasyApi. All rights reserved.