企业官网建设流程全解析

Claude Subconscious self-hosted实战：LETTA_BASE_URL连接自托管Letta完整指南

【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious

Claude Subconscious（Claude 潜意识）是运行在 Claude Code 底层的后台智能体插件，基于 Letta Code SDK 构建：它在后台默默观察你的编码会话、阅读你的代码库、跨会话积累记忆，然后在每次提问前"低语"回有用的上下文提醒。本文是一篇完整的 self-hosted 实战指南，教你只用一个环境变量LETTA_BASE_URL，就能把 Claude Subconscious 连接到自托管 Letta 服务器，3 步完成配置，无需修改任何代码。

🧠 项目速览：Claude 的"潜意识"是什么？

Claude Code 在会话之间会"失忆"。Claude Subconscious 解决的就是这个问题——它在 Claude Code 下方运行一个独立的后台智能体：

• 观察：监听每一个 Claude Code 会话的完整对话记录
• 阅读代码：处理记录时可以用 Read、Grep、Glob 探索你的代码库
• 记住：跨会话、跨项目、跨时间持续积累记忆（8 个记忆区块：用户偏好、项目上下文、待办事项等）
• 低语：在每次 Prompt 前把记忆和提醒悄悄注入 Claude 的上下文，从不阻塞你

中的架构图完整描述了这条数据流。

⚠️ 该项目是官方 Demo 应用，定位为实验性质；生产场景可关注同源的 Letta Code。

🎯 为什么要 self-hosted 自托管 Letta？

默认情况下，插件连接的是 Letta 云服务（https://api.letta.com）。但自托管有三大好处：

好消息是：从 v1.1.0 开始（见 CHANGELOG.md），LETTA_BASE_URL自托管支持已经内置，不需要任何代码改动。

🚀 最快 3 步：LETTA_BASE_URL 连接自托管 Letta

第 1 步：安装 Claude Subconscious 插件

在 Claude Code 中直接安装：

/plugin marketplace add letta-ai/claude-subconscious /plugin install claude-subconscious@claude-subconscious

或者从源码安装：

git clone https://gitcode.com/GitHub_Trending/cl/claude-subconscious cd claude-subconscious npm install

然后进入克隆目录执行/plugin enable .（加--global可全局启用）。

第 2 步：启动自托管 Letta 服务器

确保你的 Letta 服务已在本机 8283 端口运行（Docker 或官方部署方式均可），并配置好所选模型服务商的 API Key（如 OpenAI、Anthropic 等）。

第 3 步：设置环境变量

在 shell 配置文件中加入两行：

export LETTA_API_KEY="你的Letta服务密钥" export LETTA_BASE_URL="http://localhost:8283" # 指向你的自托管服务器

💡 建议再加一行export LETTA_HOME="$HOME"，把所有状态文件统一收敛到~/.letta/，避免散落在各个项目目录里。

完成！启动一个新的 Claude Code 会话，插件会自动导入内置的Subconscious 智能体（Subconscious.af），实现零配置接入。

🔍 插件是如何连接自托管服务器的？

理解这 3 个细节，出问题时你就不慌了（实现位于 scripts/letta_api_url.ts）：

1. 尾斜杠自动清理：你写http://localhost:8283/、http://localhost:8283///都会被规范化，不用纠结末尾有没有/
2. /v1自动补全：填http://localhost:8283或http://localhost:8283/v1都可以，插件会自动拼成正确的 API 前缀
3. Server:横幅是最快验证手段：只要设置了LETTA_BASE_URL，会话启动横幅里就会多出一行Server: http://localhost:8283（见 scripts/session_start.ts）——看到这行，就说明自托管连接已生效 ✅

另外注意：自托管模式下，插件不会打印 Letta Cloud 的对话网页链接（scripts/session_start.ts 中通过是否设置LETTA_BASE_URL判断托管模式），这是正常行为，不代表连接失败。

⚙️ 自托管场景的完整配置清单

🤖 模型自动探测：自托管服务器的隐藏福利

插件启动时会自动查询你服务器的GET /v1/models/接口，检查当前模型是否可用；不可用则按内置优先级（letta/auto→ Claude Sonnet 4.5 → GPT-4.1-mini → …）自动选一个合适的模型。

唯一前提：你的自托管服务器必须配置好对应模型商的 API Key，否则自动探测也会落空。想手动指定时，设置LETTA_MODEL即可，格式为服务商/模型名。

🛠 常见问题排查（FAQ）

Q1：启动时连接失败 / 超时？先确认 Letta 服务在监听 8283 端口，再检查LETTA_API_KEY是否正确。URL 大小写、尾斜杠都不用担心（插件会自动规范化）。

Q2：智能体"沉默"，一直没有低语？默认whisper模式下，Subconscious 只在有有价值的内容时才说话，且需要几个会话积累信号后才会越来越聪明——给它一点时间。也可以先检查whisper模式是否被设为off。

Q3：如何查看调试日志？日志写在用户临时目录，一条命令看全部：

tail -f /tmp/letta-claude-sync-$(id -u)/*.log

Q4：Linux 上插件安装报EXDEV: cross-device link not permitted？这是/tmp跨文件系统的已知问题，设置export TMPDIR="$HOME/.claude/tmp"即可绕过（详见 README.md 的 Linux Workaround 一节）。

📁 项目文件导览

✅ 总结

把 Claude Subconscious 接上自托管 Letta 真的只需要一行LETTA_BASE_URL：

1. 安装插件（marketplace 一行命令或 clone 源码）
2. 启动本地 Letta 服务（默认 8283 端口）
3. 设置LETTA_API_KEY+LETTA_BASE_URL，启动新会话看到Server:横幅即成功

之后，一个跨会话记住你的"潜意识智能体"就开始在后台默默工作了 🧠。想深入了解它的记忆区块设计和多项目共享机制，继续读 README.md 即可。

【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious