官方 Codex 很强,但第一次安装、寻找正确版本、安装 Codex++,对新手并不直观。Uni-codex 把这些步骤放进一个图形化安装包里。
| 自己配置 | 使用 Uni-codex |
|---|---|
| 查找适合系统的 Codex 下载来源 | 自动获取对应平台的官方 Codex |
| 手动下载并安装 Codex++ | 安装器统一处理 |
| 分辨 Windows、Apple Silicon、Intel 版本 | 自动识别或提供正确入口 |
| 阅读多份安装说明 | 跟着安装向导操作即可 |
| 容易重复安装或覆盖已有版本 | 优先复用已安装且可用的 Codex |
Uni-codex 是轻量的在线安装器:安装时从官方来源获取最新组件,因此安装包体积小,使用时需要联网。
支持 Windows 10 1809 及以上版本、Windows 11(x64)。
- 下载 Windows 一键安装包。
- 双击
Uni-codex-Windows-x64-Online-Setup.exe。 - 按安装向导提示完成安装。
安装器会通过微软官方渠道获取 Codex,并完成 Codex++ 的安装或集成。
支持 Apple Silicon(M 系列)和 Intel Mac。
- 下载 macOS 一键安装包。
- 打开
Uni-codex-macOS-Online.dmg。 - 按窗口中的说明完成安装。
安装器会识别 Mac 的芯片类型,从 OpenAI 官方地址获取适合的 Codex,并安装 Codex++。
- Codex 桌面版:由官方来源下载,不在本仓库重复打包。
- Codex++:随引导流程安装,减少手动配置步骤。
- 211 个科研 Skills:在线版与离线版都预装 Nature Skills、Scientific Agent Skills 和 Research Skills。
- 跨平台支持:一个项目同时覆盖 Windows 和 macOS。
- 已有安装保护:检测到健康的 Codex 时优先复用,避免无意义地重复安装或降级。
- 更适合中文用户:下载入口、安装说明和常见问题集中在同一页面。
Windows 配置工具支持 DeepSeek、Kimi 开放平台、Kimi Code、智谱 GLM、阿里千问和 Xiaomi MiMo 等 API 服务商,并提供相应的官方 API Key 申请入口。
Uni-codex 也可以配合以下工具形成连续科研工作流:
- Uni-Scholar 云端工作站:检索、协作与长流程科研任务。
- Research Kit:连接 Zotero、Obsidian 与本地知识库,目前主要面向 macOS。
- Codex / Codex++:执行代码、文档、数据处理与自动化任务。
这些功能均为可选项。只想安装 Codex 的用户,直接使用上方安装包即可。
安装完成后,Codex 会自动获得三套经过固定版本管理的开源技能合集:
- Nature Skills:Nature 风格论文写作、润色、审稿、作图和投稿工作流,共 19 个技能。
- Scientific Agent Skills:覆盖生物、化学、医学、数据分析和科研数据库等场景,共 158 个技能。
- Research Skills:研究规划、实验设计、文献与图表处理、工程化研究流程,共 34 个技能。
三套合集合计 211 个技能。在线安装包在安装时获取锁定版本;离线安装包在构建时已将同一版本完整打包。安装器会保留用户自己维护的同名技能,不会静默覆盖。
三套合集的 MIT 许可证会随技能一并保留在 .codex/skills/.uni-codex-licenses/。
因为它是在线安装器,不把体积较大的官方 Codex 应用重复塞进仓库。运行安装器后,才会从 OpenAI、Microsoft 和相关项目的官方地址下载所需组件。
是。下载 Codex、Codex++,以及刷新上游模型信息都需要网络。
不是。Source code (zip) 和 Source code (tar.gz) 是 GitHub 为每个版本标签自动生成的源码快照。普通用户只需下载 .exe 或 .dmg。
不等于。OpenAI 账号授权不会赠送 GPT API 额度,也不会获得账号原本没有的权限。选择第三方 API 服务商时,实际模型调用及费用由相应服务商负责。
不是。Uni-codex 是社区项目,与 OpenAI 没有隶属关系。Codex 的名称、商标和官方应用归其各自权利人所有。
- Codex 桌面应用只从 OpenAI 或 Microsoft 官方渠道获取。
- Codex++ 从其 GitHub Release 获取,或由安装引导器集成。
- 本仓库不镜像分发官方 Codex 桌面应用、Microsoft Store 包或许可证不明确的脚本源码。
- API Key、OAuth Token、设备码、对话正文等敏感内容不会作为公开构建产物上传。
- 请不要在 Issue、日志、截图或公开配置中提交任何密钥和令牌。
普通用户不需要阅读本节。项目的在线发布入口是 .github/workflows/online-release.yml,版本标签格式为 v*-online。
.
├── macos/ # macOS 在线安装器
├── windows/ # Windows 安装器与配置工具
├── scripts/ # 构建、验证与烟雾测试
├── tests/ # 自动化测试
├── Resources/ # macOS 资源
└── .github/workflows/ # CI 与 Release 工作流
Windows 的完整构建说明见 windows/README.md。第三方组件和再分发边界见 THIRD_PARTY_NOTICES.md 与 LICENSES。
Uni-codex 原创安装器代码采用 MIT License。该许可证只适用于本项目拥有版权的原创部分,不会重新授权 Codex、Codex++、插件、脚本、图标或商标;第三方组件继续遵循各自的上游许可证。
如果 Uni-codex 帮你省下了配置时间,欢迎点一个 ⭐,也欢迎通过 Issue 提交建议。