官方教程中文版團隊與整合
瞭解開源入口
OpenAI 會以 open 的方式開發 Codex 的關鍵部分。
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。先走官方安全或支援渠道。