docs: align beginner path around codex cli

This commit is contained in:
tukuaiai
2026-05-01 22:01:14 +08:00
parent f9e9b75dd8
commit 98f1f1f632
9 changed files with 216 additions and 43 deletions
+8 -5
View File
@@ -12,7 +12,7 @@
# Vibe Coding 指南
**一个通过与 AI 结对编程,将想法变为现实的终极工作站**
**一套面向零基础学习者的 Vibe Coding 入门到精通教程**
---
@@ -55,7 +55,7 @@
## 🎲 前言
**这是一个不断生长和自我否定的项目,当下的一切经验和能力都可能因 AI 能力的变化而失去意义,所以请时刻保持以 AI 为主的思维,重视这次宇宙级的变革,所有的经验都可能失效,辩证的看🙏🙏🙏****Vibe Coding** 是一个与 AI 结对编程的终极工作流程,旨在帮助开发者丝滑地将想法变为现实。本指南详细介绍了从项目构思、技术选型、实施规划到具体开发、调试和扩展的全过程,强调**规划驱动****模块化****索引构建**为核心(受限于模型上下文窗口而生成的解决策略),避免让 AI 失控导致项目混乱,Vibe Coding(氛围编程)是一种以自然语言驱动、让LLM生成大部分代码的开发方式,主张“先沉浸式做出能跑的东西”,以极低门槛快速产出原型但也伴随可控性与可靠性风险,由计算机科学家 [Andrej Karpathy](https://x.com/karpathy) 首次提出
**这是一个不断生长和自我校正的项目** 本仓库的统一定位是:帮助零基础学习者从环境配置、工具选择、需求表达、计划拆解、AI CLI 协作、代码验证、Git 迭代一路走到可独立交付项目。**Vibe Coding** 不是“让 AI 随便写”,而是用自然语言定义目标,用 Codex CLI 等 AI 工具执行工程动作,再用文档、测试和版本控制把结果固定下来。本指南强调**规划驱动****模块化****索引构建**,目标是让新手能从 0 开始,也能逐步形成可复用的专业工作流
> **注意**:以下经验分享并非普遍适用,请在具体实践中结合场景,辩证采纳(点击标题可以展开收起内容)
@@ -97,11 +97,12 @@
完全新手?按顺序完成以下步骤:
0. [问题求解能力](./assets/documents/principles/fundamentals/问题求解能力.md) - “目标-现状-差距-标准”与“目标-约束-对象-路径”的极简框架
1. [Vibe Coding 哲学原理](./assets/documents/guides/getting-started/Vibe%20Coding%20哲学原理.md) - 理解核心理念
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) - 复制提示词给 AI,让 AI 指导你搭建环境
3. [开发环境搭建](./assets/documents/guides/getting-started/开发环境搭建.md) - 安装 Git、Node.js、Python、编辑器等基础环境
4. [IDE配置](./assets/documents/guides/getting-started/IDE配置.md) - 配置 VS Code 编辑器
5. [OpenCode-CLI配置](./assets/documents/guides/getting-started/OpenCode-CLI配置.md) - 免费 AI CLI 工具,支持 GLM-4.7/MiniMax M2.1 等模型
5. [Codex-CLI配置](./assets/documents/guides/getting-started/Codex-CLI配置.md) - 默认 AI CLI 路线,使用 gpt-5.5 与仓库配置基线
6. [OpenCode-CLI配置](./assets/documents/guides/getting-started/OpenCode-CLI配置.md) - 备选 AI CLI 路线,适合暂时无法使用 Codex CLI 的场景
</details>
@@ -267,6 +268,8 @@ TODO:仓库内没有发现 Dockerfile、docker-compose.yml、K8s/Helm 部署
### 集成开发环境 (IDE) & 终端
* [**Visual Studio Code**](https://code.visualstudio.com/): 一款功能强大的集成开发环境,适合代码阅读与手动修改。其 `Local History` 插件对项目版本管理尤为便捷。
* [**Codex CLI**](./assets/documents/guides/getting-started/Codex-CLI配置.md): 本教程默认 AI CLI 路线,用于需求拆解、代码修改、命令执行、测试验证与 Git 迭代。
* [**OpenCode CLI**](./assets/documents/guides/getting-started/OpenCode-CLI配置.md): 备选 AI CLI 路线,适合 Codex CLI 不可用或需要免费/本地模型的场景。
* **虚拟环境 (.venv)**: 强烈推荐使用,可实现项目环境的一键配置与隔离,特别适用于 Python 开发。
* [**Cursor**](https://cursor.com/): 已经占领用户心智高地,人尽皆知。
* [**Warp**](https://www.warp.dev/): 集成 AI 功能的现代化终端,能有效提升命令行操作和错误排查的效率。