1. 为什么要在终端里校对 WPS 稿子
Codex CLI 是我终端里常驻的工具，平时主要拿它写脚本、查日志、跑一些重复性的文本处理。但有个场景一直让我觉得割裂：稿子本身在 WPS 里，校对却要切到浏览器或者另一个编辑器里复制粘贴。尤其是会议纪要、英文说明文档这类需要逐段核对的东西，来回切换窗口的损耗比校对本身还大。
后来我换了个思路：既然 Codex CLI 支持 MCP 服务，而 WPS 又有本机加载项，那能不能让 Codex CLI 直接读到当前打开的 WPS 文档，然后用一个斜杠命令触发校对？实测下来这条路是通的，而且配置比想象中简单——一份config.toml加一个斜杠命令文件就够了。
这篇要讲的就是这套落地配置。核心是三件事：第一，在~/.codex/config.toml里接入 TaoToken 的统一 Key/API 通道，让 Codex CLI 的模型请求走一个稳定入口；第二，注册一个 MCP 服务指向本机 WPS 加载项；第三，写一个斜杠命令文件当"操作手册"，在会话里手动引入校对纪律。适合已经在用 Codex CLI、又经常和 WPS 文档打交道的人，尤其是需要做保密自查、英文校对、会议纪要提取行动项这类重复劳动的同学。
需要提前说明的是，这套链路要求 Codex 会话和 WPS 在同一台机器上，因为 MCP 服务只在127.0.0.1监听。远程开发机上跑 Codex 的话这条链路通不了，得另想办法。下面按配置顺序一步步来。
2. TaoToken 前置：统一 Key 与 API 通道
Codex CLI 默认走 OpenAI 的接口，但很多时候我们需要一个统一的入口来管理 Key、切换模型、控制成本。TaoToken 在这里扮演的就是这个角色——它提供一个兼容的 API 通道，你只需要在config.toml里把 base URL 指过去，Key 换成 TaoToken 的，Codex CLI 的其他使用习惯完全不变。
先拿到 Key。打开 TaoToken 控制台，在 API Keys 页面创建一个新 Key，复制出来。这个 Key 后面要写进config.toml，所以别弄丢。控制台地址是 https://taotoken.net/console ，创建 Key 的入口在 https://taotoken.net/api-keys 。
拿到 Key 之后，先确认 Codex CLI 本身能跑起来。终端里执行：
codex --version如果提示找不到命令，说明 Codex CLI 还没装。装好之后，先别急着配 MCP，先把模型通道跑通。这一步很关键，因为后面校对功能里涉及模型推理的部分（比如英文语法检查、翻译）都依赖这个通道。如果模型没配好，文档类工具能调，但涉及推理的校对会报错。
TaoToken 的 API 地址是 https://taotoken.net/api ，注意这个地址不带任何查询参数，直接作为 base URL 用。Key 的格式通常是sk-开头的一串字符。把这两个信息记下来，下一步写进配置。
3. 可复制配置：config.toml 骨架与斜杠命令
3.1 config.toml 的模型通道配置
~/.codex/config.toml是 Codex CLI 的主配置文件。如果你之前没动过它，可能只有几行默认内容。我们要做的是追加两段：一段是模型通道，一段是 MCP 服务。
先看模型通道部分。在文件里加入：
model_provider = "taotoken" model = "gpt-4o" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"这里model填你想用的模型名，base_url固定指向 TaoToken 的 API 地址。env_key表示 Key 从环境变量读取，这样不会把 Key 硬编码在配置文件里。然后在 shell 的启动文件里加上：
export TAOTOKEN_API_KEY="sk-你的Key"Windows PowerShell 的话用：
$env:TAOTOKEN_API_KEY="sk-你的Key"想永久生效就写进系统环境变量。配好之后，新开一个终端，跑一次简单请求验证：
codex exec "用一句话说明什么是 TOML 格式"如果能看到模型返回内容，说明通道通了。这一步没过就别往下走，后面所有校对都依赖它。
3.2 追加 MCP 服务指向 WPS 加载项
WPS 那边需要一个本机加载项来暴露文档内容。安装脚本会检测~/.codex目录，如果存在就往config.toml追加一段 MCP 配置。追加的内容长这样：
[mcp_servers.chayuan-wps-mcp] url = "http://127.0.0.1:62588/mcp"这段的意思是：Codex CLI 启动时，会去连接本机 62588 端口的 MCP 服务，这个服务由 WPS 加载项提供。注意它是追加写入的，脚本会先查重，不会重复添加。如果你手工编辑过config.toml，要保证 TOML 格式合法，别多一个引号或者少一个方括号，否则 Codex CLI 启动时会直接报解析错误。
MCP 服务只在127.0.0.1监听，不带 token 认证。这意味着它只对本机可见，安全性上没问题，但也意味着 Codex 会话和 WPS 必须在同一台机器上。远程开发机上跑 Codex 的同学，这条链路通不了。
3.3 斜杠命令文件：Codex 版的"技能"
Codex CLI 没有 Claude Code 那种自动加载技能目录的机制，所以接 WPS 文档智能体的方式比较直接：配一个 MCP 服务，再加一个提示词文件当操作手册。安装脚本会往~/.codex/prompts/放一个wps-skill-chayuan.md，这个文件就是 Codex 版的"技能"。
它的作用是在会话里通过斜杠命令手动引入。文件本身是普通 markdown，你可以按自己的习惯改。比如把常用的校对开场白直接写进去，省得每次新会话都重新敲一遍。文件内容大致包含操作纪律、批注模式说明、从后往前插入翻译的顺序要求等。
斜杠命令的触发方式是/wps-skill-chayuan，敲完之后提示词文件的内容会被加载进当前会话上下文。这跟 Codex 本身的使用习惯是一致的——它不自动加载，靠你手动引入。
4. 验证请求与成功结果
配置写完，先做冒烟测试。开一个新会话，敲：
/mcp看服务列表里有没有chayuan-wps-mcp。如果有，说明 MCP 连接正常。然后在 WPS 里随便打开一份文档，回到 Codex 会话里敲：
/wps-skill-chayuan这会把操作纪律加载进来。接着发一条只读指令：
读取当前文档标题和前两段，只读冒烟，不写批注不改正文。如果回显的标题和段落内容跟 WPS 里对得上，说明整条链路通了。这一步只读不写，不会动你的文档，可以放心测。
冒烟通过之后，就可以试真实校对场景了。比如会议纪要：
从当前文档提取行动项和风险，行动项写明责任人和期限，风险单列。先以清单形式给我预览，确认后用批注挂在对应段落上。它会先列清单，你删掉不靠谱的条目，再说"按剩下的写批注"。批注模式原文不动，发出去给人核对很干净。
英文材料处理也是类似。逐段检查拼写语法：
逐段检查这份英文文档的拼写语法，输出问题清单，每条带原文片段和修改建议。只预览。中文稿翻英文则是：
把当前文档逐段翻译成英文，译文插到各段后面，从最后一段开始往前插，先预览两段给我确认风格。从后往前这个顺序有讲究：从前往后插，每插一段后面的锚点就变了，容易串段。提示词文件里写了这条，它自己会执行，但知道原理更放心。
保密自查也常用：
对当前文档做保密检查，重点手机号、身份证号、内部系统名称，命中项先列清单。确认后可以走脱密，占位符替换是可逆的，密码自己设。
5. 本篇常见错排查
5.1 MCP 服务列表里没有 chayuan-wps-mcp
先确认 WPS 加载项是否在运行。MCP 服务由加载项提供，加载项没起来的话 62588 端口是空的。可以在终端里测一下端口：
curl -s http://127.0.0.1:62588/mcp如果连接被拒绝，说明服务没起。重启 WPS，或者重新跑一遍安装脚本的--fetch参数。另外确认config.toml里那段[mcp_servers.chayuan-wps-mcp]确实写进去了，有时候手工编辑会把这段覆盖掉。
5.2 模型推理类校对报错
文档类工具能调，但涉及模型推理的校对报错，通常是模型通道没配好。检查TAOTOKEN_API_KEY环境变量是否在当前 shell 里生效：
echo $TAOTOKEN_API_KEY如果输出为空，说明环境变量没加载。新开终端或者手动 export 一次。另外确认config.toml里的base_url是https://taotoken.net/api，不要多加斜杠或者路径。
5.3 TOML 解析错误导致 Codex CLI 起不来
手工编辑过config.toml的话，最容易出的问题是格式不合法。TOML 对引号和方括号很敏感。一个快速检查办法是用 Python 解析一遍：
python3 -c "import tomllib; tomllib.load(open('$HOME/.codex/config.toml','rb')); print('ok')"如果报错，根据提示行号去改。常见错误包括：字符串没加引号、表头少了一个方括号、键值对之间少了等号。
5.4 斜杠命令每次新会话都要敲
这是 Codex CLI 的设计，不是 bug。它没有自动加载技能目录的机制，所以每次新会话都要手动/wps-skill-chayuan一次。嫌烦的话把常用校对开场白直接写进提示词文件，按自己的习惯改~/.codex/prompts/wps-skill-chayuan.md，那是个普通 markdown，改完下次会话就生效。
5.5 远程开发机上跑 Codex 连不上
MCP 服务只在127.0.0.1监听，远程开发机和本机 WPS 不在同一台机器上，这条链路通不了。这种情况得想别的办法，比如把文档同步到开发机再用纯文本方式处理，或者在本机跑 Codex 会话。这不是配置问题，是架构限制。
6. 把校对流程固化下来
整套配置跑通之后，我自己的用法是把校对流程拆成几个固定动作：先/wps-skill-chayuan引入纪律，再发只读冒烟确认链路，然后按场景发校对指令。会议纪要、英文校对、保密自查这三个场景用得最多，基本可以覆盖日常文档处理的大部分重复劳动。
如果你主要做长期编码或者 Agent 类任务，可以考虑 Coding Plan，把模型调用和额度管理统一起来：https://taotoken.net/coding-plan 。如果只是想先验证模型对话效果，模型对话页面可以直接试：https://taotoken.net/chat 。接入过程中遇到 Key 或者通道问题，先看接入文档：https://taotoken.net/doc ，大部分配置细节那里都有。
最后提醒一句：config.toml是追加写入的，脚本会先查重，不会重复添加。但如果你手工编辑过这个文件，保持 TOML 格式合法，别多一个引号。模型配置不在这套技能里，TaoToken 的设置界面里配对话模型，云端 API 或者内网兼容端点都行。模型没配的话，文档类工具能调，但涉及模型推理的校对会报错，提示还挺明确。
