DeepCode 快速上手指南10分钟跑通 AI 编程智能体从需求到可运行代码【免费下载链接】DeepCodeDeepCode: Open Agentic Coding (Agent Harness Loop Engineering Multi-Agent Orchestration)项目地址: https://gitcode.com/GitHub_Trending/deepc/DeepCodeDeepCode 是开源的 AI 编程智能体把需求直接变成经过测试验证、可运行的代码。它不依赖单一模型支持接入自己的 API KeyTUI、Desktop、Web 三个界面共享同一个本地服务历史记录与模型设置互通。适合想体验本地代码生成的新手开发者读完本文你能装好 DeepCode、接上模型并完成第一个写代码加测试的任务。① DeepCode 一分钟看懂DeepCode 是一款面向真实软件工程任务的开源智能体编程工具生成代码不难难的是理解项目、在边界内改代码、用运行结果纠偏并在中断或切换模型后继续干活。它的工作方式是你给出 Goal它在 Agent Harness 里结合项目上下文执行经过验证循环跑测试、看诊断、检查文件变更产出可审查的证据验证失败不算结束而是下一轮修复的输入。核心能力仓库级操作直接读写代码、执行命令和测试工具调用与文件变更全程可见目标驱动循环长任务持续推进理解—实现—验证—修复运行中可随时补充要求、修改目标或叫停证据驱动交付以测试结果、构建输出、Diff 和 Artifact 作为完成依据失败会被如实记录而不是报成功持久会话对话、工具记录、权限决定都保存在本地CLI、Desktop、Web 可接续同一任务② 三分钟跑起来环境要求组件最低要求推荐值Python3.123.12 或更新uvPython 包管理器已安装最新稳定版Node.js仅源码安装需要2222 LTS磁盘几百 MB安装体积预留 2 GB网络可访问模型 API稳定的云端 API 连接最简安装用 uv 安装发布版只需两步Windows 可先winget install --id astral-sh.uv --exact安装 uvuv tool install --python 3.12 deepcode-hku deepcode init装完如果终端提示找不到deepcode运行uv tool update-shell后重开终端。想用源码版本克隆https://gitcode.com/GitHub_Trending/deepc/DeepCode进入目录再执行npm --prefix desktop ci、npm --prefix desktop run build:web和uv tool install --python 3.12 --force .。核心配置改什么配置几乎全部由命令生成只有手动加本地模型时才需要直接编辑文件配置文件作用需要改什么~/.deepcode/deepcode_config.json模型连接与用户级设置加 provider 的apiBase、protocol、manualModelsdeepcode provider set命令终端添加模型连接连接名、--template和--api-keydeepcode provider set my-openrouter --template openrouter --api-key deepcode provider models my-openrouter --refresh第一条命令会提示输入 API Key输入时不回显第二条拉出该连接的模型列表把后面命令里的MODEL_ID换成列表中的完整 ID。③ 两个最值钱的用法用法一终端里完成第一个编程任务在你要操作的项目目录或新建的空目录运行deepcode --trust --connection my-openrouter --model MODEL_ID--trust表示信任这个文件夹每个项目只需一次粘贴任务描述建议写清行为要求和验收方式例如创建一个 greet(name) 函数去掉首尾空白后返回 Hello, !空名字抛 ValueError用标准库 unittest 写测试覆盖三种情况最后运行python -m unittest discover -v并总结结果观察工具卡片显示它读了哪些文件、跑了哪些命令弹出审批时按y允许一次、a本次会话允许该工具、n拒绝核对它生成的两个文件检查测试输出中途要打断就按Esc也可以直接补发消息修正要求同一会话内用/model可切换模型/resume恢复之前保存的对话/help查看全部命令。这个完整练习见 docs/guide/getting-started.md。用法二把论文变成可运行代码Paper2Code 是 DeepCode 的差异化场景从论文、技术文档、URL 或参考仓库出发经过文档理解、代码规划、参考检索、生成到迭代验证产出带测试和文档的可复现代码。在 Desktop 或 Web 里打开 Paper2Code 工作流源码入口见 workflows/code_implementation_workflow.py放入论文 PDF 或参考仓库用自然语言描述复现目标例如实现论文中的核心算法并给出可运行示例中央编排 Agent 会按任务状态调度理解、规划、生成、验证等阶段中途出现检查点与计划评审时你随时可以介入验收看证据它交付的是代码加测试加 Artifact而不是只有一份看起来正确的实现原始研究在 PaperBench复现 20 篇 ICML 2024 论文上的对比结果架构与评测细节见 docs/P5_PAPER2CODE_ARCHITECTURE.md。④ 卡住时查这里现象可能原因处理办法终端提示找不到deepcodeuv 工具目录未进 PATH运行uv tool update-shell重开终端后用deepcode --version验证打开项目时反复要求信任该目录未记录信任状态用deepcode --workspace /path/to/your-project --trust启动Desktop/Web 在项目页点信任控件模型报错或答非所问Key、模型 ID 或端点配置有误deepcode provider test CONNECTION_ID --model MODEL_ID验证工具调用失败时加--agent复测Web 页面连不上、提示 Browser access required链接过期或本地服务未运行deepcode service status看是否ready再重跑deepcode web60 秒内打开新链接工作中途断线网络波动或服务重启TUI 输入/reconnect恢复后先看会话最新消息和待审批项别重复发原任务更多场景Desktop 打不开、升级后仍用旧版本、数据恢复见 docs/guide/troubleshooting.md。⑤ 跑通之后接入本地模型在 docs/guide/models.md 里看 vLLM、Ollama 等本地服务的完整配置示例--api-base指向本地端点即可不必再付 API 费用写可复用的 Skill把团队的代码规范和审查流程沉淀成技能放在.agents/skills项目级或~/.agents/skills个人级写法见 docs/guide/skills-and-memory.md跑无人值守任务deepcode exec和 loop 命令支持 headless 执行与定时 Automation适合回归扫描、测试修复等重复工程详见 docs/HEADLESS_AND_AUTOMATION.md多智能体并行改代码用 worktree 隔离并行 Agent 避免文件冲突机制实现见 core/team/worktree.pyDeepCode 的价值是把写代码、跑测试、验证结果整条链路交给智能体持续完成你负责审查证据。下一步按 docs/guide/getting-started.md 把第一个任务完整跑一遍。【免费下载链接】DeepCodeDeepCode: Open Agentic Coding (Agent Harness Loop Engineering Multi-Agent Orchestration)项目地址: https://gitcode.com/GitHub_Trending/deepc/DeepCode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考