集成 · 智能体

在 Codex 中使用 DeepSeek、OpenRouter 等任意模型

Codex 是 OpenAI 的编程智能体,通过 Responses API 调用模型。AutoJev 在本地提供一个 Responses 端点,再把每个请求路由到你选定的模型;上游只支持 Chat Completions 或 Anthropic Messages 时,自动完成协议转换。

  • 一键写入 ~/.codex/config.toml
  • 入口 Responses,出口 Chat 或 Messages
  • 所选模型和路由汇总进同一个模型目录
  • 断开连接即恢复原配置

智能体

+ 智能体

CodexResponses

~/.codex/config.toml

已接入

Claude CodeMessages

~/.claude/settings.json

已接入

Gemini CLIGemini

~/.gemini/settings.json

已接入

OpenCodeChat

~/.config/opencode/opencode.json

接入

为什么 Codex 需要协议适配

Codex 发出的是 OpenAI Responses 格式的请求。而你想用的很多供应商——DeepSeek、大多数 OpenAI 兼容服务、Ollama——只支持 Chat Completions,还有一些只支持 Anthropic Messages。直接把 Codex 指过去是跑不通的。

AutoJev 在 http://127.0.0.1:9527/v1 上充当中间层。Codex 继续说 Responses,网关根据每个模型配置的上游 API 类型,对请求和流式响应做双向转换,覆盖函数工具、Responses 自定义工具、图片和用量统计。如果模型本身就支持 Responses,请求直接透传,不做转换。

转换按模型进行,所以可以自由混用供应商:一条路由从 OpenAI 模型故障转移到 DeepSeek 模型,Codex 完全感知不到协议变化。

AutoJev 会配置哪些内容

项目取值
配置文件~/.codex/config.toml
模型目录~/.codex/autojev-models.json(通过 model_catalog_json 引用)
供应商条目[model_providers.autojev],base_url 为 http://127.0.0.1:9527/v1
传输协议wire_api = "responses"
请求标记x-autojev-agent = "codex" 请求头,日志中可按智能体筛选
托管网页搜索web_search = "disabled"(Chat / Messages 模型不支持该工具)

仅检测不会改动任何文件。只有点击“连接”时 AutoJev 才会修改配置,并且会先备份原文件。

配置步骤

  1. 1

    安装 AutoJev

    下载 macOS、Windows 或 Linux 桌面版并打开,网关会在 http://127.0.0.1:9527 启动。

  2. 2

    添加供应商

    在“服务商”页选择 DeepSeek、OpenRouter、OpenAI、Ollama 等预设,或添加任意 OpenAI 兼容 / Anthropic 兼容端点。填入你自己的 API Key,并运行一次连通性测试。

  3. 3

    添加模型,按需创建路由

    添加模型并设置其上游 API 类型。如果希望由 AutoJev 按请求选模型,可以新建 fast、cheap 之类的路由,策略可选负载均衡或智能选择。路由对智能体显示为 autojev/<route-id>,单个模型显示为 <provider>/<model_id>。

  4. 4

    连接 Codex

    打开“智能体”页,只要 codex 在 PATH 中就会被自动检测到。勾选一个或多个模型 / 路由,指定默认项,点击“连接”。

  5. 5

    启动 Codex

    新开一个 Codex 会话。请求会经过 AutoJev,在“请求日志”中以 codex 标记显示,并路由到你选定的模型。

    bash
    codex

AutoJev 写入的配置

以下是 AutoJev 在 config.toml 中设置的键(以默认路由 autojev/fast 为例)。文件中的其他内容保持不变。

~/.codex/config.toml
# ~/.codex/config.toml — keys AutoJev writes on connect model = "autojev/fast" model_provider = "autojev" model_catalog_json = "/Users/you/.codex/autojev-models.json" web_search = "disabled" [model_providers.autojev] name = "AutoJev" base_url = "http://127.0.0.1:9527/v1" wire_api = "responses" [model_providers.autojev.http_headers] x-autojev-agent = "codex"

切换模型与路由

你在“智能体”页勾选的所有模型和路由都会写入 ~/.codex/autojev-models.json,默认项写入 model 键。想换默认模型或增删列表,在“智能体”页修改后重新连接即可;也可以用“批量更新配置”一次刷新所有已连接的智能体。之后重启 Codex,让它重新加载模型列表。

如果连接的是路由而不是单个模型,基本不需要再动 Codex:在 AutoJev 里调整路由的策略、候选模型或权重,下一个请求就会按新规则走。

恢复 Codex 原配置

点击“断开”、选择“停止并恢复配置”,或从托盘退出 AutoJev,都会还原 AutoJev 写入的键,并删除 autojev-models.json。连接之后你自己改过的值会被保留。下次启动时,除非你手动断开过,AutoJev 会自动重新连接 Codex。

使用限制

  • 协议转换无法给模型“补上”它本不支持的工具调用、视觉或推理能力——做编程任务请选择支持工具调用的模型。
  • 需要转换时,previous_response_id、托管工具以及音频 / 文件内容会被拒绝。
  • 转换过程中会丢弃推理(thinking)内容块。
  • 连接期间网关必须保持运行;暂停服务会拒绝新的请求。

常见问题

Codex 能用 DeepSeek 吗?

可以。在 AutoJev 中添加 DeepSeek 预设,添加 API 类型为 Chat Completions 的 DeepSeek 模型,再连接 Codex。AutoJev 会把 Codex 的 Responses 请求转换成 Chat Completions,并把响应转换回来。

怎么在 Codex 里用 OpenRouter 的模型?

用你的 OpenRouter Key 添加 OpenRouter 预设,添加需要的模型 ID,然后在“智能体”页为 Codex 勾选。每个模型在 Codex 中显示为 <provider>/<model_id>,也可以先把它们组合成一条路由。

连接后 Codex 还需要真实的 API Key 吗?

不需要。Codex 只和本地网关通信;供应商 Key 保存在 AutoJev 中,请求从你的电脑直连供应商,AutoJev 不加价。

为什么连接后网页搜索被关闭了?

托管搜索是 OpenAI 侧的工具,Chat Completions 和 Messages 模型上并不存在,所以 AutoJev 设置了 web_search = "disabled"。断开连接后会恢复你原来的值。

Codex 能用本地 Ollama 模型吗?

可以。添加 Ollama 预设(http://127.0.0.1:11434)和模型后连接即可。Codex 依赖函数调用,请选择支持工具调用的模型。

继续了解

更新于 2026-10-14

给每个智能体,配上合适的模型。

安装 AutoJev,添加你已有的模型服务商,一键接入智能体。所有数据都留在你的电脑上。

免费开源 · macOS · Windows · Linux