内容
# Awesome Codex Guide
**给中文开发者看的 OpenAI Codex 使用手册。**
这里收官方文档、中文教程、社区项目和一些可直接复制的工作流。重点是少绕路,少踩坑。
[English](./README.en.md) | [中文](./README.zh-CN.md)
<img src="assets/banner.webp" alt="Awesome Codex Guide banner" width="100%">
## 先看这些
| 你的目标 | 入口 |
| --- | --- |
| 先弄清怎么学 | [入门路线](./docs/getting-started/README.zh-CN.md) |
| 安装和使用 Codex CLI | [CLI 使用](./docs/codex-cli/README.zh-CN.md) |
| 写好项目级指令 | [AGENTS.md](./docs/agents-md/README.zh-CN.md) |
| 别把权限放太大 | [权限与安全](./docs/permissions-security/README.zh-CN.md) |
| 找 MCP、Skills、Plugins、Subagents | [扩展资源](./docs/resources/ecosystem.zh-CN.md) |
| 解决 401、沙箱、配置问题 | [排障手册](./docs/troubleshooting/common-errors.zh-CN.md) |
| 复制常用工作流 | [工作流](./docs/workflows/README.zh-CN.md) |
## 推荐资源
- [OpenAI Codex official docs](https://developers.openai.com/codex/quickstart) - 官方入口。
- [openai/codex](https://github.com/openai/codex) - 官方 Codex CLI 仓库。
- [ComposioHQ/awesome-codex-skills](https://github.com/ComposioHQ/awesome-codex-skills) - Codex Skills 资源。
- [VoltAgent/awesome-codex-subagents](https://github.com/VoltAgent/awesome-codex-subagents) - Codex Subagents 集合。
- [hashgraph-online/awesome-codex-plugins](https://github.com/hashgraph-online/awesome-codex-plugins) - Codex plugins 资源。
- [RoggeOhta/awesome-codex-cli](https://github.com/RoggeOhta/awesome-codex-cli) - Codex CLI 工具索引。
- [bozhouDev/codex-orange-book](https://github.com/bozhouDev/codex-orange-book) - 中文 Codex 橙皮书,有安装、配置和案例。
- [freestylefly/CodexGuide](https://github.com/freestylefly/CodexGuide) - 中文 CodexGuide 开源仓库。
- [CodexGuide.ai](https://codexguide.ai/) - 中文 Codex 教程站,有 App、CLI、AGENTS.md、权限、排障和案例。
社区资源可以参考,但涉及登录、订阅、API key、权限和安全策略时,先看官方资料。
## 许可证
[MIT](./LICENSE)