配置

配置 Letta Code 设置和偏好

Letta Code 使用具有全局和项目级设置的分层配置系统。

认证

Letta API（默认）

首次运行时，Letta Code 会提示您通过 OAuth 认证：

  1. 运行 letta
  2. 按照浏览器提示在 app.letta.com 登录

API 密钥

或者，直接设置 API 密钥：

export LETTA_API_KEY=your-api-key

Docker

请参阅 Docker 设置 以将 Letta Code 与在 Docker 中运行的 Letta 服务器一起使用。

配置文件

全局设置 (~/.letta/settings.json)

适用于所有项目：

{
  "tokenStreaming": true,
  "globalSharedBlockIds": {
    "persona": "block-id-...",
    "human": "block-id-..."
  }
}

项目设置 (.letta/settings.local.json)

个人的、gitignore 的 - 您在此项目的代理：

{
  "lastAgent": "agent-id-..."
}

共享项目设置 (.letta/settings.json)

可以提交以与团队共享：

{
  "permissions": {
    "allow": ["Bash(pnpm lint)", "Bash(pnpm test)"]
  }
}

设置参考

设置 类型 描述
tokenStreamingboolean启用实时 token 流式传输
enableSleeptimeboolean启用睡眠时间代理进行被动记忆更新（默认：false）
lastAgentstring上次使用的代理的 ID（用于自动恢复）
globalSharedBlockIdsobject全局记忆块的 ID
permissions.allowstring[]自动允许的模式
permissions.denystring[]始终拒绝的模式

环境变量

变量 描述
LETTA_API_KEY用于认证的 API 密钥（OAuth 的替代方案）
LETTA_BACKFILL代理恢复时加载消息历史。设置为 0 或 false 以干净的聊天开始。默认：true
LETTA_ENABLE_LSP启用 LSP 诊断以进行类型错误检测。设置为 1 启用
DISABLE_AUTOUPDATER禁用自动更新。设置为 1 禁用

LSP 诊断

Letta Code 可以与语言服务器协议（LSP）服务器集成，以在读取文件时提供自动类型错误检测。

启用 LSP

export LETTA_ENABLE_LSP=1

支持的语言

语言 扩展名 LSP 服务器
TypeScript/JavaScript.ts, .tsx, .js, .jsx, .mjs, .cjstypescript-language-server
Python.py, .pyipyright

工作原理

当启用 LSP 并且您读取支持的文件时：

  1. Letta Code 启动适当的 LSP 服务器（如果缺失则自动安装）
  2. 文件被分析以查找类型错误、语法错误和其他诊断
  3. 任何错误都会附加到 <diagnostics> 块中的文件内容
This file has errors, please fix
<diagnostics>
ERROR [10:5] Cannot find name 'foo'
ERROR [15:3] Type 'string' is not assignable to type 'number'
</diagnostics>

行为

通过 Read 工具上的 include_types 参数进行手动控制：

  • include_types: false - 跳过诊断（即使对于小文件）
  • include_types: true - 强制包含诊断（即使对于大文件）

这有助于代理在进行编辑之前捕获类型错误，减少迭代周期。

更新

Letta Code 自动保持自身更新，以确保您拥有最新的功能和修复。

  • 应用更新：更新在您下次启动 Letta Code 时生效
  • 更新过程：在后台自动下载和安装
  • 更新检查：在启动时执行，并在运行时定期执行

禁用自动更新

export DISABLE_AUTOUPDATER=1

手动更新

letta update

推荐的 .gitignore

# Letta Code personal settings
.letta/settings.local.json

保持 .letta/settings.json 跟踪以与团队共享项目上下文。

下一步