Vibe Coding 快速开始

快速开始本页是 Vibe Coding 的行动入口——不讨论原理不铺陈背景只做一件事让你在 30 分钟内从零基础走到用 AI 写出第一个可运行项目。如果你刚了解 Vibe Coding 是什么建议先阅读 Overview---获得全局认知。本页之后按需前往 Environment Setup Guide---深化配置或浏览 Tool Ecosystem Primer---了解完整工具链。整个快速开始流程遵循一个核心循环人类描述意图 → AI 生成计划 → 分步执行 → 验证迭代。你不需要会写代码只需要会说清楚想要什么。1.一分钟体验复制粘贴即启动如果你已经有网络和浏览器现在就能感受 Vibe Coding 的核心范式——把 AI 当结对编程伙伴你做产品经理AI 做工程师。打开 Claude 或 ChatGPT粘贴以下提示词你是一个专业的 AI 编程助手。我想用 Vibe Coding 的方式开发一个项目。 请先问我 1. 你想做什么项目一句话描述 2. 你熟悉什么编程语言不熟悉也没关系 3. 你的操作系统是什么 然后帮我 1. 推荐最简单的技术栈 2. 生成项目结构 3. 一步步指导我完成开发 要求每完成一步问我是否成功再继续下一步。这就是 Vibe Coding 的起点——不需要安装任何软件不需要配置任何环境用自然语言和 AI 对话让想法变成代码。AI 会根据你的回答推荐技术栈、生成项目结构、分步指导开发。每完成一步它会等你确认成功后再继续下一步确保你永远不会掉队。2.完整入门路径全景一分钟体验只是冰山一角。要真正驾驭 Vibe Coding你需要完成一条从哲学认知到环境就绪到动手开发的渐进路径。下图展示了这条路径的完整结构和各阶段之间的依赖关系五个阶段由浅入深。哲学层帮你建立正确的思维模型基础设施层确保你的工具链畅通无阻行动层则是真正开始创造。每个阶段完成后都有明确的验证标准确保你可以放心地进入下一步。下表概括了每个阶段的核心任务、预计耗时和验证方式阶段核心任务预计耗时验证方式 理解哲学阅读核心理念建立人上 AI 下思维10 分钟能用自己的话解释 Vibe Coding 网络配置配置代理访问 GitHub / Claude / Google10-15 分钟curl -I https://github.com返回 200️ 开发环境安装 Node.js、Git、Python 等基础工具20-30 分钟node -v、git --version正常输出 IDE 配置配置 VS Code / Cursor / Windsurf15 分钟编辑器可正常打开项目文件夹 AI CLI安装 Claude Code / Codex CLI / OpenCode10 分钟终端可启动 AI 对话 第一个项目用 Memory Bank 模式启动开发持续产出可运行的最小原型1.第一步理解 Vibe Coding 哲学在动手之前你需要理解 Vibe Coding 的三条铁律它们会贯穿你后续的所有开发活动人上 AI 下——你是产品经理和架构师AI 是执行者。你的职责是描述意图、审查方案、验证结果AI 的职责是生成代码、排查错误、执行计划。上下文为王——垃圾进垃圾出。你给 AI 的上下文越精确产出质量越高。文档不是事后补的而是开发前的第一性投入。胶水编程——能抄不写能连不造能复用不原创。把注意力从造轮子迁移到连接方式从根本上规避 AI 幻觉和复杂性爆炸。为什么要先学哲学因为 Vibe Coding 不是一种工具而是一种思维方式的转变。传统编程是人写代码Vibe Coding 是人描述意图AI 生成代码人验证结果。如果你带着传统编程思维进入 Vibe Coding会在每一步都感到别扭。哲学认知到位后后面的所有操作都会变得直觉化。在概念骨架层面本项目默认使用一套极简框架来理解世界、描述变化与整理知识对象 → 状态 → 快照 → 序列 → 过程 → 变换 → 同一/差异 → 关系。这个骨架是所有方法论术语的共同根基阅读 理解世界、描述变化、整理知识的一套较小骨架 可获得完整理解。完成哲学认知后你已经具备了 Vibe Coding 的操作系统。接下来的所有步骤都只是在这个操作系统上安装应用。2.第二步配置网络环境Vibe Coding 依赖大量海外 AI 服务Claude、ChatGPT、Gemini、GitHub稳定的网络访问是硬性前置条件。如果你已经能正常访问这些服务可以跳过此步。配置过程只有四个环节最简方案如果你不想手动配置复制下面的提示词给任意 AI 对话框包括国内的 AI它会根据你的操作系统一步步指导你完成 FlClash 的安装和配置你是一个耐心的网络环境配置助手。我需要配置网络代理 以便能够访问 GitHub、Google、Claude 等国外服务。 我的情况 - 操作系统[请告诉我你用的是 Windows/macOS/Linux/Android] - 我已经有一个代理服务订阅链接机场订阅 请指导我使用 FlClash 客户端配置网络代理。 每完成一步问我是否成功然后再继续下一步。手动方案的关键设置项设置项操作说明虚拟网卡 (TUN)开启实现全局流量代理终端自动走代理系统代理开启让系统应用走代理代理模式全局模式确保所有流量经过代理验证配置成功的命令curl -I https://www.google.com curl -I https://github.com # 应返回 HTTP/2 2003.第三步搭建开发环境网络就绪后下一步是安装开发所需的基础工具。Vibe Coding 的推荐方式非常Vibe——让 AI 帮你配环境。根据你的操作系统复制对应的提示词粘贴到任意 AI 对话框中Windows 用户推荐 WSL2 方案你是一个耐心的开发环境配置助手。我是一个完全的新手 使用 Windows 系统需要你一步一步指导我通过 WSL2 搭建 Linux 开发环境。 请按以下顺序指导我每次只给我一个步骤等我确认完成后再进行下一步 1. 安装 WSL2Windows Subsystem for Linux 2. 在 WSL2 中安装 Ubuntu 3. 配置 Ubuntu 基础环境更新系统 4. 安装 nvm 和 Node.js 5. 安装 Gemini CLI 或其他免费 AI CLI 工具 6. 安装基础开发工具git, python, build-essential, tmux 7. 配置 Git 用户信息 8. 安装代码编辑器VS Code 并配置 WSL 插件 9. 验证所有工具是否正常工作macOS 用户你是一个耐心的开发环境配置助手。我是一个完全的新手 使用 macOS 系统需要你一步一步指导我从零搭建 Vibe Coding 开发环境。 请按以下顺序指导我每次只给我一个步骤 1. 安装 Homebrew 包管理器 2. 使用 Homebrew 安装 Node.js 3. 安装 Gemini CLI 或其他免费 AI CLI 工具 4. 安装基础开发工具git, python, tmux 5. 配置 Git 用户信息 6. 安装代码编辑器VS Code 或 Neovim 7. 验证所有工具是否正常工作Linux 用户你是一个耐心的开发环境配置助手。我是一个完全的新手 使用 Linux 系统Ubuntu/Debian需要你一步一步指导我从零搭建开发环境。 请按以下顺序指导我每次只给我一个步骤 1. 更新系统并安装基础依赖 2. 安装 nvm 和 Node.js 3. 安装 Gemini CLI 或其他免费 AI CLI 工具 4. 安装开发工具git, python, tmux 5. 配置 Git 用户信息 6. 安装代码编辑器 7. 验证所有工具是否正常工作环境搭建完成后你需要安装的核心工具清单如下工具用途必选/可选Node.js (via nvm)运行 AI CLI 工具和前端项目必选Git版本控制必选Python 3.8部分辅助工具和后端项目推荐tmux终端复用AI 蜂群协作推荐build-essentialC/C 编译工具链推荐4.第四步配置 IDE 和 AI CLI 工具开发环境就绪后你需要选择一个 IDE 和至少一个 AI CLI 工具。这是 Vibe Coding 的武器库。1.IDE 选择IDE定位适合人群费用VS Code最通用的代码编辑器所有人免费CursorAI 原生 IDE基于 VS Code想要内置 AI 功能的开发者订阅制WindsurfAI 原生 IDE新用户想免费试用 AI 开发新用户免费额度VS Code 是最安全的选择本仓库的 IDE 配置指南以 VS Code 为主线。同样你可以复制对应的提示词让 AI 指导你完成 VS Code 的安装和扩展配置GitLens、Prettier、ESLint、Local History 等核心扩展。2.AI CLI 工具AI CLI 是 Vibe Coding 的核心引擎。终端中的 AI CLI 比网页版对话拥有更强的上下文管理能力和文件操作能力。本项目推荐的三种 AI CLI 工具工具背后模型费用启动方式Claude CodeClaude Opus 4.6付费Claude 订阅claudeCodex CLIgpt-5.3-codex付费OpenAI 订阅codexOpenCodeGLM-4.7 / MiniMax M2.1 / Kimi K2免费opencode预算有限的开发者强烈推荐从OpenCode开始。它支持 75 模型包括 GLM-4.7、MiniMax M2.1、Kimi K2 等免费模型无需信用卡一个命令即可安装curl -fsSL https://opencode.ai/install | bash。安装后在交互界面中运行/connect连接 Z.AI 获取免费 API Key再用/models选择 GLM-4.7 即可开始使用。安装完成后建议在~/.bashrc中配置一键启动别名免去每次输入长参数的麻烦# Claude Code - 跳过所有确认谨慎使用 alias ccclaude --dangerously-skip-permissions # Gemini CLI - YOLO 模式 alias ggemini --yolo配置后执行source ~/.bashrc使别名生效。5.第五步用 Memory Bank 模式启动第一个项目所有工具就位后你将使用 Vibe Coding 的标准开发流程——Memory Bank 模式——来启动你的第一个项目。这套流程源自原仓库 EnzeD/vibe-coding 的实战验证适用于游戏、Web 应用、工具脚本等任何类型的项目。具体操作步骤1.Step 1-3生成项目文档在 AI 对话框中依次完成三件事如果你做的是应用而非游戏把游戏设计文档替换为产品需求文档 PRD即可描述你的项目创意让 AI 生成game-design-document.md让 AI 推荐最简单但最健壮的技术栈保存为tech-stack.md让 AI 生成分步实施计划每步小而具体、包含验证测试、不包含代码保存为implementation-plan.md2.Step 4创建 Memory Bank在项目根目录创建memory-bank/文件夹放入所有生成的.md文件并新建两个空文件progress.md记录进度和architecture.md记录架构。3.Step 5让 AI 吃透上下文在项目目录下启动你的 AI CLI 工具输入阅读 /memory-bank 里所有文档implementation-plan.md 是否完全清晰 你有哪些问题需要我澄清让它对你来说 100% 明确AI 通常会问 9-10 个问题。全部回答完后让它根据你的回答更新implementation-plan.md。4.Step 6逐步执行阅读 memory-bank 所有文档然后执行实施计划的第 1 步。 我会负责跑测试。在我验证测试通过前不要开始第 2 步。 验证通过后更新 progress.md 和 architecture.md。⚠️关键原则永远先用 Plan 模式Claude Code 中按ShiftTab确认 AI 的方案满意后再让它执行。每完成一步都提交 Git、更新progress.md、开启新对话再继续下一步。极致 Vibe 技巧安装 Superwhisper 后你可以用语音和 AI 随意聊天完全不用打字。另外在 Claude Code 中触发深度思考的关键词强度递增为thinkthink hardthink harderultrathink。6.仓库资源速查完成快速开始后你会需要持续使用本仓库的丰富资源。以下是按用途分类的核心资源入口资源路径用途入门指南合集assets/documents/guides/getting-started/从零开始的详细教程方法论与经验assets/documents/guides/playbook/Canvas 白板、AI 蜂群、tmux 等核心原则assets/documents/principles/fundamentals/胶水编程、血的教训、常见坑哲学方法论assets/documents/principles/philosophy/23 种可落地的哲学方法实战案例assets/documents/case-studies/真实项目案例参考提示词云端表格Google Sheets系统提示词、编程提示词、元提示词Skills 技能库assets/skills/20 个专业领域 AI 技能自动开发闭环assets/workflow/auto-dev-loop/自动化开发工作流模板AGENTS.mdAGENTS.mdAI Agent 操作手册与行为约束7.遇到问题怎么办Vibe Coding 的核心理念之一是**一切问题问 AI**。以下是常见场景的处理方式场景解决方案AI 生成代码报错复制错误信息或截图贴给 AI让它分析修复某步提示词搞崩了项目Claude Code 用/rewind回退Codex CLI 用git reset终极卡壳用 RepoPrompt 把整个代码库合成一个文件丢给 AI提示词效果不好加一句慢慢想不着急重要的是严格按我说的做AI 犯重复错误整理错误模式为经验文档持久化存储遇到问题时让 AI 检索部分应用不走代理确认 TUN 模式虚拟网卡已开启8.下一步去哪里恭喜你完成了快速开始根据你的当前状态和兴趣下一章节环境搭建指南