需启用agent模式并按规范操作才能生成完整项目：升级至v2.3.0+、用[agent]前缀声明任务、逐阶段确认子任务、导出虚拟文件夹为物理目录、最后本地运行验证结构与功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在VS Code中启用CodeGeeX后尝试生成完整可运行项目，但仅获得零散代码片段而非结构化工程，则可能是Agent模式未正确激活或任务声明不满足多步推理触发条件。以下是完成端到端项目生成的实操路径：
一、验证并升级至支持Agent的CodeGeeX版本
Agent模式依赖v2.3.0及以上版本提供的任务分解引擎与工具调用能力，旧版本仅执行单次补全，无法维持状态化多步执行流程。
1、在VS Code中按Ctrl+Shift+X打开扩展市场，搜索“CodeGeeX”。
2、查看已安装插件的版本号，若显示低于2.3.0，点击“更新”按钮执行升级。
3、重启VS Code，在命令面板中输入CodeGeeX: Show Status，确认状态栏出现Agent mode supported提示。
二、使用标准前缀声明任务以激活Agent流程
CodeGeeX默认以Copilot模式响应自然语言请求，必须通过显式指令前缀强制切换为Agent模式，否则不会启动子任务拆解与中间步骤校验机制。
1、新建空白文件，保存为project_spec.md。
2、在首行严格输入：[AGENT] 创建一个基于React + Vite的待办事项应用，包含添加、删除、标记完成功能，使用localStorage持久化数据，输出完整项目结构。
3、将光标置于该行末尾，按下Ctrl+Enter（Windows/Linux）或Cmd+Enter（macOS）触发Agent流程。
三、逐阶段干预关键子任务输出
Agent会自动将项目生成拆解为需求分析、目录规划、核心组件编码、配置文件生成四个阶段，每步完成后暂停等待人工确认，防止技术栈误判或结构偏差。
1、当弹出“Step 1/4: Analyze requirements and outline project structure”窗口时，检查其输出是否明确识别Vite为构建工具、localStorage为存储方案。
CodeGeeX 2.21.0是智谱AI推出的AI编程助手版本，对Inline Chat功能进行了重大优化，包括UI设计升级、支持流式输出以提升响应速度，并新增“查看思路”按钮以便理解代码原理。同时，该版本在编辑器中新增CodeLens控件，支持一键“解释”代码或“添加注释”。目前该工具对个人开发者免费开放。
2、若发现误写为Create React App或IndexedDB，直接在弹窗内编辑修正为正确术语后按回车。
3、点击Proceed to next step按钮进入下一步，不可跳过或关闭弹窗。
四、导出为独立可运行项目目录
Agent完成全部步骤后，所有文件暂存于内存虚拟文件系统中，需主动导出为物理目录才能执行npm install与npm run dev。
1、在VS Code资源管理器中定位名为agent-output的虚拟文件夹。
2、右键点击该文件夹，选择Export as Project Folder…。
3、在弹出窗口中指定本地路径（如D:\projects\todo-vite-app），勾选Include package.json and README.md，点击确定。
五、本地运行与结构验证
导出后的目录应具备标准Vite项目结构，可立即执行初始化与启动命令，无需手动补全缺失文件或修改入口逻辑。
1、打开终端，进入导出目录，执行npm install安装依赖。
2、执行npm run dev启动开发服务器，确认浏览器成功加载页面且功能可交互。
3、检查src/App.jsx中是否包含useState管理待办列表、useEffect同步localStorage、以及对应事件处理器函数。
