装完跑 agent 无响应（需 init + provider 配置）

你会遇到什么

deepcode 启动后交互无响应，或 agent 任务报错；deepcode loop/goal 不工作。装好了却跑不动——因为你还没初始化、没配 LLM。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

首次使用需要两步配置：

没配 LLM 时 agent 链路空转，交互自然无响应。

首次使用的“无响应”是链路断在配置层：DeepCode 的 agent 链路是“用户输入 → agent 规划 → 调用 LLM → 输出”，LLM 是链路里必需的执行者。

deepcode init 只生成配置目录（骨架），deepcode provider 才写入“LLM 连接与 key”（动力源）——两步配置分别对应“骨架”和“动力”，缺了第二步，链路每一步都走到“调用 LLM”就空转，交互自然无响应。

这也定义了验证顺序：先确认骨架在（~/.deepcode 目录存在）→ 再确认动力在（provider 配置含有效的 key）→ 最后发一条真实请求验证链路通。还有一个容易踩的点：key 是外部凭据，配置时写错、过期、或账号无额度，表现同样是“无响应/报错”——所以验证链路时先确认 key 本身有效（用 provider 自己的测试命令或最小请求），再怀疑工具。

一步步来

1. 初始化 — 必做

deepcode init

生成 ~/.deepcode。

2. 配置 provider — 必做

deepcode provider

配置 LLM 连接与模型。

3. 无 key 快速验证 — 必做

deepcode exec '简单任务'

看报错定位；或 deepcode --help 确认命令面。

怎么确认修好了

命令面正常（实测输出形态）：

deepcode --version → DeepCode 2.1.0
deepcode --help → 命令面完整

配置 provider 后任务能跑通（需 LLM key，本市场未实测）。

其它环境的表现

症状

deepcode 启动后交互无响应，或 agent 任务报错；deepcode loop/goal 不工作。

原因

首次使用需要初始化与 LLM 配置：deepcode init（生成 ~/.deepcode）+ deepcode provider 配置模型 key；没配 LLM 时 agent 链路空转。

解法

1. deepcode init 初始化。
2. deepcode provider 配置 LLM 连接与模型。
3. 想无 key 快速验证：deepcode exec '简单任务' 看报错定位；或 deepcode --help 确认命令面。

本市场实测安装 / 卸载（2026-08-28）

安装（manifest install.cmd，隔离 venv /tmp/l34-dc/venv，Python 3.14.4）：

[install] pip install -i https://pypi.tuna.tsinghua.edu.cn/simple deepcode-hku && deepcode --version
依赖：aiohttp/cryptography/pillow/mcp/mcp-server-git/openai/anthropic/google-genai 等 60+ 包
DeepCode 2.1.0
[install] exit=0

卸载（manifest uninstall.cmd + verify）：

[uninstall] pip uninstall -y deepcode-hku → Successfully uninstalled deepcode-hku-2.1.0
[uninstall] 验证: deepcode removed: OK（fresh shell，verify exit=0）

• 完整日志：实测记录（本地留存）。
• CLI 冒烟：实测记录（本地留存）（DeepCode 2.1.0；命令面完整）。
• 共装实测：实测记录（本地留存）（omc/agt）+ coexist-herdr/logfire（2026-08-28）。
• 未能实测：TUI 交互、MCP client 实跑、agent 任务（需 LLM key）。

冲突标注

• possible-compatible（实测 CLI 面）：oh-my-claudecode / agent-governance-toolkit（实测记录（本地留存））；herdr / logfire 共装实测。
• possible-compatible（推断态）：其余收录条目（矩阵对子）——deepcode 写面 = ~/.deepcode（可重定位 $DEEPCODE_HOME），无端口 daemon（MCP 按需）。
• 注意：配置目录 ~/.deepcode 为用户数据，卸载不自动删除。

名称混淆

• 三套名字：PyPI 包 deepcode-hku / CLI 命令 deepcode / 项目名 HKUDS/DeepCode——安装/卸载用包名，日常用命令名。
• 与 DeepSeek（模型）、DeepCode（其它同名代码分析工具）区分：本项目 = HKUDS/DeepCode 开源 Agentic 编码框架。

判据（验证状态）

• 症状清单：
• [x] git clone 连接被重置 → 清 Git 代理/换热点（CSDN 2026-06；走 PyPI 路径规避）
• [x] curl 证书报错 → --ssl-no-revoke + 虚拟环境（CSDN 2026-01；Windows 场景未实测）
• [x] Python>=3.10（3.8 下载不了 deepcode 包）（CSDN 2025-08；3.14.4 实测）
• [x] pip 超时 → 镜像源加速（CSDN 2026-04；清华镜像实测 40.3s）
• [x] Brave MCP WinError 2 / npx 未跑起来（CSDN 2026-01；命令面确认，实跑未测）
• [x] 装完 agent 无响应 → init + provider（manifest 配置面标注）
• 实测步骤：
• [x] 安装验证（manifest install.cmd：清华镜像 60+ 包 → DeepCode 2.1.0 exit 0）
• [x] 卸载验证（manifest uninstall.cmd：pip uninstall → verify 零残留 exit 0）
• [x] 网络/镜像场景（清华镜像 vs 官方 PyPI 对比；）
• [x] 未能实测项：TUI 交互、MCP client 实跑、agent 任务（需 LLM key）

验收

• [x] 症状 → 原因 → 解法 → 验证证据 四段齐全（6 症状）
• [x] 名称混淆已点名（包名 deepcode-hku vs 命令 deepcode；与 DeepSeek/其它 DeepCode 区分）
• [x] check-words HARD 0
• [x] validate 通过
• [x] 未碰 GitHub / 未用任何账号