Claude Subconscious self-hosted实战LETTA_BASE_URL连接自托管Letta完整指南【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconsciousClaude SubconsciousClaude 潜意识是运行在 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。但自托管有三大好处优势说明数据不出内网会话记录、代码库内容全部保留在你自己的服务器上适合公司敏感项目零 API 成本不依赖 Letta Cloud 计费模型走你自己配置的 API Key⚡低延迟服务器跑在本机http://localhost:8283同步几乎无感好消息是从 v1.1.0 开始见 CHANGELOG.mdLETTA_BASE_URL自托管支持已经内置不需要任何代码改动。 最快 3 步LETTA_BASE_URL 连接自托管 Letta第 1 步安装 Claude Subconscious 插件在 Claude Code 中直接安装/plugin marketplace add letta-ai/claude-subconscious /plugin install claude-subconsciousclaude-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_URLhttp://localhost:8283 # 指向你的自托管服务器 建议再加一行export LETTA_HOME$HOME把所有状态文件统一收敛到~/.letta/避免散落在各个项目目录里。完成启动一个新的 Claude Code 会话插件会自动导入内置的Subconscious 智能体Subconscious.af实现零配置接入。 插件是如何连接自托管服务器的理解这 3 个细节出问题时你就不慌了实现位于 scripts/letta_api_url.ts尾斜杠自动清理你写http://localhost:8283/、http://localhost:8283///都会被规范化不用纠结末尾有没有//v1自动补全填http://localhost:8283或http://localhost:8283/v1都可以插件会自动拼成正确的 API 前缀Server:横幅是最快验证手段只要设置了LETTA_BASE_URL会话启动横幅里就会多出一行Server: http://localhost:8283见 scripts/session_start.ts——看到这行就说明自托管连接已生效 ✅另外注意自托管模式下插件不会打印 Letta Cloud 的对话网页链接scripts/session_start.ts 中通过是否设置LETTA_BASE_URL判断托管模式这是正常行为不代表连接失败。⚙️ 自托管场景的完整配置清单环境变量默认值自托管时的建议LETTA_API_KEY—必填你的自托管服务密钥LETTA_BASE_URLhttps://api.letta.com设为http://localhost:8283等自托管地址LETTA_MODEwhisper保持默认即可full会额外注入完整记忆区块LETTA_MODEL自动探测指定你服务器上可用的模型如anthropic/claude-sonnet-4-5LETTA_CONTEXT_WINDOW服务器默认大窗口模型如 1M tokens时显式设为1048576LETTA_HOME当前目录推荐$HOME状态统一收敛LETTA_SDK_TOOLSread-only默认只读安全full允许后台智能体执行任意工具 模型自动探测自托管服务器的隐藏福利插件启动时会自动查询你服务器的GET /v1/models/接口检查当前模型是否可用不可用则按内置优先级letta/auto→ Claude Sonnet 4.5 → GPT-4.1-mini → …自动选一个合适的模型。唯一前提你的自托管服务器必须配置好对应模型商的 API Key否则自动探测也会落空。想手动指定时设置LETTA_MODEL即可格式为服务商/模型名。 常见问题排查FAQQ1启动时连接失败 / 超时先确认 Letta 服务在监听 8283 端口再检查LETTA_API_KEY是否正确。URL 大小写、尾斜杠都不用担心插件会自动规范化。Q2智能体沉默一直没有低语默认whisper模式下Subconscious 只在有有价值的内容时才说话且需要几个会话积累信号后才会越来越聪明——给它一点时间。也可以先检查whisper模式是否被设为off。Q3如何查看调试日志日志写在用户临时目录一条命令看全部tail -f /tmp/letta-claude-sync-$(id -u)/*.logQ4Linux 上插件安装报EXDEV: cross-device link not permitted这是/tmp跨文件系统的已知问题设置export TMPDIR$HOME/.claude/tmp即可绕过详见 README.md 的 Linux Workaround 一节。 项目文件导览文件作用README.md完整文档安装、配置、Hooks、调试scripts/letta_api_url.ts自托管 URL 规范化与 API 地址构建核心逻辑约 40 行scripts/session_start.ts会话启动钩子连接服务器、显示Server:横幅scripts/sync_letta_memory.ts每次 Prompt 前把记忆注入 Claude 上下文scripts/send_worker_sdk.ts后台 Worker异步把会话记录发给 Letta 智能体hooks/hooks.json4 个 Claude Code Hooks 的注册配置Subconscious.af内置默认智能体定义含 8 个记忆区块package.json当前版本 2.1.1核心依赖letta-ai/letta-code-sdk✅ 总结把 Claude Subconscious 接上自托管 Letta 真的只需要一行LETTA_BASE_URL安装插件marketplace 一行命令或 clone 源码启动本地 Letta 服务默认 8283 端口设置LETTA_API_KEYLETTA_BASE_URL启动新会话看到Server:横幅即成功之后一个跨会话记住你的潜意识智能体就开始在后台默默工作了 。想深入了解它的记忆区块设计和多项目共享机制继续读 README.md 即可。【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Subconscious self-hosted实战：LETTA_BASE_URL连接自托管Letta完整指南
Claude Subconscious self-hosted实战LETTA_BASE_URL连接自托管Letta完整指南【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconsciousClaude SubconsciousClaude 潜意识是运行在 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。但自托管有三大好处优势说明数据不出内网会话记录、代码库内容全部保留在你自己的服务器上适合公司敏感项目零 API 成本不依赖 Letta Cloud 计费模型走你自己配置的 API Key⚡低延迟服务器跑在本机http://localhost:8283同步几乎无感好消息是从 v1.1.0 开始见 CHANGELOG.mdLETTA_BASE_URL自托管支持已经内置不需要任何代码改动。 最快 3 步LETTA_BASE_URL 连接自托管 Letta第 1 步安装 Claude Subconscious 插件在 Claude Code 中直接安装/plugin marketplace add letta-ai/claude-subconscious /plugin install claude-subconsciousclaude-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_URLhttp://localhost:8283 # 指向你的自托管服务器 建议再加一行export LETTA_HOME$HOME把所有状态文件统一收敛到~/.letta/避免散落在各个项目目录里。完成启动一个新的 Claude Code 会话插件会自动导入内置的Subconscious 智能体Subconscious.af实现零配置接入。 插件是如何连接自托管服务器的理解这 3 个细节出问题时你就不慌了实现位于 scripts/letta_api_url.ts尾斜杠自动清理你写http://localhost:8283/、http://localhost:8283///都会被规范化不用纠结末尾有没有//v1自动补全填http://localhost:8283或http://localhost:8283/v1都可以插件会自动拼成正确的 API 前缀Server:横幅是最快验证手段只要设置了LETTA_BASE_URL会话启动横幅里就会多出一行Server: http://localhost:8283见 scripts/session_start.ts——看到这行就说明自托管连接已生效 ✅另外注意自托管模式下插件不会打印 Letta Cloud 的对话网页链接scripts/session_start.ts 中通过是否设置LETTA_BASE_URL判断托管模式这是正常行为不代表连接失败。⚙️ 自托管场景的完整配置清单环境变量默认值自托管时的建议LETTA_API_KEY—必填你的自托管服务密钥LETTA_BASE_URLhttps://api.letta.com设为http://localhost:8283等自托管地址LETTA_MODEwhisper保持默认即可full会额外注入完整记忆区块LETTA_MODEL自动探测指定你服务器上可用的模型如anthropic/claude-sonnet-4-5LETTA_CONTEXT_WINDOW服务器默认大窗口模型如 1M tokens时显式设为1048576LETTA_HOME当前目录推荐$HOME状态统一收敛LETTA_SDK_TOOLSread-only默认只读安全full允许后台智能体执行任意工具 模型自动探测自托管服务器的隐藏福利插件启动时会自动查询你服务器的GET /v1/models/接口检查当前模型是否可用不可用则按内置优先级letta/auto→ Claude Sonnet 4.5 → GPT-4.1-mini → …自动选一个合适的模型。唯一前提你的自托管服务器必须配置好对应模型商的 API Key否则自动探测也会落空。想手动指定时设置LETTA_MODEL即可格式为服务商/模型名。 常见问题排查FAQQ1启动时连接失败 / 超时先确认 Letta 服务在监听 8283 端口再检查LETTA_API_KEY是否正确。URL 大小写、尾斜杠都不用担心插件会自动规范化。Q2智能体沉默一直没有低语默认whisper模式下Subconscious 只在有有价值的内容时才说话且需要几个会话积累信号后才会越来越聪明——给它一点时间。也可以先检查whisper模式是否被设为off。Q3如何查看调试日志日志写在用户临时目录一条命令看全部tail -f /tmp/letta-claude-sync-$(id -u)/*.logQ4Linux 上插件安装报EXDEV: cross-device link not permitted这是/tmp跨文件系统的已知问题设置export TMPDIR$HOME/.claude/tmp即可绕过详见 README.md 的 Linux Workaround 一节。 项目文件导览文件作用README.md完整文档安装、配置、Hooks、调试scripts/letta_api_url.ts自托管 URL 规范化与 API 地址构建核心逻辑约 40 行scripts/session_start.ts会话启动钩子连接服务器、显示Server:横幅scripts/sync_letta_memory.ts每次 Prompt 前把记忆注入 Claude 上下文scripts/send_worker_sdk.ts后台 Worker异步把会话记录发给 Letta 智能体hooks/hooks.json4 个 Claude Code Hooks 的注册配置Subconscious.af内置默认智能体定义含 8 个记忆区块package.json当前版本 2.1.1核心依赖letta-ai/letta-code-sdk✅ 总结把 Claude Subconscious 接上自托管 Letta 真的只需要一行LETTA_BASE_URL安装插件marketplace 一行命令或 clone 源码启动本地 Letta 服务默认 8283 端口设置LETTA_API_KEYLETTA_BASE_URL启动新会话看到Server:横幅即成功之后一个跨会话记住你的潜意识智能体就开始在后台默默工作了 。想深入了解它的记忆区块设计和多项目共享机制继续读 README.md 即可。【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考