gpt-engineer快速上手教程API Key配置与gpte命令一步不落全程实操【免费下载链接】gpt-engineerCLI platform to experiment with codegen. Precursor to: https://lovable.dev项目地址: https://gitcode.com/gh_mirrors/gp/gpt-engineergpt-engineer 是一个基于自然语言的 AI 代码生成工具你用大白话描述想要的软件它就能自动生成、运行代码还能继续让你向 AI 提出改进要求。本文带你从零完成gpt-engineer 安装、API Key 配置、gpte 命令实操三步全程手把手新手也能一次跑通 gpt-engineer 是什么能帮你做什么用官方的一句话概括gpt-engineer 让你可以 用自然语言描述软件需求 坐等 AI 写出代码并直接执行 继续指挥 AI 对已有代码做改进它由gpte命令行工具驱动核心入口源码在 gpt_engineer/applications/cli/main.py命令注册见 pyproject.toml 中的gpte gpt_engineer.applications.cli.main:app。第一步安装 gpt-engineer两种官方方式方式一pip 安装稳定版推荐新手python -m pip install gpt-engineer这是官方推荐的安装方式官方支持Python 3.10 - 3.12最后一个支持 3.8/3.9 的版本是 0.2.6。方式二从源码安装开发版git clone https://gitcode.com/gh_mirrors/gp/gpt-engineer cd gpt-engineer poetry install poetry shellpoetry shell会激活虚拟环境后续命令都在该环境中执行即可。 小提醒mac / Linux 上如果精简版 Python 缺少tkinter可分别用brew install python-tk或sudo apt-get install python3-tk解决详见 docs/installation.rst。第二步配置 API Key三种方式任选其一gpt-engineer 默认使用 OpenAI 模型默认gpt-4o运行前必须配置密钥。方式 A导出环境变量最常用export OPENAI_API_KEY你的API密钥建议把这行加进~/.bashrc这样每次打开终端都不用重复设置。方式 B使用 .env 文件最省心把仓库里的 .env.template 复制一份改名为.env在.env中填入你的OPENAI_API_KEY程序启动时会自动从当前工作目录读取该文件加载逻辑见 main.py 中的load_env_if_needed。方式 CWindows 用户专用Windows 下配置方式略有不同请查看官方指南 WINDOWS_README.md核心命令为$env:OPENAI_API_KEY你的API密钥 # PowerShell set OPENAI_API_KEY你的API密钥 # cmd想用本地模型 / Azuregpt-engineer 也支持 WizardCoder 等开源模型、Azure OpenAI 端点--azure参数相关文档在 docs/open_models.md。第三步运行 gpte 命令生成你的第一个项目这是新手最容易卡住的一步请严格按下面 4 个小步操作 ✅新建一个空文件夹作为你的项目目录例如projects/my-new-project在该文件夹内创建一个无扩展名的文件名字叫prompt写入你的需求描述例如做一个命令行待办清单应用在项目外运行gpte projects/my-new-project稍等片刻AI 会生成文件、自动执行入口代码并把结果写入项目的workspace目录⚠️ 两个常见坑prompt文件不能带 .txt 等扩展名gpte后面接的是相对路径或绝对路径路径写错会直接报错退出。如果prompt文件不存在gpte也会在终端里交互式地问你想生成什么应用两种方式都可行。进阶一用 -i 改进已有代码improve 模式想让 AI 修改现有项目只需加一个参数gpte projects/my-old-project -i改进模式下AI 会先让你交互式选择要改的文件生成 diff 后还会红绿色高亮展示改动确认y才真正落盘——这个确认机制让你对改动完全可控源码见 main.py 的improve_mode参数定义。进阶二Vision 模式——把 UX 设计图直接喂给 AI除了文本gpt-engineer 还支持图片输入把 UX 草图放进图片目录配合视觉模型AI 就能看图干活。上面的 UX 示意图就是仓库自带的示例项目 projects/example-vision/prompt 使用的输入其需求只有一句话让导航栏长得像这张 UX 图。命令示例gpte projects/example-vision gpt-4-vision-preview \ --prompt_file prompt/text --image_directory prompt/images -i常用 gpte 参数速查表参数缩写作用--model-m指定模型默认gpt-4o--improve-i改进已有项目--lite-l精简模式只用主提示词更快更省--clarify-c先与 AI 讨论需求规格再实现--self-heal-sh运行失败时让 AI 自动修复代码--use_cache缓存 LLM 响应重复运行省 token--verbose-v输出详细日志排查问题必备gpte --help-h查看全部选项常见问题速查提示找不到 OPENAI_API_KEY检查.env是否在运行gpte的那个目录或重新执行export。改进模式没改动任何文件终端会提示上传memory/logs里的debug_log_file.txt作为调试日志加-v参数可看更详细的运行过程。想看这次花了多少钱运行结束后终端会自动打印Total api cost费用统计逻辑见 core/token_usage.py。写在最后到这里你已经完整走通了gpt-engineer 安装 → API Key 配置 → gpte 生成项目 → 改进项目的全流程。更多细节可参考官方 README.md 与 docs/quickstart.rst。下一步建议你试一次--self-heal模式看 AI 如何自己修 bug用--use-custom-preprompts定制 AI 的身份让它跨项目记住你的偏好跑一个 benchmark 评测自己的 Agent 表现祝玩得开心让 AI 帮你多写点代码吧 【免费下载链接】gpt-engineerCLI platform to experiment with codegen. Precursor to: https://lovable.dev项目地址: https://gitcode.com/gh_mirrors/gp/gpt-engineer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
