Vmvia API

外观

Codex CLI 配置参考 ​

本页用于手动配置、模型参数说明和排障。日常使用默认推荐先看 CC Switch 统一配置。

配置方式一：CC Switch（默认推荐） ​

CC Switch 是最简单的配置方式，自动写入 config.toml 和 auth.json，无需手动编辑文件。

配置步骤：

  1. 打开 CC Switch，框架选 Codex，点击「添加配置」
  2. 预设供应商选 「自定义配置」，请求地址填 https://www.vmvia.com/v1
  3. 填写 API Key（sk-xxx），model 填 gpt-5.6-sol
  4. 点击添加，应用后重启终端

令牌设置：创建或编辑 API 令牌时，请关闭「模型限制」，限制令牌可调用的模型有时会引发未知异常。

配置方式二：手动编辑配置文件 ​

文件位置 ​

系统config.tomlauth.json
Windows%USERPROFILE%\.codex\config.toml%USERPROFILE%\.codex\auth.json
macOS / Linux~/.codex/config.toml~/.codex/auth.json

config.toml ​

toml
model_provider = "vmvia"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.vmvia]
name = "vmvia"
base_url = "https://www.vmvia.com/v1"
wire_api = "responses"
requires_openai_auth = true

Codex 的 Base URL 需要 /v1 后缀，与 Claude Code 不同。主站不通时可把 base_url 换成 https://api.vmvia.com/v1。

1M 上下文配置 ​

如果你使用的模型支持长上下文，建议同时确认以下两项。注意：这两个参数必须写在顶层，不能写在 [model_providers.vmvia] 供应商配置下：

toml
model_context_window = 1000000
model_auto_compact_token_limit = 900000
参数作用
model_context_window将可用上下文窗口设为 1,000,000
model_auto_compact_token_limit接近上限前提前触发压缩，避免对话直接撞满

如果你通过 CC Switch 一键写入配置，优先以 CC Switch 生成结果为准；只有在手动排障时才建议自己改 config.toml。

auth.json ​

json
{
  "OPENAI_API_KEY": "sk-xxx"
}

配置参数说明 ​

参数说明可选值
model_provider模型提供商标识自定义名称，需与 [model_providers.*] 一致
model使用的模型见下方模型列表
model_reasoning_effort推理深度low / medium / high
disable_response_storage禁用响应存储true（推荐）
wire_apiAPI 协议responses

支持的模型 ​

列表核对于 2026-09-28。后续以 模型广场 为准。

模型可用分组用途
gpt-5.6-solcodex / codex-wending主会话模型（推荐）
gpt-6-astracodex / codex-wending主会话模型，能力更强、价格更高
gpt-6-solcodex / codex-wending主会话模型，价格最低
分组用途可用模型倍率
codex
Codex 专用
Codex CLI / Codex 桌面端 / 外接 Codex，纯 Pro 号池
站点说明：codex专用分组（纯pro号池）
gpt-5.6-sol、gpt-6-astra、gpt-6-sol0.2x
codex-wending
Codex 稳定版
与 codex 分组相同模型，线路更稳定，倍率略高
站点说明：codex稳定专用分组（纯pro号池）
gpt-5.6-sol、gpt-6-astra、gpt-6-sol0.35x

自动审批设置 ​

Codex 在后台会用一个独立的审批模型判断受限操作。如果它请求的模型不在你的分组里，或者被限速，就会出现审批反复失败。可以关闭审批请求，或把审批模型映射到分组内可用模型。

方式一：关闭审批请求 ​

在 Codex 桌面端中，按截图中的编号操作：

  1. 搜索设置：打开设置，在左侧搜索框输入「审批」。
  2. 进入配置：点击搜索结果中的「从不请求审批」。
  3. 展开批准策略：在「配置」→「智能体默认设置」中，点击「批准策略」下拉框。
  4. 选择从不请求审批：将策略设为「从不请求审批」，然后新建会话再试。

Codex 设置中搜索审批，并将批准策略设为从不请求审批的四步操作

CLI 用户可以直接用参数启动：

bash
codex --ask-for-approval never

「从不请求审批」表示受限操作会直接失败，不再发起审批请求；该选项不会自动放宽沙盒权限。

方式二：保留自动审批并映射模型 ​

如果接入服务或代理支持模型映射，可将自动审批请求实际使用的模型映射到 codex 分组内的模型，例如 gpt-5.6-sol。映射入口以所用服务或代理为准。

请针对审批请求使用的模型设置映射，仅修改主会话的 model 不能保证后台审批也改用同一模型。

常见问题 ​

会话异常时创建聊天分支 ​

如果使用 Codex 桌面端时出现会话异常，先新开一个会话测试。新会话正常时，再为原会话创建聊天分支：

  1. 右键当前会话：在左侧会话列表中，右键点击出现异常的会话。
  2. 展开分叉菜单：在右键菜单中选择「分叉」。
  3. 创建聊天分支：点击「创建聊天分支」，进入新分支后重试刚才的操作。

Codex 会话异常时，右键会话后通过分叉菜单创建聊天分支

如果新会话也报错，继续核对配置；遇到请求发往官方地址的 401，按 配置或旧会话导致 401 的排查步骤 处理。

Base URL 格式问题 ​

工具Base URL 格式
Claude Codehttps://www.vmvia.com（不带 /v1）
Codexhttps://www.vmvia.com/v1（带 /v1）

外接调用返回 403 block？ ​

如果你不是直接使用官方默认链路，而是把 Codex 接到第三方平台、网关、自定义客户端或其他外接场景，除了 Base URL 和 API Key 之外，还要同时满足：

  1. 使用 Codex 对应分组 codex 或 codex-wending
  2. 请求头中携带 Codex 对应的 User-Agent

示例：

json
{
  "Authorization": "Bearer sk-xxx",
  "User-Agent": "codex_cli_rs/0.77.0 (Windows 10.0.26100; x86_64) WindowsTerminal"
}

缺少对应 UA 时，常见报错就是 403 block 或 403 Forbidden。

如果你外接的不是 Codex，而是其他模型分组，例如国产模型分组 国模，也同样需要按对应类型补 User-Agent；不要把「只有 Codex 才要 UA」当成通用规则。

API Key 无效？ ​

  1. 检查 ~/.codex/auth.json 中的 Key 是否正确
  2. 确认账户余额充足
  3. 确认令牌未过期、分组为 codex 或 codex-wending

推理速度慢？ ​

将 model_reasoning_effort 从 high 改为 medium 或 low，响应速度可显著提升。

同时使用 Claude Code 和 Codex？ ​

两者配置文件独立，互不冲突。使用 CC Switch 可统一管理：

  • Claude Code → ~/.claude/settings.json
  • Codex → ~/.codex/config.toml + ~/.codex/auth.json

外接分组与 UA 的统一说明见 外接调用 User-Agent 说明。

Vmvia API · 售后 QQ 群 1033966199

Copyright © 2026 vmvia.com