了解开源入口
OpenAI 会以 open 的方式开发 Codex 的关键部分。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 开源组件 | OSS components | Codex 生态里开源的那部分组件。 |
| 组件边界 | component scope | 分清哪个问题该去哪个组件反馈。 |
| 高质量 issue | quality issue | 含复现、环境、预期的有效问题报告。 |
不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你分清开源组件边界、写出高质量 issue 或贡献。
你是 Codex 开源参与顾问，帮我分清该去哪个开源组件反馈、写出能被接受的高质量 issue 或贡献。
【角色】
你了解 Codex 的开源组件、在哪里报告问题和提需求、贡献前怎么分清组件边界、高质量 issue 应包含什么。
【输入】
- 我遇到的问题或想提的需求：___
- 涉及的功能 / 组件：___
- 我能提供的复现信息：___
- 我想贡献的方式（报 bug / 提 PR / 提需求）：___
【工作流程】
1. 判断这个问题属于哪个开源组件
2. 确认该去哪里报告 / 贡献
3. 帮我把信息整理成高质量 issue（复现 / 环境 / 预期）
4. 给贡献前的注意事项
【输出规范】
▌一、问题归属的组件
▌二、报告 / 贡献的正确入口
▌三、高质量 issue 草稿（复现 / 环境 / 预期 / 实际）
▌四、贡献注意事项
【硬约束】
- 先分清组件边界，别报错地方
- issue 必须含可复现信息，不只说"不工作"
- 尊重各组件的贡献规范
- 敏感信息不放进公开 issue
- 不确定的归属标注需查官方仓库OpenAI 会以 open 的方式开发 Codex 的关键部分。
这些工作位于 GitHub，方便你跟踪进展、报告 issues，并贡献 improvements。
如果你维护 widely used open-source project，或想 nominate 那些 stewarding important projects 的 maintainers，也可以申请 Codex for OSS program，获得 API credits、ChatGPT Pro with Codex，以及 Codex Security 的 selective access。
Open-Source Components
| Component | Where to find | Notes |
|---|---|---|
| Codex CLI | openai/codex | Codex open-source development 的主要位置。 |
| Codex SDK | openai/codex/sdk | SDK sources 位于 Codex repo 中。 |
| Codex App Server | openai/codex/codex-rs/app-server | App-server sources 位于 Codex repo 中。 |
| Skills | openai/skills | 扩展 Codex 的 reusable skills。 |
| IDE extension | - | Not open source。 |
| Codex web | - | Not open source。 |
| Universal cloud environment | openai/codex-universal | Codex cloud 使用的 base environment。 |
Where to Report Issues and Request Features
Codex components 的 bug reports 和 feature requests 都使用 Codex GitHub repository：
- Bug reports and feature requests：openai/codex/issues
- Discussion forum：openai/codex/discussions
提交 issue 时，请尽量包含你使用的 component，例如 CLI、SDK、IDE extension 或 Codex web，以及对应 version。
贡献前先分清组件边界
Codex 不是所有部分都开源。开 issue 或提交 PR 前，先判断你遇到的问题属于哪个层：
| 现象 | 优先入口 |
|---|---|
| CLI 命令、TUI、配置、sandbox、rules、MCP 行为异常 | openai/codex issue。 |
| SDK 类型、thread 控制、server-side integration 问题 | openai/codex repo 的 SDK 区域。 |
| Cloud environment 基础镜像缺包或版本问题 | openai/codex-universal。 |
| Skill 结构、示例、可复用 workflow | openai/skills。 |
| IDE extension 或 Codex web 产品体验 | 官方 docs、support 或对应反馈入口；不要假设源码可改。 |
这一步能减少无效 issue。比如“VS Code extension 的 UI 按钮不显示”不能直接当成 openai/codex CLI bug；“universal image 缺系统包”也不应发到 skills repo。
高质量 issue 应包含什么
提交前准备：
- Codex version。
- OS 和 shell。
- 入口：CLI、SDK、app server、Cloud、IDE、Web。
- 最小复现命令或步骤。
- 期望行为和实际行为。
- 相关 config 片段，删掉 token、key、cookie 和私有路径。
- 如果是 Cloud 或 remote，说明 environment、repo、branch、setup script 是否相关。
如果问题涉及安全、凭据或 private repo，不要把敏感材料直接贴到 public issue。先走官方安全或支持渠道。