核心编程工具
Codex CLI
本文介绍 Codex CLI 接入 KeyVia 的配置流程，包括所需条件、配置方法和连接验证。
1安装
需要 Node.js 22 或更高版本。已安装 Codex 的可跳过。
终端
npm install -g @openai/codex
codex --version2配置接入
示例中的 YOUR_API_KEY 是占位符，直接复制无法使用。登录后可选择自己的密钥，自动填入本页全部示例。
登录后填入密钥Codex 通过 config.toml 指定自定义供应商。把 YOUR_API_KEY 换成你的密钥，或在页面顶部选择密钥自动填入。
手动方式：顶层键放在 ~/.codex/config.toml 最前面，keyvia 段放在末尾，其他内容保留
model_provider = "keyvia"
[model_providers.keyvia]
name = "KeyVia"
base_url = "https://api.keyvia.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.keyvia] 段，其他内容原样保留
let top = true, skip = false
lines = lines.filter(line => {
const table = line.match(/^\s*\[([^\]]+)\]/)
if (table) { top = false; skip = ["model_providers.keyvia", "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 = \"keyvia\"", ""]
const tail = ["", "[model_providers.keyvia]", "name = \"KeyVia\"", "base_url = \"https://api.keyvia.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)")
console.log("配置完成，请进入你的项目目录，输入 codex 即可使用。")
EOF字段说明
base_url 带 /v1；wire_api = "responses" 表示走 Responses 协议，Key 绑定的分组必须支持 OpenAI 协议。接入时不指定默认模型，保留客户端已有模型设置。