如果你同时使用多个 Codex 账号，或者需要在不同 API 之间切换，手动修改配置会比较麻烦。Codex Tools 提供了图形化的账号管理、用量查看、配置切换和 API 接入能力，可以把这些操作集中到一个界面中完成。
为什么要介绍接入deepseek呢？

1. deepseek最近推出了v4-flash 原生支持接入deepseek
2. 最近中转站不太稳定，我的plus额度用完之后，中转有时候会用不了，而有些内容比较着急时，暂时用deepseek代替
3. 使用deepseek和中转站不需要使用魔法，但是下载这个工具和codex还是需要魔法的

本文面向第一次使用 Codex Tools 的 Windows 用户，主要介绍：

1. 工具能解决什么问题；
2. 如何下载并安装；
3. 如何添加账号、查看用量和切换账号；
4. 如何接入 DeepSeek API；
5. 遇到常见错误时如何排查。

说明：本文截图是当前使用的版本。软件界面会随版本更新，按钮名称或布局可能略有变化，请优先根据功能名称和当前界面操作。

一、Codex Tools 能做什么

1. 账号切换方式

Codex-Tools 和cc-Switch 都可以直接在本地保存的账号列表切换账号，而不需要自己再去跳转官方登录一次，在添加账号时，可以选择加入本地保存的账号列表，下面会讲到。

cc-Switch 和 Codex Tools 都可以帮助切换配置，但实现方式不同：

• cc-Switch 主要通过写入环境变量切换 API；
• Codex Tools 主要通过修改 Codex 的账号和配置文件完成切换。

如果本机已经配置了与 Agent 相关的环境变量，环境变量方式可能会和现有配置互相影响。对我来说，使用配置文件切换更容易保持本地环境的一致性。

直接切换本机登录态时，工具通常会处理 Codex 相关的 auth.json 和 config.toml。在 Windows 中，这些文件一般位于：

%USERPROFILE%\.codex\auth.json
%USERPROFILE%\.codex\config.toml

切换前建议先备份重要配置，也不要把账号文件或 API Key 上传到公开仓库。

2. 常用功能

Codex Tools 适合以下场景：

• 管理多个 Codex 账号；
• 查看账号的 5h、1week 等用量窗口；（只不过最近Openai取消了五小时限额）
• 在账号额度不足时切换到其他可用账号；
• 接入 DeepSeek 或其他兼容 API；
• 启动本地 OpenAI 兼容 API 反代，供其他客户端调用。

这里的反代可以简单理解为：客户端请求先发送到本机的 Codex Tools，再由 Codex Tools 转发到上游服务。文档给出的本地接口示例是 http://127.0.0.1:8787/v1，实际端口以应用面板显示的值为准。

二、下载并安装 Codex Tools

1. 打开项目主页

项目地址：

Codex Tools GitHub 仓库

也可以直接打开下载页：

Codex Tools Releases

2. 选择系统版本

在 Releases 页面中选择与操作系统匹配的安装包。Windows 用户选择 Windows x64 版本即可；如果使用 macOS 或其他系统，请选择对应架构的版本。

下载完成后运行安装程序，按照向导完成安装，然后打开 Codex Tools。

建议从项目官方仓库或 Releases 页面下载，不要从不明来源获取安装包。

三、添加账号、查看用量与切换

1. 添加账号

打开 Codex Tools 后，进入账号管理页面，点击“添加账号”。

按照页面提示完成登录或导入账号。添加完成后，账号会出现在账号列表中。

2. 刷新用量

添加账号后，先刷新账号列表和用量信息。确认账号的剩余额度，再选择要使用的账号。

常见用量信息包括：

• 5h：短周期用量窗口；（不过现在 Openai已经取消了五小时限额）
• 1week：一周用量窗口；
• 当前账号的计划类型和可用状态。

3. 切换账号并启动 Codex

选择目标账号后，点击切换或启动按钮。建议按照下面的顺序操作：

1. 选择可用额度更充足的账号；
2. 点击切换；
3. 等待工具完成配置更新；
4. 启动 Codex，并发送一条简单的文本消息验证是否切换成功。

如果是直接修改本机 Codex 登录态，切换前应完全退出 Codex App 或 CLI，包括后台进程，而不只是关闭窗口。若使用的是 Codex Tools 的本地反代、wrapper 或绑定功能，则按当前面板提示操作，通常不需要关闭正在运行的 Codex。

四、接入 DeepSeek API

1. 创建 DeepSeek API Key

首先需要准备 DeepSeek API Key。如果还没有，可以打开 DeepSeek 官方 API Key 页面：

创建 DeepSeek API Key

登录后创建一个新的 API Key，并立即保存到密码管理器或其他安全位置。

API Key 等同于密码，请注意以下事项：

• 不要发布到博客、截图、GitHub 或聊天群；
• 不要直接写入公开项目的配置文件；
• 如果怀疑泄露，应立即在 DeepSeek 控制台禁用或重新生成。

2. 在 Codex Tools 中添加 API

返回 Codex Tools，进入 API 或 Provider 管理页面，点击“添加 API”，按照当前界面填写名称、Base URL、API Key 和模型等字段。

填写时注意：

• API 名称可以填写 DeepSeek，自定义的；
• API Key 填入刚刚创建的密钥，不要带多余空格；
• Base URL 和协议格式要按照当前界面说明及 DeepSeek 官方文档填写；
• 这是deepseek官方文档：首次调用 API | DeepSeek API Docs

接入中转站也同理，填写中转站提供的BaseURL和API Key，模型填写对应的

DeepSeek 当前同时提供 OpenAI 兼容接口和 Anthropic 兼容接口，二者的 Base URL 不相同。不要把两种协议的地址、鉴权方式或请求格式混在一起，具体以当前客户端的接入类型为准。

3. 保存并验证

保存好了之后，切换成deepseek的API，然后新建一个对话，询问简单的问题进行验证即可。

五、日常使用建议

1. DeepSeek 只认deepseek-v4-pro/flash，但切换供应商后，线程/定时任务里保存的还是gpt-5.6-sol ，会报错。就是之前用过gpt或其他模型的对话，不能用deepseek继续对话。

2. codex_app__automation_update 的 schema 是 type: null

   OpenAI/Codex 侧可能容忍某些“空参数工具”或内部工具 schema 写法，比如：

   {
     "name": "codex_app__automation_update",
     "parameters": {
       "type": null
     }
   }
   

   但 DeepSeek 对 tool/function calling 的 parameters 校验更严格。JSON Schema 的顶层 type 通常必须是合法字符串，例如：

   {
     "type": "object",
     "properties": {},
     "required": []
   }
   

   type: null 不是合法的 schema 类型写法。JSON Schema 里的 type 可以是 "object"、"string"、"number"、"boolean"、"array"、"null" 等字符串，或者字符串数组，但不能是 JSON 的 null 值。

   所以 DeepSeek 看到：

   "type": null
   

   会认为工具 schema 非法，直接拒绝整个请求。

   如果工具没有参数，也不要传 type: null，而是传空 object schema：

   "parameters": {
     "type": "object",
     "properties": {},
     "required": []
   }
   

3. 第三方 MCP 工具的 parameters 是 {} 或缺顶层 type

   这个问题更常见。很多 MCP server 暴露工具时可能返回类似：

{
  "name": "some_tool",
  "parameters": {}
}

或者：

{
  "name": "some_tool",
  "parameters": {
    "properties": {
      "url": {
        "type": "string"
      }
    }
  }
}

这些在宽松系统里可能还能跑，但 DeepSeek 会要求 parameters 是完整 JSON Schema，通常至少要有顶层：

"type": "object"

也就是说应该规范成：

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    }
  },
  "required": ["url"]
}

如果是无参数工具，则规范成：

{
  "type": "object",
  "properties": {},
  "required": []
}

所以接第三方 MCP 时，只要有一个工具的 schema 是 {}、type: null、缺 type、properties 类型不对、required 不是数组等，都可能让 DeepSeek 拒绝整个请求，而不是只忽略这个工具。

核心结论：
接 DeepSeek 时，需要在发送 tools 前做一层 schema normalization / validation。最少要保证每个工具的 parameters 都是：

{
  "type": "object",
  "properties": {},
  "required": []
}

这种合法形态。

对于第三方 MCP，不能直接信任原始 schema，最好统一修正或过滤非法工具。

六、常见问题排查

现象	可能原因	处理方式
401 或鉴权失败	API Key 错误、失效或带有空格	重新复制 Key，确认当前渠道和 Base URL 匹配
402 或余额不足	DeepSeek 账户余额不足	前往控制台检查余额和用量
429 或请求过快	触发限流	降低请求频率，等待后重试，必要时切换其他渠道
500 或 503	上游服务异常或过载	稍后重试，并检查官方服务状态
发送图片后持续报错	当前接入路径不支持图片	新建纯文本对话，确认模型和协议配置
切换模型后原对话报错	上下文与新 Provider 不兼容	新建对话，不要直接复用旧会话
切换账号后 Codex 仍显示旧账号	Codex 进程仍在运行	完全退出 Codex 后重新切换并启动