Skip to content

[Bug]: Docker 部署首次使用 Claude Code 失败,页面无错误提示(CLI 从 npm 安装超时) #892

Open

Description

@pkyes54

Component / host

Platform — deployment

Edition

Platform

LoopForge version

0.3.8(ghcr.io/tencent/loopforge:0.3.8,docker compose --profile platform)

What happened?

在 Docker 部署下,Claude Code 的凭据配置完成并保存后,在 AI 对话里选择 Claude 执行器发送消息,页面没有可见的错误说明,详细原因只出现在服务端日志:

assistant CLI resolve failed: 服务器未安装 Claude Code CLI(claude),请联系管理员安装后再使用 Claude Code 模型

实际行为:

  • 页面看不到失败原因,用户无法判断是密钥错误、模型错误还是环境问题。
  • 该提示只在 docker compose --profile platform logs platform 中可见。

期望行为:

  • 页面直接展示这条错误和可执行的下一步(例如「容器内 CLI 安装失败,请检查网络或 npm 源」),而不是只写进服务端日志。
  • 部署文档或界面提供国内网络可用的途径:支持配置 npm registry(如 npmmirror 镜像),或提供离线 / 预置安装方式。

补充:在容器内手动执行 npm install -g @anthropic-ai/claude-code(约 1 分钟)后即可正常使用,说明问题发生在「首次使用自动安装」这一步,而不是密钥或模型配置本身。

Reproduction

  1. docker compose --profile platform up -d(0.3.8 镜像)
  2. 设置 → 凭据,填写 Claude Code API Key 并保存
  3. AI 对话切换到 Claude 执行器,发送任意消息
  4. 页面无输出、无错误详情;docker compose --profile platform logs platform 出现 assistant CLI resolve failed: 服务器未安装 Claude Code CLI(claude)

Sanitized diagnostics

platform-1 | assistant CLI resolve failed: 服务器未安装 Claude Code CLI(claude),请联系管理员安装后再使用 Claude Code 模型
platform-1 | assistant title summary skipped session=chat-xxxx: 服务器未安装 Claude Code CLI(claude),请联系管理员安装后再使用 Claude Code 模型
platform-1 | [HTTP] POST /api/assistant/generations -> 202 (112 bytes)
platform-1 | [HTTP] GET /api/assistant/sessions/chat-xxxx/generation -> 200 (272 bytes)

已移除会话 ID 与全部密钥。

定位线索:镜像未预装 Claude Code(Dockerfile 仅预装 codex / codebuddy / dsh),首次使用时由 internal/runtime/claude_install.go 的 EnsureClaudeCode 执行 npm install --prefix ... @anthropic-ai/claude-code@2.1.300,未指定 registry,默认访问 registry.npmjs.org;国内服务器下该步骤超时失败,错误仅落日志。

Safety checks

  • I removed credentials, private endpoints, internal identifiers, and personal data.
  • I searched existing issues for duplicates.

Activity

  1. pkyes54 commented on Nov 15, 2026

    @pkyes54
    Author
    image

    如图所示,此外Pi 运行时有同样问题,怀疑所有运行时有同样问题,建议全部检查一遍

  2. pkyes54 commented on Nov 15, 2026

    @pkyes54
    Author

    补充一个更靠前的根因,供定位参考。

    AI 对话路径不会触发自动安装。 resolveAssistantEngineBin()(internal/httpapi/assistant_engine_cli.go)只检查 AGENTFLOW_CLAUDE_BIN、AGENTFLOW_MANAGED_CLI_ROOT、PATH,以及 ~/.local/bin、/usr/local/bin、/usr/bin 三处固定目录;找不到就直接返回「服务器未安装 Claude Code CLI(claude),请联系管理员安装后再使用 Claude Code 模型」,不会调用 EnsureClaudeCode。

    会触发 EnsureClaudeCode 的生产路径只有 onDemandCLIPath()(internal/runtime/sandbox_docker.go),仅在以下条件全部满足时生效:SOP / Docker 沙箱执行 Claude、provider 为 claude-code、argv[0] 为 claude、AGENTFLOW_RUNTIME_CLI_DIR 非空、隔离运行时镜像非空。

    另有 runAlternateAssistantCLI()(internal/httpapi/assistant_provider.go)会调用 runtime.ResolveClaudeCode 从而完成安装,但目前只被测试调用,生产代码未使用。

    结果:在 AI 对话里首次使用 Claude Code,既没有安装提示,也不会自动安装,只能看到「请联系管理员安装」。部署侧 ${LOOPFORGE_DATA_DIR}/cli 目录也不会被创建(实测 .data/ 下只有 home 与 workspaces)。

    另外,前端也没有任何「检测到未安装 → 提示安装」的界面,web/app/ 下未检索到相关文案或逻辑。因此当前并不存在「提示后自动安装」这条链路。

    建议:让 AI 对话路径复用 onDemandCLIPath() / ResolveClaudeCode 的安装能力,并在页面上以「未安装 → 安装中 → 失败原因」的形式暴露出来,而不是直接返回「请联系管理员安装」。

  3. cocofhu00 commented on Nov 16, 2026

    @cocofhu00
    Contributor

    感谢反馈!理解你的意思是:在 0.3.8 的 Docker 部署下,配置好 Claude Code 凭据后在 AI 对话里发消息会失败,页面不显示原因,只有服务端日志里有「服务器未安装 Claude Code CLI」;你在评论里也补充了 Pi 运行时有同样现象,并给出了 AI 对话路径与自动安装路径的分析。希望页面直接展示错误和下一步,并支持国内可用的 npm 源或离线安装方式。

    已经看到,会按现有 Issue 排期查看。版本、复现步骤和日志都很完整,谢谢。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions