gpt-engineer Windows 环境安装与使用完全指南从 API Key 配置到首个 AI 生成项目【免费下载链接】gpt-engineerCLI platform to experiment with codegen. Precursor to: https://lovable.dev项目地址: https://gitcode.com/gh_mirrors/gp/gpt-engineergpt-engineer 是一款通过自然语言描述需求、由 AI 自动编写并执行代码的 CLI 编程平台本文以其官方 Windows 指南WINDOWS_README.md由 docs/windows_readme_link.rst 通过.. include::指令嵌入 Sphinx 文档系统为核心系统讲解在 Windows 下安装稳定版/开发版、配置 OpenAI API Keycmd / PowerShell / 图形界面三种方式、创建并运行首个 AI 生成项目以及运行结果的组织方式。读完本文你将能在一台全新的 Windows 机器上从零跑通 gpt-engineer 的完整工作流并理解每一步背后的源码实现细节。前置说明这份 Windows 指南在文档体系中的位置在阅读具体步骤前先厘清这份指南的来龙去脉。Sphinx 文档通过 docs/windows_readme_link.rst 中仅两行的.. include:: ../WINDOWS_README.md指令将仓库根目录下的 WINDOWS_README.md 原文直接嵌入文档站点:parser: myst_parser.sphinx_指定使用 myst_parser 解析 Markdown因此你既可以在 docs/index.rst 的 USER GUIDES 目录树中阅读到它也可以直接查看仓库根目录的 Markdown 原文两者内容完全一致。这也意味着本文后续引用的所有安装与运行步骤均以仓库内实际文件为准。与跨平台通用指南 README.md 相比Windows 指南的全部差异集中在两点API Key 的环境变量设置语法Windows 使用set/$env:而非 Linux 的export以及项目目录的复制方式使用xcopy而非cp -r。其余安装、运行、结果目录结构在所有平台上一致。Windows 快速上手最短路径如果只是想立刻跑起来遵循标准 README.md 的流程仅在设置 API Key 这一步换成 Windows 语法即可二选一CMD命令提示符set OPENAI_API_KEY[your api key]PowerShell$env:OPENAI_API_KEY[your api key]注意这种方式设置的变量只对当前终端会话有效关闭窗口后失效如需长期生效见下文「环境变量持久化」小节。完整安装指南稳定版与开发版二选一稳定版Stable三种安装路径方式一命令行一键安装推荐需管理员权限以管理员身份打开命令提示符执行pip install gpt-engineer安装完成后CLI 工具 gpt-engineer同时注册了gpte、ge两个别名命令即可直接使用。从 pyproject.toml 的[tool.poetry.scripts]配置可以看到这三个命令都指向同一个入口gpt_engineer.applications.cli.main:appgpt-engineer gpt_engineer.applications.cli.main:app ge gpt_engineer.applications.cli.main:app gpte gpt_engineer.applications.cli.main:app方式二从 PyPI 网站手动下载安装打开浏览器访问 PyPI 上 gpt-engineer 的项目页面在 Download files 部分查看可用版本及下载链接选择目标版本下载对应的包文件通常是.tar.gz或.whl格式打开你的 Python 开发环境 / IDE找到包管理入口不同 IDE 位置不同例如 PyCharm 中为 File Settings Project:项目名 Python Interpreter在包管理界面点击 Add Package 或 Install Package 按钮在安装对话框中选择从文件/本地源安装浏览并选中刚下载的 gpt-engineer 包文件完成安装。方式三Docker / 浏览器运行可选不想在本机折腾 Python 环境的用户可参考 docker/README.md 使用 Docker 运行或直接在 GitHub Codespaces 中于浏览器内完成全部操作。这两条路径均被 README.md 列为官方支持的备选运行方式Windows 下同样适用。开发版Development从源码安装如果你想跟进最新代码或参与贡献按以下步骤克隆并安装git clone gitgithub.com:gpt-engineer-org/gpt-engineer.git cd gpt-engineer poetry install poetry shellpoetry install会根据 pyproject.toml 声明安装所有依赖poetry shell激活项目专属的虚拟环境之后的gpte等命令都在该环境内执行当前仓库pyproject.toml声明支持 Python 3.10 - 3.12这一版本要求同样适用于 Windows。安装过程中建议确认本机 Python 版本在受支持范围内Windows 下可通过python --version验证。配置 OpenAI API Key三种方式详解gpt-engineer 运行时必须能够读取OPENAI_API_KEY。官方指南提供了终端临时设置与图形界面持久化两种思路共三种做法。方式一终端临时设置cmdset OPENAI_API_KEY[your API key]方式二终端临时设置PowerShell$env:OPENAI_API_KEY[your API key]以上两种方式仅对当前窗口生效适合临时体验。方式三图形界面持久化系统环境变量在开始菜单搜索 Environment Variables环境变量点击 Edit the system environment variables编辑系统环境变量在 System Properties系统属性窗口点击 Environment Variables环境变量按钮在弹出的窗口中有 User variables用户变量和 System variables系统变量两个区域若只为当前用户设置在 User variables 下点击 New若要全局生效在 System variables 下点击 New在 Variable name 字段输入OPENAI_API_KEY在 Variable value 字段输入你的 API Key点击 OK 保存关闭所有已打开的命令提示符或应用程序窗口并重新打开使变更生效。配置完成后在任何新开的终端中都能直接使用%OPENAI_API_KEY%来引用该变量例如程序交互提示输入时。gpt-engineer 会在启动时通过load_env_if_needed()检查该环境变量见 gpt_engineer/applications/cli/main.py其逻辑是若OPENAI_API_KEY尚未设置则尝试从当前工作目录的.env文件加载最终将值赋给openai.api_key。这意味着除了环境变量你也可以参考 README.md 的做法复制.env.template为.env并填入 Key同样能通过环境检查。创建并运行你的第一个项目准备项目文件夹与 prompt新建一个空文件夹作为项目目录。如果希望基于仓库自带的示例可以在命令行执行xcopy /E projects\example projects\my-new-project或者更直观的方式按住 CTRL 键将projects\example文件夹拖拽复制一份然后重命名为你的项目名如my-new-project。仓库中的 projects/example/prompt 是现成的示例提示词内容是用 Python 写一个贪吃蛇MVC 组件拆分到独立文件支持键盘控制复制后可直接修改。在新文件夹中创建或编辑一个名为prompt的无扩展名文件写入你希望 AI 实现的需求描述例如We are writing snake in python. MVC components split in separate files. Keyboard control.运行生成命令gpt-engineer projects/my-new-project执行后gpt-engineer 会读取项目文件夹中的prompt文件若文件不存在则交互式询问需求调用 AI 生成代码、生成run.sh入口脚本并在你确认后自动执行该脚本——整个流程对应 gpt_engineer/applications/cli/main.py 中agent.init(prompt)的调用链底层由 gpt_engineer/core/default/steps.py 中的gen_code按preprompts系统提示生成文件字典、gen_entrypoint生成run.sh入口与execute_entrypoint在 DiskExecutionEnv 中以bash run.sh方式执行并实时打印输出协作完成。常用选项gpt-engineer --help可查看全部其中与 Windows 场景尤其相关的几个参数说明--steps use_feedback官方指南特别点名的用法可在已有项目上改进/修复代码-i/--improve改进现有项目与--steps use_feedback等价的新式入口进入交互式文件选择与改进流程-l/--lite精简模式仅用主 prompt 完成一次生成-c/--clarify澄清模式先与 AI 讨论需求再实现-sh/--self-heal自愈模式代码执行失败时让 AI 自行修复-m/--model指定模型 ID默认gpt-4o源码中读取MODEL_NAME环境变量兜底-t/--temperature随机性控制默认 0.1-a/--azureAzure OpenAI 服务端点模型参数此时为部署名-s/--skip-file-selection改进模式下跳过交互式文件选择直接使用生成的 TOML 文件--no_execution仅运行设置流程、不调用 LLM 也不写代码测试用途改进现有项目的完整示例gpte projects/my-old-project -i命令会在交互中让你选择要修改的文件生成 diff 供确认后才落盘。运行 gpt-engineer 即表示你同意项目的服务条款见 TERMS_OF_USE.md。运行结果在哪里生成与执行结束后打开projects/my-new-project/workspace目录即可看到全部产出文件包括AI 生成的源码文件按 prompt 要求拆分的各模块入口脚本run.sh由gen_entrypoint生成负责安装依赖并运行代码交互中确认执行时的标准输出/错误输出通过 gpt_engineer/core/default/disk_execution_env.py 的run()实时回显。此外项目目录下还会生成隐藏的.gpteng/memory目录用于存放运行日志见 gpt_engineer/core/default/paths.py 中MEMORY_REL_PATH .gpteng/memory包括all_output.txt代码生成完整对话、debug_log_file.txt调试日志、improve.txt改进模式记录等最终生成的文件会通过 gpt_engineer/core/default/file_store.py 的push()写入workspace并自动git提交未提交的改动stage_uncommitted_to_git。常见问题与排错建议API Key 未生效确认变量是在新的终端窗口设置/读取的用echo %OPENAI_API_KEY%cmd或echo $env:OPENAI_API_KEYPowerShell验证或检查项目目录下是否存在.env文件。gpt-engineer不是内部或外部命令pip install是否以管理员身份执行、Python 的 Scripts 目录是否加入 PATH、是否在 Poetry 虚拟环境中执行。代码执行被中断运行run.sh期间可按ctrlc一次停止执行disk_execution_env.py 会捕获KeyboardInterrupt并优雅终止子进程。改进模式无变化若 diff 校验未通过控制台会提示将debug_log_file.txt位于.gpteng/memory/logs上传至 GitHub issue 协助排查。结语Windows 上的 gpt-engineer 使用流程与 Linux/macOS 完全一致核心差异仅在环境变量语法与目录复制命令。掌握本文的安装、API Key 配置与项目运行三步走之后即可在 Windows 上以自然语言驱动 AI 完成从描述需求到生成并执行代码的完整闭环后续可进一步探索 docs/open_models.md接入本地/开源模型、docs/tracing_debugging.md调试与追踪以及 docs/quickstart.rst 等官方文档逐步深入 gpt-engineer 的更多能力。【免费下载链接】gpt-engineerCLI platform to experiment with codegen. Precursor to: https://lovable.dev项目地址: https://gitcode.com/gh_mirrors/gp/gpt-engineer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考