Problem entry · machine-readable · 会话与记忆

worker/UI 端口占用:"Is port 37777 in use?"

本页嵌入 #trove-entity JSON(本条目全量结构化数据);全库数据见 /agent/trove.json。

元数据

idclaude-mem-2收录2026-08-29
问题域会话与记忆主题分组Agent 工具·运行与配置
适用工具claude-mem

症状

worker 启动失败,报端口被占用(Windows 重启后常见);记忆 UI 打不开。

原因

旧版/部分版本 worker 固定端口 37777,被残留进程或其它程序占用;僵尸 socket(TIME_WAIT)未释放。

解法

1. 先确认实际端口(安装输出 / `claude-mem status` 为准):`lsof -i :37700`(本版)或 `lsof -i :37777`(旧版资料)。

2. 清理占用:`kill -9 $(lsof -t -i:37700)`(按实际端口替换)。

3. 改端口:`CLAUDE_MEM_WORKER_PORT` 环境变量,或 `~/.claude-mem/settings.json` 中配置。

验证证据

- 上游 Issue #415/#380(2025-12,Windows 重启后端口占用场景)。

- 本市场实测:本版(插件 13.16.1)安装输出 `Worker port: 37700`——端口随版本变化,排查前先看实际输出,避免按旧资料找错端口。

来源与证据

素材来源:本站实测沉淀(2026-08-28)

验证证据:site docs#2