Letta Code

Letta Code 是一个以记忆为核心的编码工具，基于 Letta API 构建。与传统的独立会话不同，它使用持久化的智能体，能够随着时间不断学习，并且可以在多种模型之间无缝切换（如 Claude Sonnet/Opus、GPT/Codex、Gemini、GLM、Kimi 等）。

更多关于如何使用 Letta Code 的信息，请参阅官方文档页面。

快速开始

通过 npm 安装该包：

npm install -g @letta-ai/letta-code

导航到您的项目目录并运行 letta 命令（有关各种命令行选项，请参阅文档）。

运行 /connect 来配置您自己的 LLM API 密钥（OpenAI、Anthropic 等），并使用 /model 来切换模型。

[!NOTE] 默认情况下，Letta Code 会连接到 Letta API。您可以使用 /connect 来免费使用您自己的 LLM API 密钥和编码计划（如 Codex、zAI、Minimax）。设置 LETTA_BASE_URL 可以连接到外部的 Docker 服务器。

核心理念

Letta Code 围绕着长期存在的智能体构建，这些智能体在会话之间保持持久性，并随着使用不断改进。与传统的独立会话不同，每个会话都关联到一个持久化的智能体，该智能体能够持续学习。

Claude Code / Codex / Gemini CLI（基于会话）

• 每个会话是独立的
• 会话之间不会相互学习
• 上下文 = 当前会话中的消息 + AGENTS.md
• 关系：每次对话都像是在与一位新来的外包人员交流

Letta Code（基于智能体）

• 同一个智能体贯穿所有会话
• 持久的记忆和持续的学习
• /clear 会开启一个新的对话（即“线程”或“会话”），但记忆仍然保留
• 关系：就像拥有一位会学习并记住事情的同事或学徒

智能体记忆与学习

如果您是第一次使用 Letta Code，建议先运行 /init 命令来初始化智能体的记忆系统：

> /init

随着时间的推移，智能体会根据学习内容不断更新其记忆。为了主动引导智能体的记忆，您可以使用 /remember 命令：

> /remember [可选的提醒指令，说明要记住的内容]

Letta Code 支持技能（可重用模块，用于在 .skills 目录中教授智能体新能力），同时还支持技能学习。您可以通过以下命令让智能体从当前的工作轨迹中学习一项技能：

> /skill [可选的技能学习指令]

更多关于技能和技能学习的信息，请参阅文档：技能与技能学习。

对于 Arch Linux 用户，社区维护的软件包已在 AUR 上提供：

yay -S letta-code # 正式版
yay -S letta-code-git # 夜间版

---

由旧金山团队用心打造 💜

Letta Code 快速上手指南

Letta Code 是一款基于记忆优先（memory-first）理念的编程辅助工具。与传统会话式工具不同，它通过持久化代理（Agent）跨会话学习并积累上下文，支持 Claude、GPT、Gemini、Kimi 等多种模型。

环境准备

• 操作系统：支持 Windows、macOS、Linux（包括 Arch Linux）。
• 前置依赖：
  • 已安装 Node.js 和 npm。
  • 拥有主流大模型 API Key（如 OpenAI, Anthropic, Google 等），或准备使用 Letta 官方云服务。
• 网络提示：由于涉及海外 API 调用，建议确保网络环境通畅，或配置合适的代理。

安装步骤

方式一：通过 npm 全局安装（推荐）

在终端中运行以下命令安装最新稳定版：

npm install -g @letta-ai/letta-code

国内加速提示：如果 npm 下载缓慢，可临时切换至国内镜像源：

npm config set registry https://registry.npmmirror.com
npm install -g @letta-ai/letta-code

方式二：Arch Linux 用户

可通过 AUR 安装：

# 安装稳定版
yay -S letta-code

# 或安装夜间构建版
yay -S letta-code-git

基本使用

1. 启动与配置

进入你的项目目录，运行 letta 启动工具：

letta

首次使用时，需配置 LLM API Key 以连接模型：

• 输入 /connect：按照提示填入你的 API Key（支持 OpenAI, Anthropic 等）。
  • 注：默认连接 Letta 官方 API。使用 /connect 可改为使用自己的 Key 免费体验 Codex、zAI、Minimax 等模型。
• 输入 /model：切换当前使用的模型（如从 Claude Sonnet 切换到 GPT-4o）。

2. 初始化记忆系统

为了让 Agent 开始学习和记忆项目上下文，首次运行建议执行初始化命令：

/init

3. 开始编码对话

现在你可以像与同事对话一样下达指令。Letta Code 会记住之前的交互内容，无需重复背景信息。

• 日常对话：直接输入自然语言指令（例如：“帮我重构这个函数的错误处理逻辑”）。
• 强化记忆：如果希望 Agent 特别记住某些规范或偏好：

  /remember [在此处填写需要记住的具体指令或规范]
  

• 技能学习：让 Agent 从当前任务中学习新技能并保存为模块：

  /skill [在此处填写希望学习的技能描述]
  

• 开启新话题：若想开始新话题但保留过往记忆：

  /clear
  

4. 退出

输入 /exit 或直接关闭终端即可结束当前会话。下次在同一项目目录运行时，Agent 将自动加载之前的记忆继续工作。