---
title: "环境"
description: "会话启动时使用的命名环境变量配置，用 agent-manager env 保存，可按会话或分组选择。"
canonical: "https://agent-manager.dev/zh-cn/docs/environments/"
last-updated: "2026-11-01"
section: "Documentation"
language: "zh-CN"
source: "agent-manager"
---

# 环境

环境配置是一组命名的环境变量，会话在管理器自身环境之上用它们启动。你可以按会话或按分组选择一份。命令是 `agent-manager env`。

## 配置

`env list` 打印每个名称和它的键，不打印值。`env show` 打印 `KEY=VALUE`。`env set` 写入变量，配置不存在时会创建它。`env unset` 删除变量。`env rm` 删除配置。`list` 和 `show` 接受 `--json`。

```bash
agent-manager env list
agent-manager env show work
agent-manager env set work AWS_PROFILE=work
agent-manager env unset work AWS_PROFILE
agent-manager env rm work
```

名称是 1 到 60 个字符，不能有前导或尾随空格，也不能包含控制字符。键由字母、数字和 `_` 组成，并且不能以数字开头。以 `AGENT_MANAGER_` 开头的键，无论大小写，都会被拒绝，因为这些变量由管理器自己设置。值不能包含 NUL 字节。

使用某份配置的每个会话，下一次启动都会采用改动，包括恢复和重启。已经在运行的会话保持它启动时的环境。删除一份配置后，仍然点名它的会话会拒绝启动，直到它被重新设置。不存在的名称会被拒绝，消息会列出已有的配置，或告诉你用 `agent-manager env set` 创建一份。

设置里每一份配置只显示名称和键，从不显示值。至少有一份配置之前，`environments` 行是隐藏的。在该行上按 `enter` 不会编辑它。修改配置使用 `env` 命令，这样令牌不会出现在设置界面里。[导出](/zh-cn/docs/config/#export)不包含这些配置。

## 会话使用哪一份配置

未设置的会话继承最近祖先分组的配置。分组没有配置时，它继承创建它的那个会话的配置，所以助手会沿用那个账号。否则它以 none 启动。明确的选择优先，空的选择表示 none。

新建会话表单上的 `env` 行，在已有配置或分组已经指定一份时出现。不去动它时，这一行标成分组的配置。父分组指定了配置时，留在 none 的子分组继续继承它，表单会注明那是哪一份。拨动这一行会把一份配置记在子分组自己身上。新建分组表单和分组编辑卡片（`r`）在有可选配置时也有同一行。

在快速提示模式里，已有配置时，`ctrl+g` 切换新会话启动所用的配置。点击 env 标签效果相同。[快速提示](/zh-cn/docs/prompt/#keys)列出了这个键。

`agent-manager spawn --env` 为这一次启动指定配置。不写这个参数则继承。传入空字符串表示 none。`create_session` 在 `environment` 里接受同样的选择：省略则继承，传入空字符串表示 none。它不能和 `host` 一起使用，因为配置只适用于本机上的会话。SSH 连接上的会话不提供这一行，快速提示模式在那里也不提供 `ctrl+g`。