Mac版Codex在Notion中同步延迟是因触发Notion API速率限制（每10秒100次），导致429错误及默认3秒重试5次后静默终止；可通过降低同步频率、使用独立API令牌或启用变更摘要模式解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Mac版Codex在Notion中执行任务时出现同步延迟，不是插件卡顿，而是API请求被Notion官方速率限制（Rate Limit）拦截后触发的默认重试策略所致——每次失败后等待3秒再试，连续5次失败即静默终止，导致你看到的“卡住”其实是等待窗口。
确认是否触发Notion API速率限制
打开Mac版Codex → 点击左下角「⚙️设置」→ 选择「调试日志」→ 开启「显示网络请求详情」；执行一次同步操作后，在日志面板中查找含 【429 Too Many Requests】 的红色报错行。若存在，说明已触达Notion每10秒100次请求的硬性上限。
注意：该限制按workspace粒度统计，不是单个页面或单个用户；如果你的Notion工作区正被其他自动化工具（如Zapier、Make）高频调用，Codex会共享同一配额池。
手动绕过速率限制的三种方法
方法一：降低Codex主动同步频率
进入Codex设置 →「同步偏好」→ 将「自动同步间隔」从默认的「实时」改为「每5分钟」；这会强制Codex将变更批量打包，单次请求体变大但总请求数锐减，避开10秒窗口内的峰值超限。
方法二：启用Notion官方API令牌的独立配额通道
登录notion.so → 左下角「Settings & members」→「Integrations」→「Develop your own integration」→ 创建新integration并勾选「Pages」和「Databases」权限 → 复制生成的Internal Integration Token → 回到Codex设置 →「API凭证管理」→ 粘贴Token并保存；【此操作将使Codex的请求脱离workspace公共配额池，获得独立的每10秒300次额度】。
方法三：对高变更密度页面启用「变更摘要模式」
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
在Notion中打开目标页面 → 右上角「⋯」→「Page settings」→ 向下滚动至「Codex Sync Options」→ 开启「Summarize changes instead of syncing every edit」；该模式下Codex不再监听光标移动或按键事件，仅在你按下 Cmd+Enter 提交段落时抓取整块内容快照，请求频次下降约70%。
配置重试机制参数（高级）
第一步：在Finder中按 Cmd+Shift+G，输入 ~/Library/Application Support/Codex/；
第二步：找到 config.json 文件，用文本编辑器打开；
第三步：定位到 "retry_policy" 字段，将原值：
"retry_policy": {"max_attempts": 5, "base_delay_ms": 3000, "backoff_factor": 1.0}
修改为：
"retry_policy": {"max_attempts": 3, "base_delay_ms": 1500, "backoff_factor": 1.5}
这会把重试次数从5次减至3次，首次等待从3秒压缩到1.5秒，并启用指数退避（第2次等2.25秒，第3次等3.375秒），总等待时长从15秒压至约7秒；【修改后必须完全退出Codex（右键菜单选「Quit Codex」而非关闭窗口），再重新启动才生效】。
