瞭解開源入口
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。先走官方安全或支援渠道。