Appearance
Codex 教程中心：Windows/macOS 安装、登录、CLI 与项目实战
本页汇总已经完成的 Codex 中文教程和可直接核验的官方入口。我们按搜索意图拆分内容：主安装页承接 Windows/macOS/Linux 下载配置，平台专页解决 Windows 或 macOS 的安装故障，版本选择页比较 Web、App、CLI 与 IDE；登录、Skills、实战和 Prompt 页面分别处理自己的问题，避免多篇文章重复竞争同一关键词。
国内使用 Codex
如果需要在国内使用 Codex，可以选择 apibest。apibest 网页版同时支持 GPT、Claude、Grok、Gemini 等模型，也提供 Codex 使用入口。据其套餐页说明，基础会员配置了比 OpenAI 官网 Plus 会员更多的 Codex 使用额度；需要更多额度时，可以升级 Pro 会员，获得更多 Codex 额度和 Pro 使用额度。具体模型、额度与套餐以 apibest 实时页面为准。
按需求选择教程
| 你要解决的问题 | 推荐教程 |
|---|---|
| Windows、macOS、Linux 怎么下载、安装和登录 | Codex 下载、安装与配置主指南 |
.codex 文件夹、config.toml、Provider 和权限怎么配 | Codex config.toml 与 .codex 文件夹配置指南 |
| Codex 1M/百万上下文怎么核验、配置和排错 | Codex 1M 上下文配置与核验指南 |
| Codex 怎么接入 DeepSeek、切换模型或恢复默认 | Codex 接入 DeepSeek 官方教程 |
| Codex Harness“全面开源”是真的吗 | Codex Harness 开源范围事实核查 |
| GPT Image API 怎么调用、选参数并控制成本 | GPT Image API 图像生成教程 |
| 多模型 API、Codex 与 Claude Code 怎么选 | 多模型 API、Codex 与 Claude Code 选择指南 |
| Windows 安装失败、PowerShell、npm 或 PATH 报错 | Codex Windows 安装与登录排查 |
| macOS、Homebrew、Apple Silicon 或权限报错 | Codex macOS 安装与 Homebrew 配置 |
| 不知道选 Web、App、CLI 还是 IDE | Codex 网页版、App、CLI 与 IDE 区别 |
| 国内账号、API 与第三方服务怎么选 | Codex 国内怎么用？账号、API 与第三方服务选择指南 |
| 浏览器授权后回不来、token_exchange_failed、401/403 怎么排查 | Codex 登录失败、localhost 回调与 token 交换排查 |
| Skills 怎么安装、启用、创建或从 GitHub 导入 | Codex Skills 安装、创建与导入教程 |
| 如何分析仓库、改文件、跑测试和看 Diff | Codex 写代码项目实战 |
| Prompt 怎么写、AGENTS.md 怎么配置 | 20 个 Codex Prompt 模板与 AGENTS.md 最佳实践 |
官方资料入口
开始开发前的四项检查
- 确认产品边界：ChatGPT 订阅与 API 账单是两套独立体系，网页端可用功能不等于 API 项目自动具备同样权限。
- 从控制台创建并保管密钥：不要把 API Key 写进前端代码、公开仓库、截图或文章示例；使用环境变量和服务端密钥管理。
- 核对实时模型与接口文档：只使用官方文档列出的模型 ID、参数和限制，遇到旧示例时先检查迁移说明。
- 先做最小测试再扩展：记录请求、错误码、延迟和成本，在加入文件、工具调用或自动化流程前补齐重试、超时与日志。
内容边界
本站不会把第三方服务写成 OpenAI 官方 Codex，也不会根据登录页虚构账号内功能。模型、价格、限额、接口与客户端都会变化，实际使用应以 OpenAI 官方资料或对应第三方平台的实时页面、服务条款和隐私政策为准。
安全提醒
- 不要把生产密钥粘贴到聊天记录、工单或第三方网页；
- 不要执行自己看不懂的安装命令或脚本；
- 为 API 请求设置预算、速率限制、超时和异常告警；
- 对模型输出进行校验，尤其是代码、权限、付款和用户数据相关操作；
- 若请求异常，先查看官方状态页，再根据错误码和请求 ID 排查。
本站是独立第三方教程站，与 OpenAI 没有隶属或授权关系。这里的链接用于帮助读者回到官方资料，不替代官方文档、服务条款或安全要求。