mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-02 13:47:45 +00:00
docs: prioritize codex cli setup path
This commit is contained in:
@@ -6,6 +6,17 @@
|
||||
|
||||
从上到下阅读即可:先明确学习路线和人机分工,再解决网络、CLI 与开发环境。遇到卡点时,把当前小节全文、你执行的命令和完整报错一起发给网页版 AI,让它按你的系统生成逐步修复命令。
|
||||
|
||||
## 最短路径:先跑通 Codex CLI
|
||||
|
||||
对新手来说,最优先配置的不是完整开发环境,而是先满足 Codex CLI 的两个前置条件:可访问 OpenAI 的网络环境,以及可用的 Codex / ChatGPT 订阅。只要 Codex CLI 跑通,就可以让 Codex Agent 读取本文档和当前系统信息,主动完成 Git、Node.js、Python、编辑器、项目依赖、测试命令、Git 初始化等后续配置。用户主要负责提供授权、复制报错、确认结果和保存版本。
|
||||
|
||||
默认策略:
|
||||
|
||||
- 先解决网络环境和 Codex / ChatGPT 订阅。
|
||||
- 再安装并登录 Codex CLI。
|
||||
- Codex CLI 可用后,优先让本地 Agent 主动配置剩余开发环境。
|
||||
- 只有遇到网页登录、订阅购买、验证码、系统密码、管理员授权、敏感凭证或不可逆操作时,才需要用户介入。
|
||||
|
||||
## 线性目录
|
||||
|
||||
- 1. 学习地图
|
||||
@@ -43,11 +54,11 @@
|
||||
1. [问题求解能力](../concepts/问题求解能力.md)
|
||||
先学会把问题说清楚:目标、现状、差距、标准、约束、对象、路径。
|
||||
2. [网络环境配置](README.md)
|
||||
解决访问 AI 工具、GitHub、文档和依赖源的问题。
|
||||
先解决访问 OpenAI、GitHub、文档和依赖源的问题。
|
||||
3. [CLI 配置](README.md)
|
||||
配置默认 AI CLI 路线,让 AI 能在终端里协助执行工程动作。
|
||||
配置并登录 Codex CLI,让本地 Agent 能在终端里执行工程动作。
|
||||
4. [开发环境搭建](README.md)
|
||||
配好 Git、Node.js、Python、编辑器等基础环境。
|
||||
优先交给 Codex Agent 主动检查和配置 Git、Node.js、Python、编辑器、项目依赖与测试命令。
|
||||
5. [Vibe Coding 经验](README.md)
|
||||
学会人机分工、门禁、复盘和用 AI 审 AI。
|
||||
|
||||
@@ -147,8 +158,9 @@
|
||||
```text
|
||||
问题求解能力
|
||||
-> 网络环境配置
|
||||
-> CLI 配置
|
||||
-> 开发环境搭建
|
||||
-> Codex / ChatGPT 订阅与登录准备
|
||||
-> Codex CLI 配置
|
||||
-> 让 Codex Agent 主动配置开发环境
|
||||
-> Vibe Coding 经验
|
||||
-> 拼好码
|
||||
-> 工程实践
|
||||
@@ -412,6 +424,8 @@ Codex CLI 是本教程默认推荐的 AI CLI。它适合承担从需求拆解、
|
||||
|
||||
OpenCode CLI 只作为备选方案保留在本文底部:当你暂时无法使用 OpenAI / Codex CLI,或只想接入免费、本地、多模型实验入口时,再使用 OpenCode。
|
||||
|
||||
Codex CLI 跑通后,不要再把所有环境配置都当成人工步骤。优先让 Codex Agent 读取本文档和当前系统信息,主动完成后续开发环境配置。
|
||||
|
||||
### 不会操作?先让网页 AI 生成逐步执行版
|
||||
|
||||
如果你不确定该执行哪一段安装命令,打开 ChatGPT / Claude / Gemini 网页版,把下面提示词和本文档全文一起粘贴进去,让 AI 根据你的电脑情况生成专属安装步骤。
|
||||
@@ -451,6 +465,30 @@ ____
|
||||
[把本文档全文粘贴到这里]
|
||||
```
|
||||
|
||||
### Codex CLI 跑通后:交给 Agent 配置剩余环境
|
||||
|
||||
当 `codex --version` 正常输出,并且 `codex login` 已完成网页登录后,直接在项目目录里启动 Codex,把下面提示词交给本地 Agent:
|
||||
|
||||
```text
|
||||
你现在是我的本地开发环境配置 Agent。
|
||||
|
||||
前提:
|
||||
- 我已经能运行 Codex CLI。
|
||||
- 我已经完成 Codex 登录。
|
||||
- 当前仓库是 vibe-coding-cn。
|
||||
- 请尽量主动完成配置,除非遇到必须由我授权、输入密码、网页登录、购买订阅、处理敏感凭证或执行不可逆操作的步骤。
|
||||
|
||||
目标:
|
||||
请读取 docs/getting-started/README.md,根据我的系统环境,自动检查并配置 Git、Node.js、Python、包管理器、编辑器建议、项目依赖、测试命令和 Git 工作流。
|
||||
|
||||
要求:
|
||||
1. 先检查当前系统,不要猜。
|
||||
2. 能自动执行的就自动执行。
|
||||
3. 需要我操作的,只输出最小步骤。
|
||||
4. 每完成一步都运行验证命令。
|
||||
5. 最后输出已完成项、未完成项、风险和下一步。
|
||||
```
|
||||
|
||||
### 总流程
|
||||
|
||||
```text
|
||||
@@ -862,9 +900,9 @@ opencode
|
||||
|
||||
## 5. 开发环境搭建
|
||||
|
||||
> 使用方法:复制下方对应你设备的提示词,粘贴到任意 AI 对话框(ChatGPT、Claude、Gemini 网页版等),AI 会一步步指导你完成配置。
|
||||
> 使用方法:Codex CLI 已跑通时,优先让 Codex Agent 读取本节并主动配置剩余环境;Codex CLI 不可用时,再复制下方对应你设备的提示词,粘贴到任意 AI 对话框(ChatGPT、Claude、Gemini 网页版等),让网页 AI 一步步指导你完成配置。
|
||||
|
||||
**前置条件**:请先完成 [网络环境配置](README.md)
|
||||
**前置条件**:请先完成 [网络环境配置](README.md)。推荐先完成 [CLI 配置](README.md),让 Codex Agent 接管后续开发环境搭建。
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user