Claude Subconscious LETTA_AGENT_ID设置指南如何绑定你自己的Letta智能体【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconsciousClaude Subconscious 是一款为 Claude Code 装上潜意识的开源插件一个 Letta 智能体在后台默默观察你的每次会话、读取代码、沉淀跨会话记忆并在你提问前耳语提示。本文以核心环境变量LETTA_AGENT_ID为切入点用 4 个步骤教你如何绑定你自己的 Letta 智能体从零配置到完全自定义一次讲清。一、Claude Subconscious 是什么Claude Code 的后台潜意识想象你在用 Claude Code 写代码而另一个影子智能体始终在你身后工作看实时读取每个 Claude Code 会话的记录transcript读用 Read、Grep、Glob 探索你的代码库记跨会话、跨项目、跨时间积累记忆说在每次提示前注入上下文、模式提醒和待办事项不挡路全程异步后台运行永不阻塞你的编码整个机制由四个 Hook 驱动见 hooks.json 的配置说明会话启动、提示提交、工具调用前、响应结束分别触发通知、记忆注入、中途更新和异步回传。二、为什么需要设置 LETTA_AGENT_ID插件首次启动时并不是无智能体它有一个三级解析顺序核心逻辑在 scripts/agent_config.ts优先级来源说明1️⃣ 最高环境变量LETTA_AGENT_ID你手动指定的智能体永远生效2️⃣本地配置~/.letta/claude-subconscious/config.json首次自动导入后保存的智能体 ID3️⃣ 兜底自动导入内置的默认智能体 Subconscious.af也就是说不设置任何东西也能用插件会自动导入一个默认 Subconscious 智能体。但如果你想用自己在 Letta 中精心调教过的智能体让多个项目各用各的大脑自由定制人设、记忆块memory blocks和工具权限那就需要设置LETTA_AGENT_ID。它是整个插件中优先级最高的绑定方式直接覆盖本地配置且不会触发任何默认导入。三、4 步绑定你自己的 Letta 智能体第 1 步准备 Letta API KeyLETTA_API_KEY是必需项登录 Letta 官方控制台app.letta.com即可获取export LETTA_API_KEYyour-api-key第 2 步找到你的智能体 IDID 不是智能体的名字而是一段带agent-前缀的 UUID格式固定为agent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx在官方控制台选中你的智能体后从页面 URL 或智能体设置中复制即可。第 3 步设置 LETTA_AGENT_ID 环境变量export LETTA_AGENT_IDagent-a1b2c3d4-e5f6-7890-abcd-ef1234567890建议把这行写入~/.bashrc或~/.zshrc让每次打开终端都生效。第 4 步验证绑定是否生效启动一次 Claude Code 会话观察调试日志目录为$TMPDIR/letta-claude-sync-$UID/tail -f /tmp/letta-claude-sync-$(id -u)/*.log看到Using agent ID from LETTA_AGENT_ID: agent-...即绑定成功随后会话启动脚本 scripts/session_start.ts 会以这个 ID 向你的智能体发送新会话通知。四、常见错误与避坑清单 ⚠️插件在 scripts/agent_config.ts 中对 ID 做严格校验踩坑时日志会给出友好提示错误现象原因解决办法Invalid LETTA_AGENT_ID format把智能体名字如 Memo当成了 ID去控制台复制 UUID而不是显示名校验失败漏掉了agent-前缀前缀必须小写且不可省略插件仍用默认智能体只设置了LETTA_MODEL等变量忘了LETTA_AGENT_ID环境变量名拼写检查注意全大写绑定后行为不像默认 Sub正常现象自定义智能体沿用它自己的记忆架构不会套用内置的 8 个记忆块另外提醒通过环境变量绑定的智能体被视为外部智能体插件会跳过对它的标签tags改写避免干扰你在别处管理的记忆仓库——这对多工具共用一个智能体的用户非常友好。五、进阶为每个项目分配独立智能体 默认情况下智能体 ID 全局共享存在~/.letta/claude-subconscious/config.json一个大脑服务所有项目记忆跨项目共享。如果你想每个项目用不同的 Letta 智能体可以在项目目录下用 direnv 的.envrc覆盖# 项目根目录的 .envrc export LETTA_AGENT_IDagent-xxx-for-this-project这样不同仓库会各自连接各自的大脑互不串味而各项目下的.letta/claude/目录只做会话映射记录并非独立智能体。 顺带一提如果你希望从源码运行插件可克隆仓库git clone https://gitcode.com/GitHub_Trending/cl/claude-subconscious进入目录执行npm install后通过插件命令启用。六、FAQ 快速答疑Q1设置了 LETTA_AGENT_ID还需要导入默认智能体吗不需要。只要该环境变量存在插件直接跳过自动导入流程参见 scripts/agent_config.ts 中的快速检查。Q2LETTA_AGENT_ID 和 LETTA_MODEL 是同一回事吗不是。前者决定用哪个智能体后者覆盖智能体的模型如anthropic/claude-sonnet-4-5。若你指定的模型在服务器上不可用插件会按优先级自动挑选一个可用模型并给你警告。Q3绑定自定义智能体后记忆会被写入 CLAUDE.md 吗不会。任何模式下 Subconscious 都不写盘所有内容通过 stdout 注入提示上下文旧版本遗留的letta内容还会被自动清理。写在最后LETTA_AGENT_ID是 Claude Subconscious 中杠杆最大的一个变量三行命令就能把一个默默成长的后台智能体接进你的 Claude Code 工作流。先用默认 Subconscious 跑上几个会话再换成你自己的 Letta 智能体——它会读你的代码、记住你的偏好然后在你下一次提问之前悄悄把该说的话说好。【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Claude Subconscious LETTA_AGENT_ID设置指南：如何绑定你自己的Letta智能体
Claude Subconscious LETTA_AGENT_ID设置指南如何绑定你自己的Letta智能体【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconsciousClaude Subconscious 是一款为 Claude Code 装上潜意识的开源插件一个 Letta 智能体在后台默默观察你的每次会话、读取代码、沉淀跨会话记忆并在你提问前耳语提示。本文以核心环境变量LETTA_AGENT_ID为切入点用 4 个步骤教你如何绑定你自己的 Letta 智能体从零配置到完全自定义一次讲清。一、Claude Subconscious 是什么Claude Code 的后台潜意识想象你在用 Claude Code 写代码而另一个影子智能体始终在你身后工作看实时读取每个 Claude Code 会话的记录transcript读用 Read、Grep、Glob 探索你的代码库记跨会话、跨项目、跨时间积累记忆说在每次提示前注入上下文、模式提醒和待办事项不挡路全程异步后台运行永不阻塞你的编码整个机制由四个 Hook 驱动见 hooks.json 的配置说明会话启动、提示提交、工具调用前、响应结束分别触发通知、记忆注入、中途更新和异步回传。二、为什么需要设置 LETTA_AGENT_ID插件首次启动时并不是无智能体它有一个三级解析顺序核心逻辑在 scripts/agent_config.ts优先级来源说明1️⃣ 最高环境变量LETTA_AGENT_ID你手动指定的智能体永远生效2️⃣本地配置~/.letta/claude-subconscious/config.json首次自动导入后保存的智能体 ID3️⃣ 兜底自动导入内置的默认智能体 Subconscious.af也就是说不设置任何东西也能用插件会自动导入一个默认 Subconscious 智能体。但如果你想用自己在 Letta 中精心调教过的智能体让多个项目各用各的大脑自由定制人设、记忆块memory blocks和工具权限那就需要设置LETTA_AGENT_ID。它是整个插件中优先级最高的绑定方式直接覆盖本地配置且不会触发任何默认导入。三、4 步绑定你自己的 Letta 智能体第 1 步准备 Letta API KeyLETTA_API_KEY是必需项登录 Letta 官方控制台app.letta.com即可获取export LETTA_API_KEYyour-api-key第 2 步找到你的智能体 IDID 不是智能体的名字而是一段带agent-前缀的 UUID格式固定为agent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx在官方控制台选中你的智能体后从页面 URL 或智能体设置中复制即可。第 3 步设置 LETTA_AGENT_ID 环境变量export LETTA_AGENT_IDagent-a1b2c3d4-e5f6-7890-abcd-ef1234567890建议把这行写入~/.bashrc或~/.zshrc让每次打开终端都生效。第 4 步验证绑定是否生效启动一次 Claude Code 会话观察调试日志目录为$TMPDIR/letta-claude-sync-$UID/tail -f /tmp/letta-claude-sync-$(id -u)/*.log看到Using agent ID from LETTA_AGENT_ID: agent-...即绑定成功随后会话启动脚本 scripts/session_start.ts 会以这个 ID 向你的智能体发送新会话通知。四、常见错误与避坑清单 ⚠️插件在 scripts/agent_config.ts 中对 ID 做严格校验踩坑时日志会给出友好提示错误现象原因解决办法Invalid LETTA_AGENT_ID format把智能体名字如 Memo当成了 ID去控制台复制 UUID而不是显示名校验失败漏掉了agent-前缀前缀必须小写且不可省略插件仍用默认智能体只设置了LETTA_MODEL等变量忘了LETTA_AGENT_ID环境变量名拼写检查注意全大写绑定后行为不像默认 Sub正常现象自定义智能体沿用它自己的记忆架构不会套用内置的 8 个记忆块另外提醒通过环境变量绑定的智能体被视为外部智能体插件会跳过对它的标签tags改写避免干扰你在别处管理的记忆仓库——这对多工具共用一个智能体的用户非常友好。五、进阶为每个项目分配独立智能体 默认情况下智能体 ID 全局共享存在~/.letta/claude-subconscious/config.json一个大脑服务所有项目记忆跨项目共享。如果你想每个项目用不同的 Letta 智能体可以在项目目录下用 direnv 的.envrc覆盖# 项目根目录的 .envrc export LETTA_AGENT_IDagent-xxx-for-this-project这样不同仓库会各自连接各自的大脑互不串味而各项目下的.letta/claude/目录只做会话映射记录并非独立智能体。 顺带一提如果你希望从源码运行插件可克隆仓库git clone https://gitcode.com/GitHub_Trending/cl/claude-subconscious进入目录执行npm install后通过插件命令启用。六、FAQ 快速答疑Q1设置了 LETTA_AGENT_ID还需要导入默认智能体吗不需要。只要该环境变量存在插件直接跳过自动导入流程参见 scripts/agent_config.ts 中的快速检查。Q2LETTA_AGENT_ID 和 LETTA_MODEL 是同一回事吗不是。前者决定用哪个智能体后者覆盖智能体的模型如anthropic/claude-sonnet-4-5。若你指定的模型在服务器上不可用插件会按优先级自动挑选一个可用模型并给你警告。Q3绑定自定义智能体后记忆会被写入 CLAUDE.md 吗不会。任何模式下 Subconscious 都不写盘所有内容通过 stdout 注入提示上下文旧版本遗留的letta内容还会被自动清理。写在最后LETTA_AGENT_ID是 Claude Subconscious 中杠杆最大的一个变量三行命令就能把一个默默成长的后台智能体接进你的 Claude Code 工作流。先用默认 Subconscious 跑上几个会话再换成你自己的 Letta 智能体——它会读你的代码、记住你的偏好然后在你下一次提问之前悄悄把该说的话说好。【免费下载链接】claude-subconsciousGive Claude Code a subconscious项目地址: https://gitcode.com/GitHub_Trending/cl/claude-subconscious创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考