gpt-engineer 完全指南：10 分钟从安装到跑通 AI 代码生成

【免费下载链接】gpt-engineerCLI platform to experiment with codegen. Precursor to: https://lovable.dev项目地址: https://gitcode.com/gh_mirrors/gp/gpt-engineer

还在手动敲重复的样板代码？gpt-engineer 让你用一句话描述需求，AI 就负责写代码、跑代码、改代码。这篇 gpt-engineer 快速上手教程带你从零开始：三条命令装好环境，三步看到 AI 代码生成真实跑起来。

3 条命令跑起来：gpt-engineer 安装与首次运行

这一节的目标只有一个：尽快见到 AI 写出第一个文件。

第 1 步：安装 + 配密钥

python -m pip install gpt-engineer export OPENAI_API_KEY=你的密钥

稳定版用 pip 装即可，注意 gpt-engineer 需要 Python 3.10 到 3.12。想跟源码一起折腾，走开发版：

git clone https://gitcode.com/gh_mirrors/gp/gpt-engineer cd gpt-engineer && poetry install

密钥不想写环境变量的话，把仓库里的.env.template复制成.env，再往里填OPENAI_API_KEY，gpte 会自动读取。

第 2 步：写 prompt 文件

新建一个空文件夹，里面放一个叫prompt的文件（注意没有扩展名），写上你的需求。一两句也行，越具体越好。

第 3 步：运行 gpte

mkdir my-first-ai-project && cd my-first-ai-project echo "创建一个Python脚本，能读取CSV文件并生成数据统计报告" > prompt gpte .

搞定！AI 会开始逐个写文件，写完还会自动执行入口脚本 run.sh，终端里直接看运行结果。✨

两个真实场景：改现有项目与看图生成

用 -i 改进现有代码

已有项目要改功能？improve 模式专门干这个。仓库里的 projects/example-improve/ 就是个现成样例：一个贪吃蛇游戏，prompt 要求把上下左右操作全部反过来。

gpte projects/my-old-project -i

流程是：在文件夹里放好 prompt 写清要改什么，运行命令后它会先问你允许 AI 动哪些文件，然后展示 diff，你确认 y 才真正应用。不满意就拒绝，代码一个字节都不会变。

给它一张 UX 图，生成对应前端

gpt-engineer 默认吃文本 prompt，但也接受图片输入。把设计稿放进一个文件夹，用--image_directory指过去，再配一个支持视觉的模型。仓库自带的 projects/example-vision/ 演示了这个玩法：

gpte projects/example-vision gpt-4-vision-preview \ --prompt_file prompt/text --image_directory prompt/images -i

AI 会"看懂"图里的导航布局，把样式改到贴近设计稿。视觉输入最实用的用法就是这个：图给它，代码它写。

4 个关键参数：让 AI 按你的规矩来

能跑起来只是开始，怎么让 AI 听话才是重点。这 4 个参数最值回票价。

• -c：clarify 模式，先和 AI 讨论清楚规格再动手，适合需求复杂的项目；注意它和-i不能同时用。
• --use-custom-preprompts：preprompts 是 AI 的"人格"和编码规范。加上这个参数，默认 preprompt 会从 gpt_engineer/preprompts/ 复制到你项目目录里供你修改，之后 AI 在每个项目都会记住你的偏好。
• --self-heal：入口脚本跑挂时，AI 自己诊断并修代码，不用你手动重跑。
• --use_cache：缓存 LLM 响应，同一个 prompt 反复调试时省 token。

gpte . -c gpte . --use-custom-preprompts gpte . --self-heal

顺手再记两个：--model指定模型（默认 gpt-4o），-t调 temperature（默认 0.1，越低越稳）。想本地跑开源模型省成本？配置方式见 docs/open_models.md。

避坑：三种报错一次看懂

现象：启动就提示缺少OPENAI_API_KEY或鉴权失败。原因：密钥根本没设上。解法：先export OPENAI_API_KEY=...，或把.env.template复制为.env填好再运行。

现象：安装报错，提示 Python 版本不满足>=3.10,<3.13。原因：你本机还是 3.8 或 3.9。解法：换到 3.10-3.12；实在要旧版本，最高只能用 0.2.6。

现象：gpte . -i -c直接报 "Clarify and lite mode are not compatible with improve mode"。原因：clarify（-c）和 lite（-l）只服务于全新生成，不参与改进。解法：去掉-c，单用-i跑改进模式。

现在就动手

gpt-engineer 把"写需求 → 得到可运行代码"变成日常操作，核心实现都在 gpt_engineer/core/default/，等你用熟了再往下挖。

所以——建个空文件夹，写下你的第一条需求，敲下gpte .。让 AI 去扛样板代码，把精力留给真正难的部分吧。🚀

【免费下载链接】gpt-engineerCLI platform to experiment with codegen. Precursor to: https://lovable.dev项目地址: https://gitcode.com/gh_mirrors/gp/gpt-engineer