常见问题
Agent 看不到 SuperDev 工具
Section titled “Agent 看不到 SuperDev 工具”重新加载 AI 工具，确认该 Agent 的 MCP 配置路径，并确认桌面端正在运行。
Codex hook 不生效
Section titled “Codex hook 不生效”Codex 的非托管 command hook 需要 /hooks 信任。在 CLI 里审核并信任该 hook。
Agent 仍然自己用 shell 起服务
Section titled “Agent 仍然自己用 shell 起服务”把项目规则写进仓库，然后要求它从 list_services 开始。
配了凭据但 Agent 不登录
Section titled “配了凭据但 Agent 不登录”确认 debug_credential_hints 可见，然后要求 Agent 调用 get_debug_credentials，不要伪造 token。
浏览器目标为空
Section titled “浏览器目标为空”本地前端 deployment 必须配置 web 入口并启用 AI 浏览器调试。浏览器工具只覆盖本地 loopback 目标。
browser_evaluate 被拒
Section titled “browser_evaluate 被拒”browser_evaluate 默认关闭。优先使用 snapshot、console、network 和 screenshot 工具；只有确实需要时再开启 evaluate。
断点 attach 失败
Section titled “断点 attach 失败”先用 list_code_debug_targets。目标必须是本地受管语言运行时，并且已经运行。
远端 host_ids 写错
Section titled “远端 host_ids 写错”调用 list_hosts，使用非本机的 hosts[].id，不要写主机名或 IP。
pipeline deploy 失败
Section titled “pipeline deploy 失败”先看 validate_project_pipeline，再查 list_pipeline_runs、read_pipeline_run_logs、list_pipeline_artifacts。