在 Codex 里驱动 KwaFlux：MCP 配置、超时与审批

要点速览

• Codex 用一条 codex mcp add 命令，或者在 ~/.codex/config.toml 里加一张 [mcp_servers.kwaflux] 表，就能接入 KwaFlux。两种写法 KwaFlux 都会帮你生成。
• Codex 默认给每次 MCP 工具调用 60 秒，而 KwaFlux 的等待工具一次最多等 300 秒。把 tool_timeout_sec 调高，长视频任务才不会被半路掐断。
• 命令行方式不会加上 KwaFlux 的 TOML 里那行 20 秒启动超时。服务启动慢的话，手动补上。
• 借助 Codex 的审批模式，可以让只读的 KwaFlux 工具直接运行，写文件的任务仍先问你。

OpenAI 的 Codex 可以通过随 KwaFlux 一起安装的本地 MCP 服务来操作 KwaFlux。在 KwaFlux 的设置里选 Codex，复制安装命令或 TOML 表，加进 Codex，再保持 KwaFlux 开着就行。做视频时，有两个设置值得改：工具超时和审批模式。

本文会讲把 KwaFlux 加进 Codex 的两种方法、长任务要调的超时设置、怎么控制审批，以及先试哪些指令。

目录

1. Codex 怎么运行 MCP 服务
2. 开始之前
3. 方法一：codex mcp add
4. 方法二：编辑 config.toml
5. 长视频任务的超时
6. 审批与工具清单
7. 第一批指令
8. 问题排查
9. 常见问题

Codex 怎么运行 MCP 服务

每次会话开始时，Codex 会启动配置里列出的每个本地 MCP 服务，通过标准输入输出和它对话，服务的工具就和 Codex 自带的工具一起出现在模型面前。Codex 命令行和 Codex 桌面应用读的是同一份配置。

KwaFlux 的服务是随应用安装的一个 Node.js 脚本。它自己不处理任何东西，只把请求转给正在运行的 KwaFlux，由应用检查请求、执行任务。

开始之前

• KwaFlux 1.0.14 或更新版本，并且开着。
• Node.js 18 或更新版本，且在 PATH 中。 用 node --version 确认；没有就去 nodejs.org 装当前的 LTS 版本。KwaFlux 设置卡片也会查找 Node.js，并把它的完整路径写进配置，下面的示例就是这样；如果找不到，卡片会提示你，并改写成 node。
• 在 KwaFlux 里： 设置 › Agent（MCP），在 MCP 宿主 里选 Codex。

方法一：codex mcp add

点 复制安装命令，在终端里运行。Windows 默认安装位置对应的命令是：

codex mcp add kwaflux -- "C:\Program Files\nodejs\node.exe" "C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs"

我们用 Codex CLI 0.118.0 实际跑过，它输出了 Added global MCP server 'kwaflux'.。再确认一下：

codex mcp list

KwaFlux 应该显示为已启用。这条命令会在 ~/.codex/config.toml 里写一张只有 command 和 args 的表。值得手动补上的两行，往下看。

方法二：编辑 config.toml

也可以点 复制配置，把这张表追加到 ~/.codex/config.toml，或者受信任项目里的 .codex/config.toml：

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20

正如 KwaFlux 的提示所说：“键名是 mcp_servers（下划线）。”保存后重启 Codex，或者在会话里执行 /mcp 查看这个服务。

补充： 路径用单引号是有意的。在 TOML 里，单引号字符串是字面量，Windows 的反斜杠不需要转义；要是用双引号，每个反斜杠都得写成 \\。

长视频任务的超时

Codex 的 MCP 文档为每个服务列了两个超时：

第二个最要紧。Codex 让 KwaFlux 等一个导出时，等待工具会一直阻塞，直到任务结束或达到它自己的上限，最长 300 秒。如果 Codex 用默认的 60 秒，更长的等待会被 Codex 这一侧掐断，模型可能把它当成失败。这样设置：

[mcp_servers.kwaflux]
command = 'C:\Program Files\nodejs\node.exe'
args = ['C:\Program Files\KwaFlux\Tools\kwaflux-mcp\kwaflux_mcp.mjs']
startup_timeout_sec = 20
tool_timeout_sec = 330

不管怎样，任务都会在 KwaFlux 里继续跑。超时只是结束了那一次等待，Codex 可以再去查任务状态。

审批与工具清单

Codex 允许你按服务设定：工具运行前什么时候要问你。它的文档为 default_tools_approval_mode 列出了 auto、prompt、writes 和 approve 四种取值，其中 writes 会“对没有标为只读的工具弹出提示”。这正适合 KwaFlux：查状态、看任务列表直接放行，写文件的任务照样先问。

你还可以用 enabled_tools（允许清单）或 disabled_tools（禁止清单）缩小 Codex 加载的范围。比如你只拿 Codex 做转换和修复，就只列出任务、转换和修复相关的工具。工具少了，模型的上下文也能腾出更多空间，见我们的工具设计这篇。

第一批指令

查一下 KwaFlux 开着没有，再列出我最近的 KwaFlux 任务。

然后：

智能补帧，以及抠像和替换类工具，仍要在应用里做，助手会被告知把你引导过去。AI 发起下载默认关闭，要在 Agent 授权 里把 允许 Agent 发起下载 设为 每次确认。之后每次下载 KwaFlux 都会弹窗问你，助手也会在对话里请你确认有权下载那些内容。

问题排查

各个宿主都会遇到的问题，见 KwaFlux MCP 排障指南。

结语

用 KwaFlux 帮你复制好的命令或 TOML 把它加进 Codex，再补上两行：20 秒的启动超时，以及 330 秒的工具超时。如果希望 Codex 只在创建文件的任务前问你，就选 writes 审批模式。保持 KwaFlux 开着，先做一次状态检查。

在 Codex 里驱动 KwaFlux

KwaFlux 自带本地 MCP 服务，支持 Codex 等 MCP 应用。AI 处理在你自己的 GPU 上运行，媒体文件不会为了处理而上传。可在 Windows 10（64 位，1809 或更新版本）、Windows 11，以及搭载 Apple Silicon 的 macOS 12 或更新版本上运行。导入文件和浏览应用都不需要账号。仅在导出、转换、文件修复和从链接下载文件时需要登录并购买付费方案。

下载 KwaFlux · 查看方案