快速开始
学习 Letta Code 的基础知识
完成本快速开始指南后，您将知道如何使用 Letta Code 代理完成实际任务，以及如何教导您的代理并帮助它随时间学习。
开始之前
要使用 Letta Code，您需要一台准备好以下内容的计算机：
步骤 1：安装 Letta Code
安装 Node.js 后，您的系统上应该有 npm 可用。在终端中运行以下命令来安装 Letta Code：
npm install -g @letta-ai/letta-code步骤 2：登录您的（免费）账户
首次使用 letta 启动 Letta Code 时，系统会提示您登录：
letta
# 您会看到一条消息说 "Let's get you authenticated"
# 按 "enter" 打开浏览器窗口按照说明登录现有的 Letta Platform 账户，或创建一个新账户。您的凭据会被存储，您只需要登录一次。如果需要稍后清除凭据，在 Letta Code 中运行 /logout。
如果您正在使用 Docker 部署自己的 Letta 服务器，请在运行 letta 之前在环境中设置 LETTA_BASE_URL，它将在启动时直接连接到服务器。
步骤 3：认识您的代理 🤖
首次启动时，Letta Code 会为您创建一个名为 "Memo" 的入门代理 - 一个具有空白状态的有状态代理。您使用 Memo 越多，它学到的就越多。
Memo 是您的！您可以使用 /pin 重命名 Memo，并通过告诉它编辑记忆来自定义其个性，或者在 ADE 中直接编辑（运行 /ade）。
尝试以下提示之一来感受代理的能力：
> /init运行 /init 让代理分析您的代码库并了解您的项目。
> What do you know about me so far?询问代理它对您的了解程度。
> Create a user profile on my by looking at my downloads folder让代理通过查看您的下载文件夹来创建用户画像。
> What active projects am I working on? Which one do you think you could help with?询问您正在进行的活跃项目，以及代理认为可以帮助哪个。
> Re-tool your memory to be just like the AI from the movie Her, operate as my AI OS companion让代理重新配置记忆，像电影《Her》中的 AI 一样运作。
> /remember that I always use bun in my node projects, never npm教导代理记住您的偏好。
如果您是现有的 Letta 用户，也可以运行 /agents 来切换到您现有的代理之一。
步骤 4：升级代理的大脑（LLM）
Letta Code 是开源且免费使用的。为了充分利用 Letta Code，我们建议通过 Letta API 使用前沿模型，如 Claude Sonnet/Opus 4.5 或 GPT-5.2-Codex，或连接您自己的 LLM API 密钥：
- 自带密钥（BYOK）：Letta Code 支持通过 Anthropic、OpenAI 等进行标准 API 密钥认证，以及 zAI + ChatGPT (Codex) 编程计划。使用
/connect进行配置。 - Letta API：提供对所有主要模型提供商（Anthropic、OpenAI、Google Gemini、zAI、DeepSeek 等）的直接访问。注册 Letta Pro 或 Max Plan 以使用。
您可以随时使用 /model 切换代理的模型：
> /model步骤 5：教导和训练您的代理
您使用代理的次数越多，它就变得越有价值。为了充分利用您的 Letta Code 代理，鼓励它在相关时更新记忆并搜索过去的历史：
- 在相关时回忆过去的交互：您的代理可以完全访问所有先前的对话数据，可以通过工具、技能和子代理访问。如果您之前讨论过某些内容，您的代理可以找到它（例如，"我们之前肯定修复过一个类似的 bug，你还记得上次是什么解决方案吗？"）
- 使用
/remember纠正您的代理：当您的代理犯了一个不应该再犯的错误时，使用/remember命令来教导它（例如，/remember to never do that again）
每次运行 letta 时，Letta Code 会恢复与您上次使用的代理的默认对话（默认情况下是 Memo）。这让您可以准确从上次离开的地方继续。
多线程：如果您想运行并行对话（例如，一个重构您的 API，另一个编写测试），使用 letta --new 创建新对话。所有对话共享相同的代理记忆和可搜索的消息历史。使用 /resume 切换对话（默认对话始终固定在顶部）。
常用命令
使用 Letta Code 时，您可能经常使用以下常用命令：
| 命令 | 功能 | 示例 |
|---|---|---|
letta | 启动交互模式 | letta |
letta -p "query" | 在无头模式下运行查询 | letta -p "commit the changes and push" |
shift-tab | 在模式之间切换（允许编辑、计划、yolo） | 按 Shift+Tab |
/init | 初始化代理的记忆 | > /init |
/remember | 教导代理某些内容 | > /remember always use pnpm |
/memory | 查看和管理记忆块 | > /memory |
/model | 切换 LLM 模型 | > /model |
/search | 搜索过去的消息 | > /search auth bug |
/clear | 清除上下文窗口（消息缓冲区） | > /clear |
/new | 开始新对话 | > /new |
/pin | 固定代理以便快速访问 | > /pin |
/agents | 在代理之间切换 | > /agents |
/feedback | 报告问题或提供反馈 | > /feedback |
! | 进入 bash 模式直接运行 bash 命令 | ! git status |
exit 或 Ctrl+C | 退出 Letta Code | > exit |
下一步
阅读更多关于 Letta Code 丰富功能集的内容：
获取帮助
- 询问 Letta Code：Letta Code 能够浏览网页，包括这些文档！
- 加入我们的 Discord：获取帮助的最佳方式是加入我们的 Discord 服务器，与 Letta 团队的其他社区成员和开发者聊天。