CodeGuide是什么?
CodeGuide是一个旨在连接人类创意与AI编码工具的“翻译器”或“上下文生成器”。该平台的核心定位是通过将模糊的项目想法或现有代码库转化为结构化、详尽的项目知识库，为AI编码工具提供精准的上下文，从而解决AI因缺乏足够信息而生成错误、无关或低质量代码的“幻觉”（Hallucination）问题。
CodeGuide的价值主张是 “80%规划，20%执行” 。它强调，通过前期充分的规划和文档制定，可以极大提升后续AI编码的效率和质量，避免数小时的无效调试和返工。平台能够为AI编程项目生成详细的项目文档，包括产品需求文档（PRDs）、技术栈等，并与所有主流的AI编程工具兼容。
产品功能
AI驱动文档生成
CodeGuide能够根据用户用简单英语描述的项目想法，自动生成一套完整的项目文档包。这个过程包括：
为新想法生成蓝图：用户描述想法后，系统会提出几个澄清问题，随后生成包含产品需求文档（PRD）、技术栈建议、系统架构图、前端指南、后端与数据库设计、线框图以及分步任务清单在内的完整文档。
为现有代码库生成文档：平台可以分析用户已有的GitHub项目，将遗留代码映射成清晰的文档（含Mermaid图表），使AI工具能理解现有架构，确保新功能与原有代码兼容。
自主编码代理（Software v2）
CodeGuide提供了一个名为Software v2的自主编码代理，这是一个统一界面，可协调多种AI模型同步工作以实现自主编码的目标。其特点包括：
统一代理界面：支持协调OpenAI、Claude及开源模型等多种AI模型。
模型路由：根据不同的用例（如代码分析、UI编辑、逻辑实现）自动选择最合适的AI模型。
强大的UI编辑器：允许用户在屏幕上直接编辑代码、添加评论，并并行运行多个代理来修复UI问题或添加新功能。
开源启动套件（Starter Kits）
平台提供一系列针对AI模型优化过的、生产就绪的全栈项目模板，内置常用功能（如身份验证、数据库、Stripe支付），帮助用户节省从零开始搭建项目的成本和令牌消耗。这些套件涵盖主流技术栈，包括：
Next.js (Fullstack/Lite)
React Native (Expo)
React (Vite) 并普遍采用 Tailwind CSS、TypeScript 和 Shadcn UI，后端支持 Drizzle ORM、Supabase、Firebase 等服务。
浏览器扩展
CodeGuide提供Chrome扩展程序，允许用户直接从浏览器生成PRD、技术规格和文档，并与Web端的AI构建工具（如Lovable, v0等）快速同步上下文。
产品特色亮点
| 特色 | 描述 |
|---|---|
| 解决AI幻觉 | 核心价值在于通过生成详尽的项目知识库（PRD、技术规格、线框图等），为AI工具提供精准上下文，从根本上减少AI的“猜测”和错误输出。 |
| “规划先行”理念 | 贯彻 “80%规划，20%执行” 的工作流，强调充分的文档规划能大幅提升后续AI编码的效率和产出质量。 |
| 支持现有代码库 | 独有的“Repowiki”功能，可将已有的GitHub代码库分析并文档化，使AI工具能在理解现有架构的基础上进行开发。 |
| 生产就绪启动套件 | 提供多个开箱即用、为AI优化过的全栈项目模板，内置认证、数据库等通用模块，直接节省项目启动的令牌和时间成本。 |
| 多模型协同代理 | Software v2代理支持访问200+个LLM模型，并能通过模型路由机制，为不同任务智能选择最佳模型，实现多模型协同工作。 |
| 深度兼容生态 | 与所有主流AI编码工具兼容，包括Cursor、Claude Code、Windsurf、Lovable、v0、Replit、Bolt等，支持一键注入上下文。 |
使用方法
CodeGuide的使用流程设计为简单、流程化的步骤，从注册到下载文档只需几个步骤即可完成。
访问与启动：用户首先访问CodeGuide官网 。在网站首页，点击显眼的 “Get Started Today” 按钮，平台会引导用户进入项目创建流程。
描述项目想法：在项目创建界面，用户需要在输入框中用简单英语描述想要构建的项目，例如“I want a mobile app”（我想构建一个移动应用）。系统接受描述后，会进入下一步。
回答澄清问题：平台AI会基于用户的初始描述，提出数个具体的澄清问题，例如“How should the notification behave?”（通知应如何行为？）、“Should users get an onboarding?”（用户是否需要引导？）。用户需逐一回答这些问题，以细化需求。
选择AI工具与生成文档：回答完毕后，用户可以选择计划使用的AI编码工具（如Cursor、Claude Code）。随后，系统会自动生成完整的项目文档包。用户界面会展示生成进度，完成时提示文档已就绪。
审核与下载文档：用户可以在平台界面中审阅生成的所有文档，包括PRD、技术栈、线框图等。确认无误后，可通过提供的下载选项或复制功能，将整套文档保存至本地。
注入上下文并开始构建：根据平台指引，用户通过一条命令或将文档拖入指定区域的方式，将生成的文档作为上下文注入到所选的AI编码工具（如Cursor IDE）中。此后，AI工具将基于这份详细的“蓝图”开始编写代码。
适合人群
| 用户类型 | 应用场景 | 推荐功能 |
|---|---|---|
| 创业者/创始人 | 快速将商业想法转化为可演示的MVP（最小可行产品），在数小时内而非数周内验证市场。 | AI驱动文档生成、开源启动套件 |
| 独立开发者/个人开发者 | 单人完成全栈开发，希望AI工具写出更快、更准确、质量更高的代码，提升个人开发效率。 | 全部功能，尤其是现有代码库分析和自主编码代理 |
| 产品经理与设计师 | 快速验证产品想法，将设计稿或产品描述转化为结构化的开发需求文档和可交互原型。 | AI驱动文档生成（特别是线框图）、浏览器扩展 |
| 开发团队与机构 | 在不同客户项目中保持文档规范的一致性，确保团队所有成员基于同一份清晰蓝图协作，降低沟通成本。 | 团队协作功能、为现有代码库生成文档 |
| “氛围编码者”/学生 | 无需深厚编程背景，通过自然语言描述构建出完整可用的项目，学习全栈开发流程。 | AI驱动文档生成、开源启动套件、浏览器扩展 |
收费价格
竞品对比
| 产品 | 核心定位 | 主要功能 | 与CodeGuide核心差异 |
|---|---|---|---|
| CodeGeeX | 多语言代码生成与辅助工具。 | 代码生成与补全、代码解释、生成单元测试、代码审查、不同编程语言互译。 | CodeGeeX侧重于代码层面的实时辅助；而CodeGuide专注于项目前期的规划与上下文生成，为后续的AI编码提供完整蓝图，两者处于开发流程的不同阶段。 |
| Codeium | 免费的AI代码补全和对话工具。 | 代码自动补全、自然语言搜索、AI对话。 | Codeium是集成在IDE中的编码助手，解决写代码时的即时问题；CodeGuide是独立的前期规划平台，解决“让AI知道要写什么代码”的问题，两者功能互补而非直接竞争。 |
| Amazon CodeWhisperer | 与AWS服务深度集成的代码建议工具。 | 代码建议、安全扫描。 | CodeWhisperer强于生成AWS云服务相关代码和安全性；CodeGuide是云服务商中立的项目规划工具，提供从产品需求到技术架构的全套文档，不绑定特定云生态。 |
常见问题解答（FAQ）
1. CodeGuide与直接使用ChatGPT或Cursor聊天规划项目有何区别？
直接使用ChatGPT或Cursor进行项目规划，得到的是通用性建议，缺乏AI编码工具所需的具体、结构化细节，容易导致后续编码出现“幻觉”。CodeGuide是专门为AI编码工具训练的平台，其生成的文档结构、细节深度和针对性，能确保AI工具生成符合预期的、生产就绪的代码。
2. CodeGuide适用于全新的项目，还是也可以用于已有项目？
两者都适用。对于全新项目，用户描述想法即可生成完整蓝图。对于已有项目，用户可以导入现有GitHub代码库，CodeGuide会分析并生成文档，使AI工具在添加新功能时能理解现有架构。
3. CodeGuide与哪些AI编码工具兼容？
CodeGuide与所有主流的AI编码工具兼容。这包括IDE/CLI工具如Cursor、Claude Code、Windsurf，以及Web构建器如Lovable、v0、Replit、Bolt等。平台支持通过命令或浏览器扩展一键注入上下文。
4. 使用CodeGuide结合AI工具，具体能构建什么类型的项目？
只要能够明确规划，就可以构建。典型项目类型包括：Web应用程序（如SaaS、仪表盘）、移动应用（iOS和Android）、浏览器扩展、后端API和数据库、自动化脚本以及各种插件和集成。
5. CodeGuide是否有免费试用方案？
有。CodeGuide提供免费计划，用户无需提供信用卡即可注册，并获得一次性120积分来完成1个项目，体验全部核心文档生成功能。
6. 如何开始使用CodeGuide？
操作流程如下：
1. 访问
app.codeguide.dev；2. 用简单英语描述你的项目；
3. 审核平台生成的编码规格文档；
4. 将文档连接到你选择的AI工具（如Cursor）；
5. 开始基于详细规划进行构建。
总结
CodeGuide的核心优势在于它精准地定位并解决了AI辅助开发中的一个关键痛点：上下文缺失导致的AI幻觉。通过将“80%规划，20%执行”的理念产品化，它成功地将项目前期耗时而关键的规划工作自动化、结构化，产出为AI编码工具可直接理解的“项目知识库”。这不仅显著提升了AI生成代码的准确性和相关性，减少了无意义的调试时间，更通过开源启动套件和现有代码库分析等功能，覆盖了从零启动到迭代开发的全场景。对于任何希望借助AI工具高效、可靠地构建软件的开发者、团队或创业者而言，CodeGuide扮演着不可或缺的“规划中枢”和“上下文桥梁”角色。
