diff --git a/README.md b/README.md index 7a3e93b..273f463 100644 --- a/README.md +++ b/README.md @@ -100,8 +100,7 @@ 1. [Vibe Coding 经验](./assets/documents/guides/getting-started/Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环 2. [网络环境配置](./assets/documents/guides/getting-started/网络环境配置.md) - 配置网络访问 3. [开发环境搭建](./assets/documents/guides/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境 -4. [IDE配置](./assets/documents/guides/getting-started/IDE配置.md) - 配置 VS Code 编辑器 -5. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线,使用 gpt-5.5 与仓库配置基线 +4. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线,使用 gpt-5.5 与仓库配置基线 diff --git a/assets/documents/guides/getting-started/Codex-CLI配置.md b/assets/documents/guides/getting-started/Codex-CLI配置.md index 7b24d30..2394e85 100644 --- a/assets/documents/guides/getting-started/Codex-CLI配置.md +++ b/assets/documents/guides/getting-started/Codex-CLI配置.md @@ -8,6 +8,29 @@ Codex CLI 是本教程默认推荐的 AI CLI。它适合承担从需求拆解、 OpenCode CLI 保留为备选方案:当你暂时无法使用 OpenAI / Codex CLI,或只想接入免费模型时,再使用 [OpenCode-CLI配置](./OpenCode-CLI配置.md)。 +## 遇到问题先这样问 AI + +如果安装过程中报错,不要只复制最后一行错误。请把以下三部分一起发给 AI(可以用 ChatGPT / Claude / Gemini 网页版): + +1. 你的系统:Windows 11 / WSL2 Ubuntu / Ubuntu / Debian / macOS。 +2. 完整报错:从你执行的命令开始,到错误结束,全部复制。 +3. 本文档全文:把本页从标题到末尾完整复制给 AI,让它基于本文档判断你卡在哪一步。 + +推荐提问模板: + +```text +我正在按下面这份 Codex CLI 安装文档配置一台新电脑,但遇到了报错。 + +我的系统是:____ +我执行的命令是:____ +完整报错如下: +____ + +下面是我正在遵循的完整安装文档。请你判断我卡在哪一步,给出最小修复命令,并说明修复后如何验证。 + +[把本文档全文粘贴到这里] +``` + ## 总流程 ```text @@ -301,6 +324,4 @@ codex login → [开发环境搭建](./开发环境搭建.md) - 回看基础环境 -→ [IDE 配置](./IDE配置.md) - 配置编辑器 - → [OpenCode-CLI配置](./OpenCode-CLI配置.md) - Codex CLI 不可用时的备选方案 diff --git a/assets/documents/guides/getting-started/README.md b/assets/documents/guides/getting-started/README.md index a259737..6980feb 100644 --- a/assets/documents/guides/getting-started/README.md +++ b/assets/documents/guides/getting-started/README.md @@ -8,8 +8,7 @@ 1. [Vibe Coding 经验](./Vibe%20Coding%20经验.md) - 明确语言化、门禁、人机分工与工程闭环 2. [网络环境配置](./网络环境配置.md) - 配置网络访问 3. [开发环境搭建](./开发环境搭建.md) - 搭建 Git、Node.js、Python、编辑器等基础环境 -4. [IDE 配置](./IDE配置.md) - 配置编辑器 -5. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线 +4. [Codex CLI 配置](./Codex-CLI配置.md) - 默认 AI CLI 路线 ## 🔗 相关资源 - [基础指南](../../principles/fundamentals/) - 核心理念与方法论