MossHubs Codex 助手
用界面完成 Codex 安装与中转配置
Codex 桌面版安装与配置
Windows 推荐使用中文助手，按安装、连接、启动三个步骤完成配置。macOS 可使用手动安装指南。
本页内容
本页适用的服务
下载与准备
Windows 用户下载本页完整 ZIP，解压后运行
MossHubs Codex 助手.exe。安装所需的常用组件已打包，跟随中文界面操作即可。- 准备好 中转站控制台 创建的 API Key，并确认模型权限和可用额度。
- 开始前保存工作并退出 Codex；更新助手时，也请先退出旧版助手。
1. 安装桌面版（推荐）
- 解压完整 ZIP，运行
MossHubs Codex 助手.exe，等待首次组件准备完成。 - 点击“开始安装”，按 Windows 提示授予管理员权限。助手会检查并安装 Codex、Microsoft Store 和所需工具。
- 看到“环境部署完成”后，继续连接模型服务。下载进度到 100% 后仍需等待安装和检查完成。
若安装中断，按提示处理后点击“重试检查与修复”；助手会检查并复用已有组件。
2. 连接模型服务
- 在助手中粘贴自己的 API Key，等待可用模型列表加载。MossHubs 服务地址已预置，无需手填。
- 选择要使用的模型；思考强度可先保留默认值
low。列表提供gpt-6-astra时会默认选中。
已有配置？保存前请留意
助手会先备份 config.toml 和 auth.json，再替换为本次连接配置。原有 MCP、项目和自定义设置保留在备份中，不会合并到新配置。需要保留这些设置时，请使用下方手动配置方式。保存前退出 Codex，并按 Windows 提示授权；取消授权不会写入配置。
3. 启动与日常使用
- 点击“启动 Codex”，在打开的桌面应用中新建任务，确认使用的是刚选中的模型。
- 以后可直接从 Windows 开始菜单打开 Codex，无需一直运行助手。
- 更换 Key 或模型时，再打开助手重新连接。新任务中的实际模型请求会按服务额度计费。
其他方式：手动安装或使用 CC Switch
- 手动安装配置
适用于 macOS、希望自行安装，或需要保留现有自定义配置的用户。
- CC Switch 配置
通过图形界面管理服务配置。
遇到问题：安装与连接排查
| 遇到的情况 | 处理方式 |
|---|---|
| 安装中断或环境未就绪 | 根据提示处理原因后点击“重试检查与修复”。不要把下载进度 100% 当作安装成功。 |
| Microsoft Store 缺失或检查未通过 | 助手会自动补装；失败时按提示处理原因，再使用同一“重试检查与修复”按钮。 |
| 连接或配置保存失败 | 重新输入 Key 并验证连接，在系统提示中批准当前账户的管理员授权。若仍失败，导出诊断查看具体步骤和错误码；原配置或已生成的备份会保留。 |
| 配置文件被占用或只读 | 保存工作并退出官方 Codex及正在编辑配置的程序，按提示检查对应文件后重试。仍失败时导出诊断。 |
| 模型列表为空、401 或模型不可用 | 核对完整 Key，并在控制台检查模型分组、权限和额度。 |
| Windows 显示来源提示 | 此版本采用 MossHubs 自签名，系统可能显示来源提醒。请核对本页下载来源和文件摘要；无需关闭系统防护。 |
| 提示资源清单过期 | 退出旧版助手，下载本页 0.1.10 R16 完整 ZIP，解压并运行新版，再点击“重试检查与修复”。新版固定资源不会因清单日期到期而停止准备，已就绪组件会复用。 |
| 更换 Key 或连接失败后重新配置 | 按提示处理原因，重新输入 Key、获取模型，再点击“验证并连接”。当前使用 API Key 连接，助手内的账户登录与注册尚未开放；旧连接记录只归档，不会自动恢复旧 Key。 |
需要帮助：导出诊断
操作结束后点击“导出诊断”，助手会在文件资源管理器中选中
diagnostics.json。定位失败时会显示保存路径和错误提示。联系支持时，提供复现步骤、错误提示和导出的诊断文件。日志不包含 API Key 或认证与配置文件正文；请勿发送
auth.json、config.toml 或它们的备份。诊断包含环境检查、安装、模型获取、配置备份与保存、启动等步骤，以及对应错误码。
- 需要进一步帮助
说明系统版本、出错步骤和错误提示。
- 日志保存在 %LOCALAPPDATA%\MossHubs\CodexAssistant\logs。
- 日志约 2 MiB 轮转，保留一份前档；导出最多包含最近 5000 条事件。
- 旧版未记录的错误无法补录；用新版重试后再导出。断电或强制结束可能只留下最后一条进行中记录。
版本、文件校验与组件说明
- v0.1.10 R16：修复安装失败后导出诊断导致原错误和恢复入口消失的问题；诊断导出失败时仍可继续重试。
- 资源按版本、签名和完整性校验，不设置日期失效或定期续期要求。
- 固定组件优先使用随包资源；资源缺失时从 MossHubs 主站下载，并校验签名和 SHA-256。
- 官方 Codex 安装包继续使用更新较频繁的镜像源，安装前校验官方发布者。
- 只补齐缺失工具，复用已经就绪的组件；安装、连接、启动三个步骤和详细诊断继续保留。
- 支持系统减少动态效果设置，保留管理员原地备份替换、详细诊断与 ZIP 单文件分发。
- 包含 WebView2、Git、Node.js、Python、搜索工具及微软官方安装程序，主站提供相同版本的备用下载。Microsoft Store 缺失时由助手补装；其官方安装程序仍可能需要连接微软下载后续组件。
- 组件自动释放到当前用户应用数据目录，后续可复用。目录中含已部署工具，日常使用时请保留。