尧图网页设计 
1. 为什么我会用 codex 去控制 Word先说清楚这篇要解决的事codex 控制 word指的是让 codex 这类 AI 编码工具通过统一的 API 通道去调用 Python 脚本操作 Word 文档完成标题、段落、表格的生成与编辑。它不是让 AI 直接打开 Word 界面点按钮而是让 codex 帮你写并执行python-docx脚本最终产出一个.docx文件。适合谁需要批量生成报告、周报、合同模板、论文格式文档的开发者已经在用 codex 写代码但每次调用模型都要换 Key、换地址、改配置觉得麻烦的人以及想把AI 生成内容和落成 Word 文件串成一条流水线的人。我自己的痛点是codex 默认走官方通道配置散落在多个文件里模型名、base_url、api_key 三处对不上就报 401 或 404。后来我把所有请求收敛到 TaoToken 一个 Key 上codex 的config.toml只写一份Word 脚本里读环境变量链路一下就干净了。下面把可复制的配置骨架、Word 操作指令模板、以及一次端到端验证动作完整给你。核心检索词先摆出来codex 控制 word 的本质是codex 生成并运行 python-docx 脚本TaoToken 负责提供统一的模型 API 通道config.toml负责把 codex 指向这个通道。2. TaoToken 前置统一 Key 与通道准备TaoToken 在这里的角色是统一入口你只维护一个 API Key 和一个 base_urlcodex、脚本、其他工具都指向它不用为每个模型单独配一套凭证。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 这个不加 UTM。第一步拿到 Key。进入控制台创建 API Key建议按用途命名比如codex-word方便后面排查是哪个 Key 出的问题。创建入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第二步确认你要用的模型名。codex 类工具通常需要一个对话/补全模型来生成脚本内容。你可以在模型对话页先手动问一句确认通道通、模型名对https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。这一步别省很多人后面 404 就是因为模型名写错。第三步把 Key 放进环境变量而不是硬编码进config.toml。这样脚本和 codex 共用一份凭证也不会把 Key 提交到 git。# Linux / macOS export TAOTOKEN_API_KEYsk-你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/api # Windows PowerShell $env:TAOTOKEN_API_KEYsk-你的Key $env:TAOTOKEN_BASE_URLhttps://taotoken.net/api注意config.toml里引用环境变量时不同 codex 版本语法略有差异有的用${VAR}有的用env:VAR。下面骨架给的是通用写法若你的版本不识别改成直接读环境变量的启动脚本即可。3. 可复制的 config.toml 配置骨架codex 的配置文件一般放在~/.codex/config.tomlWindows 是%USERPROFILE%\.codex\config.toml。下面这份骨架把 base_url、Key、模型名集中管理Word 脚本通过同一套环境变量读取保证一处改、处处生效。# ~/.codex/config.toml # codex 控制 word 的统一通道配置骨架 # 默认使用的模型提供方 model_provider taotoken # 模型名按你在模型对话页确认的写 model 你的模型名 # 关闭遥测减少无关请求 disable_telemetry true [model_providers.taotoken] # 统一 API 根地址注意结尾不带 /v1 时按你的工具要求补 base_url https://taotoken.net/api # 从环境变量读取 Key避免明文 env_key TAOTOKEN_API_KEY # 走 OpenAI 兼容协议 wire_api chat # 给 Word 脚本用的自定义段codex 执行时可读取 [word] output_dir ./output default_font 宋体 default_size 12配套的 Python 侧读取逻辑保证脚本和 codex 用同一个 base_url 与 Key# word_config.py import os API_KEY os.environ.get(TAOTOKEN_API_KEY) BASE_URL os.environ.get(TAOTOKEN_BASE_URL, https://taotoken.net/api) def check(): if not API_KEY: raise RuntimeError(TAOTOKEN_API_KEY 未设置请先 export) print(base_url , BASE_URL) print(key 前缀 , API_KEY[:6] ***) if __name__ __main__: check()跑一下python word_config.py能打印出 base_url 和 Key 前缀说明环境变量这一层通了。这一步是后面所有操作的地基别跳过。4. Word 操作指令模板与脚本codex 控制 Word 的落点是python-docx。先装依赖pip install python-docx下面是一个可复用的脚本模板包含加标题 加段落 加表格三个动作你可以把它当成 codex 生成内容的执行器。codex 负责产出文本和表格数据脚本负责写进 docx。# make_docx.py from docx import Document from docx.shared import Pt from docx.enum.text import WD_ALIGN_PARAGRAPH def build_docx(title: str, paragraphs: list, table_rows: list, out_path: str): doc Document() # 标题 h doc.add_heading(title, level1) h.alignment WD_ALIGN_PARAGRAPH.CENTER # 段落 for text in paragraphs: p doc.add_paragraph(text) for run in p.runs: run.font.size Pt(12) # 表格第一行当表头 if table_rows: cols len(table_rows[0]) table doc.add_table(rows1, colscols) table.style Table Grid for i, cell in enumerate(table.rows[0].cells): cell.text str(table_rows[0][i]) for row in table_rows[1:]: cells table.add_row().cells for i, val in enumerate(row): cells[i].text str(val) doc.save(out_path) print(saved:, out_path) if __name__ __main__: build_docx( titlecodex 控制 Word 验证文档, paragraphs[ 本文档由 codex 生成脚本、python-docx 落盘。, 用于验证 TaoToken 统一 Key 通道是否跑通。, ], table_rows[ [项目, 值], [通道, TaoToken], [工具, codex], [输出, docx], ], out_path./output/verify.docx, )如果你想让 codex 直接生成这段内容可以在 codex 里下这样的指令模板请生成一个 python-docx 脚本要求 1. 添加一级标题居中 2. 添加两段正文字号 12 3. 添加一个 3 列 4 行的表格带表头样式 Table Grid 4. 保存到 ./output/report.docx。 只输出完整可运行代码不要解释。这个模板的好处是约束明确标题、段落、表格、保存路径四要素齐全codex 不容易跑偏。实测下来把只输出完整可运行代码写进去能省掉大量手动删解释的时间。5. 端到端验证生成含标题与表格的 docx 并校验现在做一次完整验证。目标生成一个含标题和表格的 docx然后读回来校验内容是否真的写进去了。第一步建目录并运行脚本mkdir -p output python make_docx.py预期输出saved: ./output/verify.docx第二步写一个校验脚本把 docx 读回来检查标题、段落数、表格行列数# verify_docx.py from docx import Document doc Document(./output/verify.docx) # 校验标题 headings [p.text for p in doc.paragraphs if p.style.name.startswith(Heading)] print(标题:, headings) assert headings and headings[0] codex 控制 Word 验证文档, 标题不匹配 # 校验段落 paras [p.text for p in doc.paragraphs if p.text and not p.style.name.startswith(Heading)] print(段落数:, len(paras)) assert len(paras) 2, 段落数不足 # 校验表格 assert len(doc.tables) 1, 表格数量不对 t doc.tables[0] print(表格尺寸:, len(t.rows), x, len(t.columns)) assert len(t.rows) 4 and len(t.columns) 3, 表格尺寸不对 assert t.rows[0].cells[0].text 项目, 表头不对 print(校验通过)运行python verify_docx.py成功结果应该类似标题: [codex 控制 Word 验证文档] 段落数: 2 表格尺寸: 4 x 3 校验通过到这里codex 控制 word的完整链路就跑通了codex 生成脚本 → 脚本读 TaoToken 统一配置 → python-docx 落盘 → 读回校验。整个过程没有手工打开 Word也没有在多个 Key 之间来回切。如果你还想让 codex 在生成内容时调用模型比如自动写报告正文把模型请求也指向同一个 base_url 即可Key 复用环境变量不用再配第二套。6. 本篇常见错排查报错一401 Unauthorized。九成是 Key 没读到。先跑python word_config.py看 Key 前缀能不能打印。如果打印为空说明环境变量没生效注意 PowerShell 和 bash 的 export 语法不同且新开终端要重新 export。报错二404 Not Found。通常是 base_url 或模型名写错。base_url 用https://taotoken.net/api别自己拼/v1/chat/completions这类路径除非你的工具明确要求。模型名以模型对话页确认的为准别凭记忆写。报错三ModuleNotFoundError: No module named docx。装的是python-docx导入名却是docx这是正常的。确认执行的是pip install python-docx而不是pip install docx后者是另一个包会冲突。报错四表格样式报错KeyError: Table Grid。某些精简版 Word 模板没有内置该样式。换成table.style doc.styles[Table Grid]前先判断或者直接用默认样式去掉这行。报错五中文乱码或字体不对。python-docx默认字体可能不含中文。在脚本里显式设置run.font.name 宋体并配合run._element.rPr.rFonts.set(qn(w:eastAsia), 宋体)才能让中文正确显示。报错六文件被占用无法保存。如果 Word 正开着verify.docx保存会失败。关掉 Word 再跑或者输出到带时间戳的新文件名。提示排查顺序建议固定为环境变量 → base_url → 模型名 → 依赖包 → 文件占用从外到内能省很多来回试的时间。7. 继续往下走把通道固定下来链路跑通后建议做两件事让它长期稳定。一是把config.toml和word_config.py一起纳入版本管理但 Key 只走环境变量绝不进仓库。二是如果你要长期用 codex 做编码和 Agent 类任务可以考虑 Coding Plan 把额度和通道固定下来https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你用的是 Claude Code 这类工具对应的接入说明在https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后留一个我常用的习惯每次改完config.toml先跑一遍verify_docx.py确认标题、段落、表格三项都对再去做批量任务。这个校验脚本只有二十来行却能挡住大部分配置看着对、结果不对的坑。 codex控制word方式：TaoToken统一Key接入与config.toml配置骨架
1. 为什么我会用 codex 去控制 Word先说清楚这篇要解决的事codex 控制 word指的是让 codex 这类 AI 编码工具通过统一的 API 通道去调用 Python 脚本操作 Word 文档完成标题、段落、表格的生成与编辑。它不是让 AI 直接打开 Word 界面点按钮而是让 codex 帮你写并执行python-docx脚本最终产出一个.docx文件。适合谁需要批量生成报告、周报、合同模板、论文格式文档的开发者已经在用 codex 写代码但每次调用模型都要换 Key、换地址、改配置觉得麻烦的人以及想把AI 生成内容和落成 Word 文件串成一条流水线的人。我自己的痛点是codex 默认走官方通道配置散落在多个文件里模型名、base_url、api_key 三处对不上就报 401 或 404。后来我把所有请求收敛到 TaoToken 一个 Key 上codex 的config.toml只写一份Word 脚本里读环境变量链路一下就干净了。下面把可复制的配置骨架、Word 操作指令模板、以及一次端到端验证动作完整给你。核心检索词先摆出来codex 控制 word 的本质是codex 生成并运行 python-docx 脚本TaoToken 负责提供统一的模型 API 通道config.toml负责把 codex 指向这个通道。2. TaoToken 前置统一 Key 与通道准备TaoToken 在这里的角色是统一入口你只维护一个 API Key 和一个 base_urlcodex、脚本、其他工具都指向它不用为每个模型单独配一套凭证。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 根地址是 https://taotoken.net/api 这个不加 UTM。第一步拿到 Key。进入控制台创建 API Key建议按用途命名比如codex-word方便后面排查是哪个 Key 出的问题。创建入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite Key 管理页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 。第二步确认你要用的模型名。codex 类工具通常需要一个对话/补全模型来生成脚本内容。你可以在模型对话页先手动问一句确认通道通、模型名对https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite 。这一步别省很多人后面 404 就是因为模型名写错。第三步把 Key 放进环境变量而不是硬编码进config.toml。这样脚本和 codex 共用一份凭证也不会把 Key 提交到 git。# Linux / macOS export TAOTOKEN_API_KEYsk-你的Key export TAOTOKEN_BASE_URLhttps://taotoken.net/api # Windows PowerShell $env:TAOTOKEN_API_KEYsk-你的Key $env:TAOTOKEN_BASE_URLhttps://taotoken.net/api注意config.toml里引用环境变量时不同 codex 版本语法略有差异有的用${VAR}有的用env:VAR。下面骨架给的是通用写法若你的版本不识别改成直接读环境变量的启动脚本即可。3. 可复制的 config.toml 配置骨架codex 的配置文件一般放在~/.codex/config.tomlWindows 是%USERPROFILE%\.codex\config.toml。下面这份骨架把 base_url、Key、模型名集中管理Word 脚本通过同一套环境变量读取保证一处改、处处生效。# ~/.codex/config.toml # codex 控制 word 的统一通道配置骨架 # 默认使用的模型提供方 model_provider taotoken # 模型名按你在模型对话页确认的写 model 你的模型名 # 关闭遥测减少无关请求 disable_telemetry true [model_providers.taotoken] # 统一 API 根地址注意结尾不带 /v1 时按你的工具要求补 base_url https://taotoken.net/api # 从环境变量读取 Key避免明文 env_key TAOTOKEN_API_KEY # 走 OpenAI 兼容协议 wire_api chat # 给 Word 脚本用的自定义段codex 执行时可读取 [word] output_dir ./output default_font 宋体 default_size 12配套的 Python 侧读取逻辑保证脚本和 codex 用同一个 base_url 与 Key# word_config.py import os API_KEY os.environ.get(TAOTOKEN_API_KEY) BASE_URL os.environ.get(TAOTOKEN_BASE_URL, https://taotoken.net/api) def check(): if not API_KEY: raise RuntimeError(TAOTOKEN_API_KEY 未设置请先 export) print(base_url , BASE_URL) print(key 前缀 , API_KEY[:6] ***) if __name__ __main__: check()跑一下python word_config.py能打印出 base_url 和 Key 前缀说明环境变量这一层通了。这一步是后面所有操作的地基别跳过。4. Word 操作指令模板与脚本codex 控制 Word 的落点是python-docx。先装依赖pip install python-docx下面是一个可复用的脚本模板包含加标题 加段落 加表格三个动作你可以把它当成 codex 生成内容的执行器。codex 负责产出文本和表格数据脚本负责写进 docx。# make_docx.py from docx import Document from docx.shared import Pt from docx.enum.text import WD_ALIGN_PARAGRAPH def build_docx(title: str, paragraphs: list, table_rows: list, out_path: str): doc Document() # 标题 h doc.add_heading(title, level1) h.alignment WD_ALIGN_PARAGRAPH.CENTER # 段落 for text in paragraphs: p doc.add_paragraph(text) for run in p.runs: run.font.size Pt(12) # 表格第一行当表头 if table_rows: cols len(table_rows[0]) table doc.add_table(rows1, colscols) table.style Table Grid for i, cell in enumerate(table.rows[0].cells): cell.text str(table_rows[0][i]) for row in table_rows[1:]: cells table.add_row().cells for i, val in enumerate(row): cells[i].text str(val) doc.save(out_path) print(saved:, out_path) if __name__ __main__: build_docx( titlecodex 控制 Word 验证文档, paragraphs[ 本文档由 codex 生成脚本、python-docx 落盘。, 用于验证 TaoToken 统一 Key 通道是否跑通。, ], table_rows[ [项目, 值], [通道, TaoToken], [工具, codex], [输出, docx], ], out_path./output/verify.docx, )如果你想让 codex 直接生成这段内容可以在 codex 里下这样的指令模板请生成一个 python-docx 脚本要求 1. 添加一级标题居中 2. 添加两段正文字号 12 3. 添加一个 3 列 4 行的表格带表头样式 Table Grid 4. 保存到 ./output/report.docx。 只输出完整可运行代码不要解释。这个模板的好处是约束明确标题、段落、表格、保存路径四要素齐全codex 不容易跑偏。实测下来把只输出完整可运行代码写进去能省掉大量手动删解释的时间。5. 端到端验证生成含标题与表格的 docx 并校验现在做一次完整验证。目标生成一个含标题和表格的 docx然后读回来校验内容是否真的写进去了。第一步建目录并运行脚本mkdir -p output python make_docx.py预期输出saved: ./output/verify.docx第二步写一个校验脚本把 docx 读回来检查标题、段落数、表格行列数# verify_docx.py from docx import Document doc Document(./output/verify.docx) # 校验标题 headings [p.text for p in doc.paragraphs if p.style.name.startswith(Heading)] print(标题:, headings) assert headings and headings[0] codex 控制 Word 验证文档, 标题不匹配 # 校验段落 paras [p.text for p in doc.paragraphs if p.text and not p.style.name.startswith(Heading)] print(段落数:, len(paras)) assert len(paras) 2, 段落数不足 # 校验表格 assert len(doc.tables) 1, 表格数量不对 t doc.tables[0] print(表格尺寸:, len(t.rows), x, len(t.columns)) assert len(t.rows) 4 and len(t.columns) 3, 表格尺寸不对 assert t.rows[0].cells[0].text 项目, 表头不对 print(校验通过)运行python verify_docx.py成功结果应该类似标题: [codex 控制 Word 验证文档] 段落数: 2 表格尺寸: 4 x 3 校验通过到这里codex 控制 word的完整链路就跑通了codex 生成脚本 → 脚本读 TaoToken 统一配置 → python-docx 落盘 → 读回校验。整个过程没有手工打开 Word也没有在多个 Key 之间来回切。如果你还想让 codex 在生成内容时调用模型比如自动写报告正文把模型请求也指向同一个 base_url 即可Key 复用环境变量不用再配第二套。6. 本篇常见错排查报错一401 Unauthorized。九成是 Key 没读到。先跑python word_config.py看 Key 前缀能不能打印。如果打印为空说明环境变量没生效注意 PowerShell 和 bash 的 export 语法不同且新开终端要重新 export。报错二404 Not Found。通常是 base_url 或模型名写错。base_url 用https://taotoken.net/api别自己拼/v1/chat/completions这类路径除非你的工具明确要求。模型名以模型对话页确认的为准别凭记忆写。报错三ModuleNotFoundError: No module named docx。装的是python-docx导入名却是docx这是正常的。确认执行的是pip install python-docx而不是pip install docx后者是另一个包会冲突。报错四表格样式报错KeyError: Table Grid。某些精简版 Word 模板没有内置该样式。换成table.style doc.styles[Table Grid]前先判断或者直接用默认样式去掉这行。报错五中文乱码或字体不对。python-docx默认字体可能不含中文。在脚本里显式设置run.font.name 宋体并配合run._element.rPr.rFonts.set(qn(w:eastAsia), 宋体)才能让中文正确显示。报错六文件被占用无法保存。如果 Word 正开着verify.docx保存会失败。关掉 Word 再跑或者输出到带时间戳的新文件名。提示排查顺序建议固定为环境变量 → base_url → 模型名 → 依赖包 → 文件占用从外到内能省很多来回试的时间。7. 继续往下走把通道固定下来链路跑通后建议做两件事让它长期稳定。一是把config.toml和word_config.py一起纳入版本管理但 Key 只走环境变量绝不进仓库。二是如果你要长期用 codex 做编码和 Agent 类任务可以考虑 Coding Plan 把额度和通道固定下来https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果你用的是 Claude Code 这类工具对应的接入说明在https://taotoken.net/claudecode-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaudecodeutm_campaignrewrite 。最后留一个我常用的习惯每次改完config.toml先跑一遍verify_docx.py确认标题、段落、表格三项都对再去做批量任务。这个校验脚本只有二十来行却能挡住大部分配置看着对、结果不对的坑。