OpenCodex
OpenCodex 是 AI Skill Hub 本期精选AI工具之一。综合评分 7.5 分，整体质量较高。我们推荐使用将其纳入你的 AI 工具库，帮助提升工作效率。
📚 深度解析
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
OpenCodex 依赖 JavaScript 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 JavaScript 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 OpenCodex 的版本更新，及时通知重要功能变化。
📋 工具概览
OpenCodex 是一个中间件层，为 Codex Desktop 提供服务，让您可以使用手机或平板电脑等设备进行操作。它提供了一个可安装的 JavaScript 中间件层，方便开发者使用。
OpenCodex 是一款基于 JavaScript 开发的开源工具，专注于 installable、javascript 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
📖 中文文档
OpenCodex 是一个中间件层，为 Codex Desktop 提供服务，让您可以使用手机或平板电脑等设备进行操作。它提供了一个可安装的 JavaScript 中间件层，方便开发者使用。
OpenCodex 是一款基于 JavaScript 开发的开源工具，专注于 installable、javascript 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 方式一：npm 全局安装 npm install -g opencodex # 方式二：npx 直接运行（无需安装） npx opencodex --help # 方式三：项目依赖安装 npm install opencodex # 方式四：从源码运行 git clone https://github.com/RyensX/OpenCodex cd OpenCodex npm install npm start
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 命令行使用
opencodex --help
# 基本用法
opencodex [options] <input>
# Node.js 代码中使用
const opencodex = require('opencodex');
const result = await opencodex.run(options);
console.log(result);
# opencodex 配置说明 # 查看配置选项 opencodex --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export OPENCODEX_CONFIG="/path/to/config.yml"
OpenCodex
中文 | English
OpenCodex 是一个Codex Desktop中间层，它可以让你使用手机、平板或另一台电脑通过浏览器里访问并操作目标机器上的 Codex，适合在局域网或远程局域网环境中持续AI Coding。
--- 天塌了😭刚准备开源，谁知道一觉醒来 ChatGPT App 就对 Codex 做了支持。
但对比官方还是有一些使用场景上的优势：
- 无需魔法上网。
- 无需外区Google Play/苹果账号。
- 支持 Codex 的完整功能，例如文件树、终端、审查等，便于随时随地 AI Coding。
---
特性
- 通过浏览器访问目标机器上的 Codex，无需魔法网络和账号，支持手机、平板、电脑等多种设备。
- 原汁原味Codex使用体验。
- 支持本机访问、局域网访问和配合 Tailscale / ZeroTier / VPN 的远程局域网访问。
- 支持设置访问密码，避免无认证暴露。
- 提供桌面启动器，可可视化配置监听地址、端口和访问密码等。
- 启动时会自动更新到本地 Codex Desktop 版本，自动兼容新版本功能。
- 针对移动端提供优化。
<p align="center"> <img src="docs/image/start.jpg" alt="OpenCodex start" width="23%" /> <img src="docs/image/settings.jpg" alt="OpenCodex settings" width="23%" /> <img src="docs/image/home.jpg" alt="OpenCodex home" width="23%" /> <img src="docs/image/new.jpg" alt="OpenCodex new session" width="23%" /> </p>
环境要求
- Node环境
- pnpm
- 本机已安装 Codex Desktop（无需启动，但也支持同时使用）。
- macOS 或 Windows（Linux暂未测试）。
如何使用
桌面启动器
下载安装：
打开release下载安装包安装
本地调试：
pnpm installpnpm run desktop:dev生成 macOS 安装包：
pnpm run desktop:dist:mac生成 Windows 安装包：
pnpm run desktop:dist:win产物会输出到 release/。首次启动会随机选择一个可用端口，修改监听地址、端口或访问密码后会自动重启服务让配置生效。
使用前需要本机已安装 Codex Desktop。
命令行启动
如果只是临时调试，也可以通过命令行启动：
局域网：
pnpm install
PORT=3737 pnpm run web:dev支持远程访问：
pnpm install
HOST=0.0.0.0 PORT=3737 pnpm run web:dev强烈建议设置访问密码和修改端口。可以复制示例配置后编辑其中的密码：
cp config.example.yaml config.yaml配置示例：
auth:
password: "你的密码"启动后访问：
http://127.0.0.1:3737如果需要在其他设备访问，请使用 Launcher 展示的局域网地址，或配合 Tailscale、ZeroTier、企业自建 VPN 等方式实现远程局域网访问。
不建议把 OpenCodex 直接暴露到公网。
启动后打不开页面
可以先确认服务是否正常：
curl http://127.0.0.1:3737/api/health如果端口被占用，可以换一个端口：
PORT=3738 pnpm run web:dev常用环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
HOST | 0.0.0.0 | 命令行 gateway 监听地址。 |
PORT | 3737 | 命令行 gateway 监听端口。 |
OPENCODEX_HOST | 127.0.0.1 | Launcher 首次启动 gateway 时使用的默认监听地址。 |
OPENCODEX_PORT | 随机可用端口 | Launcher 首次启动 gateway 时使用的默认端口。 |
OPENCODEX_PREFERRED_LANGUAGES | zh-CN | OpenCodex 自有界面语言首选列表，支持 JSON 数组或逗号分隔，例如 ["zh-Hans-CN","en-CN"]。Launcher 会自动传入系统首选语言。 |
CODEX_WEB_CONFIG_PATH | config.yaml | gateway 认证配置文件路径。 |
CODEX_WEB_AUTH_TOKEN_TTL_MS | 43200000 | gateway 访问 token 有效期，默认 12 小时。 |
CODEX_WEB_DEBUG | 空 | 设为 1 或 true 后输出更多调试日志。 |
CODEX_WEB_SLOW_LOG_MS | 750 | IPC 慢调用日志阈值，单位毫秒。 |
CODEX_WEB_LOCAL_FILE_TOKEN_TTL_MS | 300000 | 本地文件预览 URL token 有效期，单位毫秒。 |
CODEX_DESKTOP_APP_PATH | 自动扫描 | 指定 Codex Desktop 安装路径或 app.asar 所在路径。 |
CODEX_WEB_RUNTIME_DIR | .data/runtime | 命令行 gateway 运行目录；打包态由 Launcher 指向用户数据目录。 |
CODEX_WEB_OFFICIAL_BUNDLE_DIR | .data/cache/codex-official-bundle | 指定官方 bundle 解包缓存目录。 |
CODEX_WEB_OFFICIAL_USER_DATA_DIR | .data/official-user-data | 指定官方 Electron profile 隔离目录。 |
CODEX_HOME | ~/.codex | Codex CLI / app-server 的配置和运行数据目录。 |
常见问题
OpenCodex 是一个中间件层，为 Codex Desktop 提供服务，提供了一个可安装的 JavaScript 中间件层，方便开发者使用手机或平板电脑等设备进行操作。然而，需要注意的是 OpenCodex 的安装和使用可能存在一些风险和挑战。
- 需要 OpenCodex 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
⚡ 核心功能
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 需要 OpenCodex 解决具体问题的开发者与运营人员
- 先在测试环境跑通最小用例，再接入生产数据
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
👥 适合人群
🎯 使用场景
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
⚖️ 优点与不足
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- +开发者社区支持，遇问题可查可问
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
该工具使用 AGPL-3.0 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
⚠️ AGPL 3.0 — 最严格的 Copyleft，网络服务端使用也需开源，SaaS 使用受限。
🔗 相关工具推荐
❓ 常见问题 FAQ
经综合评估，OpenCodex 在AI工具赛道中表现稳健，质量良好。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | OpenCodex |
| 原始描述 | 开源AI工具：OpenCodex is a middleware layer for Codex Desktop. It lets you use a phone, tabl。⭐267 · JavaScript |
| Topics | installablejavascript |
| GitHub | https://github.com/RyensX/OpenCodex |
| License | AGPL-3.0 |
| 语言 | JavaScript |
收录时间：2026-06-10 · 更新时间：2026-06-10 · License：AGPL-3.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。