Appearance
文档更新日志
更新记录
2026-08-11
- 修正 - 常见问题解答线路描述更新为 CN2 优化线路:API 现走 CN2 优化线路,不再使用 HK / JP 线路,「速度怎么样」「访问速度怎么样」「官网偶尔打不开怎么办」三处描述同步修正
- 新增 - 常见问题解答新增「QQ 售后群号是多少?怎么联系客服?」:QQ 售后群号 1014742674,搜索群号即可加入;开票、退款、账号类问题走控制台右下角客服入口更快。「如何售后?」条目同步补充群号
- 新增 - 常见问题解答新增「立即升级套餐后,到期时间怎么算?」:到期时间从购买当天重新计算、一个月按 30 天计,旧套餐剩余天数不叠加而是折算成金额抵扣差价;在定价页面选好套餐后会直接显示抵扣与差价计算公式,不需要自己算
- 更新 - 常见问题解答「官网偶尔打不开怎么办?」补充说明:官网目前需要用非中国大陆区域的网络环境访问(代理挂海外节点即可),API 不受影响、正常直连且不建议叠加代理;切换节点后仍打不开时依次强制刷新浏览器(
Ctrl/Command+Shift+R)、清理浏览器缓存,并确认地址栏是官网地址codexzh.com - 更新 - 常见问题解答「报错 Selected model is at capacity」条目补充平台侧处理说明:命中官方容量不足时不再直接抛错,而是让客户端自动重试,因此现在更常见的表现是 Codex 反复重试、变慢而不是直接中断,属于正常兜底行为
2026-07-28
- 新增 - 常见问题解答新增「报错 Selected model is at capacity. Please try a different model. 怎么办?」:这是 OpenAI 官方算力不足时返回的报错,不是平台或用户配置问题,平台无法解决;只能稍等重试或换个模型,高峰期反复出现时只能等官方恢复算力
2026-07-26
- 新增 - 《CC-Switch 一键配置》补充下载版本提醒:必须下载安装包版本(Windows 用
.exe/.msi,macOS 用.dmg),不能用压缩包(zip)版;zip 解压出来的绿色免安装版没有向系统注册,浏览器点「一键导入 CC Switch」时调不起软件、自动导入没有任何反应,已装 zip 版的删掉重装安装包即可。「若没有任何反应」的排查提示同步列出这一原因
2026-07-23
- 更新 - 常见问题解答「为什么缓存一直不生效」条目扩充为「为什么感觉流量消耗变快、缓存经常不命中?」:说明缓存是 OpenAI 官方功能、5 分钟有效期为官方设定,平台未做任何调整;列出缓存失效的三种原因(超过 5 分钟、后台切换账号、上下文变化),并补充平台已用 hash 让同一会话固定同一账号以提高命中率,以及导出使用日志按官方定价自行核算的验证方法
2026-07-22
- 新增 - 常见问题解答新增「支持升级套餐吗?怎么升级?」:前往定价页面购买新套餐即可,系统按当前套餐剩余价值抵扣(剩余天数折算、每月按 30 天计),新套餐从购买当天重新开始一个月,因此补差价可能比两个套餐月价直接相减要多
- 新增 - 常见问题解答新增「报错 503:No available channel for model gpt-5.4 怎么办?」:官方将下架 gpt-5.4 模型,平台已同步下架,请更换使用 gpt-5.6-terra(消耗价格一样);切换方法为新建任务或新建会话后重新选择模型,原有会话基础上无法切换模型。问题解决的 503 条目同步补充该说明
2026-07-20
- 新增 - 套餐与定价说明新增「加油包」说明:包月套餐本周额度不够用时,可购买加油包临时补充额度,无需等下周一刷新;购买入口在登录官网后的「用量查询」页面本周额度旁边,注意加油包仅在当前套餐时长内有效
- 修正 - Claude Code 集成删除「cc-gpt-5.5 多轮对话可能报错、请先使用 cc-gpt-5.4」的过时提示:cc-gpt 全系列(5.6-sol / 5.6-terra / 5.5 / 5.4)均已完成协议适配,不再有兼容性问题,任选型号即可;可用模型列表与《支持的模型说明》对齐,配置示例同步更新
2026-07-19
- 新增 - 新增《Codex CLI 集成》独立教程:CLI 的 npm 安装、首次运行生成
~/.codex配置目录、配置接入与启动验证集中到一页,与 VSCode 插件、Codex App 并列为「客户端集成」的三种方式之一 - 更新 - (2)安装与环境检查改版为客户端选择入口:列出 Codex CLI / VSCode 插件 / Codex App(独立应用)三种客户端的安装地址与对应教程,按使用习惯选一种跳转即可;Node.js 环境与 CLI 的安装步骤移入《Codex CLI 集成》(仅 CLI 需要 Node.js,选插件或 App 无需安装)
- 更新 - Codex App 使用补充官网独立应用下载页地址(openai.com/zh-Hans-CN/codex),原 chatgpt.com/codex 保留为备用地址
- 新增 - 常见问题解答新增「如何使用邀请佣金?」:先在控制台「我的邀请」确认已有可用佣金,再到定价页选择任意包月套餐购买,购买时选择佣金抵扣后支付即可
- 新增 - 新增《套餐与定价说明》:整理官网定价页内容,包含日卡/月卡各档位价格与额度对照表、周限额度刷新规则(按自然周周一–周日刷新,总额度 = 周限额度 × 5)及加油包购买提醒,方便查询套餐详情
- 新增 - 新增《支持的模型说明》:整理官网模型页内容,包含标准系列、Claude Code 支持系列(cc- 前缀)、codex-auto-review 和 gpt-image-2 的单价对照表、推理深度、适用场景与选型建议,以及数据安全与服务边界说明
2026-07-18
- 更新 - 侧边栏新增「🚀 新手引导」编号主线:(1)购买套餐 →(2)安装与环境检查 →(3)配置接入并启动,每页结尾指向下一步,新手可按序号走完从购买到跑通的完整流程
- 新增 - 新增《安装与环境检查》独立页:配置前先确认 Node.js、Codex CLI 安装成功且
~/.codex配置目录已生成,配置报错时可先回该页排除本机环境问题;快速开始(终端接入)相应精简为引用该页 - 更新 - 手动配置 config.toml 创建配置目录改为 macOS/Windows 标签页切换并给出按键级操作提示;结尾统一新增「验证配置 + 遇到问题」引导(先查运行状态 → 环境检查 → 排障/FAQ),问题解决顶部新增「排查前先看运行状态页」提示
- 修正 - 登录官方账号 + 使用平台 API删除「没有账号可前往控制台免费领取」的描述:该免费领取功能已下架,避免误导用户
2026-07-15
- 新增 - 常见问题解答新增「开了系统代理,但 Codex App(ChatGPT 桌面版)还是连不上?」:代理软件未开启虚拟网关(TUN 模式)时,Codex App 可能不走系统代理,可在
~/.codex目录下创建.env文件设置HTTP_PROXY/HTTPS_PROXY/ALL_PROXY环境变量后重启解决
2026-07-03
- 修正 - 问题解决中 401 错误的额度描述与现行规则不符(原文写"当天 50 刀额度、晚上 0 点重置"),已统一为周限额、每周刷新,具体以定价页面为准;同页去除与正文重复的速查条目
- 修正 - OpenClaw 手动配置中删除一段残留的 ccodezh 字段说明(缺少对应标题与配置示例,属编辑残留),Claude 模型的 OpenClaw 配置请看 OpenClaw 手动配置(Claude Code)
2026-06-07
- 新增 - 为《CC-Switch 一键配置》新增自动导入配置方式并设为推荐:在 CodexZH 控制台「一键配置脚本」区域点击「一键导入 CC Switch」,浏览器即可自动调起本机 CC-Switch 客户端并填好平台配置,用户只需点击「应用」即可,无需再手动新建配置和填写信息;原手动填写流程保留为「方式二:手动配置」
2026-06-06
- 更新 - 为《用 Codex 生成图片》顶部新增风险提示:Agent 生成后会自检,觉得不合适会自动重新生成,因此一个需求可能产生多次扣费调用;若想每次只调用一次,可参考 AI HUB API 网页生图教程
- 更新 - 为《用 Codex 生成图片》新增「
~/.codex这个目录在哪里?」一节:解释~代表用户主目录、.codex是隐藏文件夹,并分别给出 Mac(访达Command + Shift + G跳转~/.codex)和 Windows(资源管理器地址栏输入%USERPROFILE%\.codex)的进入步骤及显示隐藏文件的方法,方便小白找到目录 - 更新 - 重写《用 Codex 生成图片》安装教程:改为「手动创建」单一安装方式,长配置内容默认折叠、点击展开再复制,页面更清爽;顶部新增「懒人小贴士」,把教程地址连同提示词复制给 Codex 即可让它自动读取教程并配置好
codexzh-image技能。同时修正技能脚本路径错误(应为~/.codex/skills/codexzh-image/scripts/...,原文档误写为openai-image目录会导致脚本调用失败)
2026-06-04
- 删除 - 移除《Codex++ 插件解锁》教程:该工具现已不再需要,相关教程页面及客户端集成入口一并下线
- 更新 - 同步模型调整:常见问题解答中可用模型收敛为 GPT-5.5 / GPT-5.4 / GPT-5.4-Mini 三个,其余旧模型已全部下架;新增三款模型的官方定价表(输入 / 缓存输入 / 输出),并修正「50 刀大概有多少 token」中过时的 gpt-5 单价(涉及「能用 high 吗」「各模型怎么选」「如何使用最新模型」等问题)
- 更新 - 同步限额规则:常见问题解答中包月套餐由"每天限额、每天 0 点刷新"调整为周限额、每周刷新,具体额度以定价页面为准(涉及「有限额吗」「这么便宜有什么限制」「多久刷新额度」「天卡/月卡额度」「401 错误」等问题)
2026-06-02
- 更新 - 重写《Codex++ 插件解锁》教程以同步上游变化:CodexPlusPlus 已从 Python 源码安装改为 直接下载安装包(GitHub Releases 的 Windows
.exe/ macOS x64、arm64.dmg),不再需要 git clone 或 Python;新增「Codex++ / Codex++ 管理工具」两个入口说明、「传统增强模式 vs API 注入模式」对比、API 注入配置步骤、macOS「已损坏」Gatekeeper 解除方法与自动更新说明
2026-05-30
- 更新 - 同步 ccodezh 渠道分组调整:Claude Code 集成与 OpenClaw 手动配置中"第三方 -n 模型"相关说明,改为按分组(
cc主渠道 /cc-n第三方 /cxCodex 按量)区分,模型名不再加-n后缀,相关 Claude 模型版本名更新为现网真实名称
2026-05-27
- 新增 - 「进阶教程」新增《Codex 降智?清理本地缓存文件试试》:说明
~/.codex目录下日志、状态库(state_5.sqlite、logs_2.sqlite、codex-tui.log等)膨胀可能拖慢响应,给出"备份 → 查大小 → 重命名 → 重启 → 确认后清理"五步可逆流程,附日常归档命令
2026-05-22
- 恢复 - 恢复《Codex++ 插件解锁》教程入口,方便需要通过 Codex++ 解锁 Codex App 插件功能的用户查阅
2026-05-17
- 新增 - 「如何配置」新增《浏览器插件用量查询》:面向零基础用户说明如何下载、解压、在 Chrome 开发者模式加载插件,并填写 API Key 查看实时额度
2026-05-12
- 完善 - 《Codex Auto Review 自动审批配置》新增「如何关闭 auto_review」章节:澄清
auto_review与compact的区别,说明如何切换回手动审批、如何用自定义 provider 绕开/responses/compact报错,附完整推荐配置和日志验证方法 - 新增 - 「Codex 使用教程」新增《用 Codex 生成图片(gpt-image-2)》:覆盖 Windows/Mac 双平台,含环境安装、技能配置、API Key 设置的完整步骤,以及 6 类常见报错的处理方法,适合零基础用户
2026-05-10
- 完善 - 《Codex Auto Review 自动审批配置》在顶部补充
--yolo/ 完全访问权限不适用说明,解释无审批请求时codex-auto-review不会被调用,并增加正常模式与--yolo模式的流程对比
2026-05-09
- 完善 - 《Codex++ 插件解锁》常见问题补充 CDP 端口正常但插件仍未注入的启动时序排查说明,以及不改源码时的临时处理方式
- 新增 - 「Codex 使用教程」新增《Codex Auto Review 自动审批配置》:说明
approval_policy = "on-request"、approvals_reviewer = "auto_review"与codex-auto-review的关系,补充 CodexZH 配置、启动验证和常见坑
2026-05-08
- 新增 - 「工具集成」新增《Codex++ 插件解锁》教程:说明如何在 Windows / macOS 上拉取 CodexPlusPlus 源码、安装依赖、安装 Codex++ 启动器,并通过增强启动器解锁 Codex App 插件入口
- 完善 - 《Codex++ 插件解锁》补充 macOS 安装结果、插件入口、插件搜索安装和对话调用插件的截图说明
- 更新 - 将《MCP 服务》从「工具集成」移动到「如何配置」,方便按配置项查找
2026-05-02
- 新增 - 「如何配置」新增《恢复聊天记录》教程:说明切换 API 平台或官方账号后聊天记录"消失"的原因(本质是
model_provider值不一致),以及如何修改config.toml恢复历史记录
2026-04-30
- 更新 - 重写《恢复使用自己的 OpenAI 账号》教程:改为同时备份
config.toml和auth.json两个文件,新增退出程序、重启步骤、切回平台 API 的完整操作流程,面向小白用户重写
2026-04-28
- 新增 - 「如何配置」新增《恢复使用自己的 OpenAI 账号》教程,说明一键脚本配置后如何手动修改
config.toml与auth.json切换回官方接口
2026-04-27
- 新增 - Hermes 配置入门教程:零基础入门,涵盖模型、备用模型、上下文压缩、助手行为、显示效果五大配置块,附最小可用配置和常见踩坑说明
2026-04-24
- 新增 - 新增教程:通过自定义
model_catalog.json,让第三方 API Key 在 Codex 中支持 GPT-5.5 模型,包含完整的配置步骤和常见问题解答
2026-04-20(今日)
- 更新 - 一键脚本配置教程大幅扩充,面向零基础用户重写:新增 Mac 打开终端、cd 进入下载目录、运行命令的完整步骤,以及遇到权限问题使用 sudo、密码输入时光标不显示的说明;Windows 补充安全警告和 UAC 弹窗处理方式;增加「常见问题」解答模块
2026-04-20
- 完善 - Claude Code 集成教程新增
output_config思维深度持久化配置说明,支持在 settings.json 中设置模型推理深度,免去每次启动手动指定 - 完善 - 常见问题新增「为什么只问一句话却扣了很多钱」:解释 Codex 作为 AI Agent 而非聊天机器人的工作原理,说明它会自动读取项目上下文、进行多轮请求,问题越复杂费用越高
2026-04-15
- 新增 - CC-Switch 用量查询配置教程:介绍如何在 CC-Switch 中配置 CodexZH 用量查询,实时查看今日/本周额度、消费金额、调用次数等详细数据
2026-04-12
- 完善 - OpenClaw 常见问题新增缓存命中 0 的手动补丁修复方法:适用于升级到 2026.3.22+ 后缓存突然失效的场景,提供 dist 文件定位、函数修改步骤及让 OpenClaw 自动修复的提示词
2026-04-06
- 完善 - OpenClaw 常见问题新增:Prompt Cache 命中率为 0% 的解决方法(配置
supportsPromptCache: true) - 更新 - OpenClaw 手动配置的完整示例中预置
"compat": { "supportsPromptCache": true }字段
2026-03-31
- 新增 - OpenClaw 常见问题文档,解答缓存命中率低导致成本偏高、AI 摆烂只回答不干活等典型问题
- 重要 - OpenClaw / OpenCode 配置说明增加醒目提示:GPT 系列模型必须使用
openai-responses协议,不能用旧版 Chat Completions- OpenClaw 配置:手动配置 OpenClaw
- OpenCode 配置:OpenCode 集成
2026-03-24
- 新增 - 新增「命令速查表」:点击可全屏放大
2026-03-16
- 新增 - 新增「Windows 中文乱码解决方案」教程:整理社区多个 Issue 的根因分析,提供从系统级到 Agent 指令的多种修复方案
2026-03-15
- 新增 - 新增「Claude Code 集成」教程:介绍如何在 Claude Code 终端或插件中使用 Codex 新上线的 cc-gpt-5.x 系列模型,包含模型列表及配置方法
2026-03-12
- 新增 - 新增「用 AI 重塑软件开发全流程」教程:覆盖规划、设计、构建、测试、代码审查、文档、部署运维 7 个阶段,每个阶段说明代理能做什么、工程师该做什么,附真实案例(Cloudwalk、Sansan、Virgin Atlantic)
- 新增 - 新增「让 Codex 跑得更久、做得更多」教程:介绍 Skills、Shell 工具和上下文压缩三大能力,包含 10 条实用技巧和三种组合模式,适合需要构建长期代理的开发者
- 新增 - 新增「用好 Codex 的实用技巧」教程:涵盖提示词写法、Plan 模式、AGENTS.md 配置、测试验证循环、MCP 接入、Skill 封装和自动化等核心用法,适合新手快速上手
2026-03-09
- 更新 - VSCode/Cursor 插件现已支持直接读取
~/.codex/config.toml中的model字段来指定模型,无需再修改插件 JS 文件,旧的DEFAULT_MODEL_ORDER方法已不再需要
2026-03-08
- 新增 - OpenClaw 文档改版:独立为一级菜单,新增 UI 界面配置教程,手动配置说明大幅扩充(完整 JSON 结构图解 + 字段逐一解释)
- 修复 - 修复 Windows 版 OpenClaw 一键脚本在部分
cmd环境下出现英文报错、中文乱码和模型选择异常的问题,重新下载最新.bat即可使用
2026-02-27
- 新增 - 一键脚本配置教程:下载官方脚本自动完成环境配置,无需手动修改文件,作为配置首推方式
2026-02-23
- 新增 - VSCode/Cursor 插件解锁隐藏模型:通过修改插件 JS 文件中的
DEFAULT_MODEL_ORDER数组追加模型名,并提供让 Codex 自动完成修改的提示词
2026-02-12
- 完善 - OpenClaw 配置页新增服务商说明:codexzh 仅支持 gpt 系列,ccodezh 仅支持 claude 系列,两站 key 不互通
2026-02-11
- 重要 - 添加 gpt-5.3-codex 模型使用限制说明:官方 API 暂未推出,插件和 CLI 选择器暂不支持,需通过命令行参数使用
2026-02-07
- 新增 - 添加 OpenClaw 配置教程:安装方式、关键字段说明、手改最小模板
- 完善 - 增加 macOS/Linux
setup-openclaw.sh与 Windowssetup-openclaw.bat一键脚本示例