# 环境变量是什么，怎么使用？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/assistant_environment_variables/

## 先说结论

环境变量是保存在某个助手里的“名称 + 私密值”。它会随该助手持续保存；不同助手可以使用同一个变量名保存不同的值，彼此不会读取或覆盖。它适合保存 Skill 或 JavaScript 工具需要使用的 API Key、Token 等配置，避免把敏感值直接写进聊天消息、系统提示词、Skill 文件、日志或工具结果。

## 在哪里设置

打开 **助手 → 编辑助手 → 提示词 → 变量**，新建变量名、用途和值，例如 `SILICONFLOW_API_KEY`。列表可按名称或用途搜索，默认不展示值；点条目编辑，点 **插入** 将引用添加到助手指令。需要给其他助手复用时，可用复制功能创建独立副本。

环境变量 **单独保存、立即生效**，不会等待助手右上角保存；放弃助手指令草稿也不会撤销已保存的变量。变量尚未保存时会拦截助手保存，并提示先处理变量草稿。新助手需先保存，再配置环境变量。

## 怎么使用

- 调用外部接口时，通过网络请求的凭据代用指定当前助手变量，或在代码工作台申请服务商凭据；由应用在获准的 HTTPS 目标上添加鉴权，不把明文交给脚本。
- 助手提示词确实需要引用某个值时，可以写 `{{env.SILICONFLOW_API_KEY}}`。

## 会自动发送给模型吗

不会。仅仅保存环境变量，不会把变量名或值自动放进模型上下文。

但如果在提示词中使用 `{{env.变量名}}`，发送前会替换成真实值，**这会把该值发送给当前模型服务商**。密钥通常不应通过提示词传给模型；需要调用接口时，优先使用宿主凭据代用。process.env 默认为空，不要打印、写文件或返回敏感值。

## 备份与导出

环境变量会随所选助手进入完整备份、助手导出和碰一碰传送，分享用途也保留，不会自动去除密钥。文件含明文凭据，请仅保存到可信位置或交给可信接收方；不希望外传时取消选择该助手，反馈中不要附上这类导出包。凭据无法读取时，整次导出会停止。

## 环境变量和提示词变量的区别

- `{{current_date}}`、`{{current_clock}}` 等提示词变量由应用生成，用于日期与时间。
- 助手环境变量由用户保存，主要承载外部服务配置和敏感值。
- 代码工作台的 `process.env` 默认为空；外部接口鉴权使用宿主凭据代用。`{{env.KEY}}` 会把实际值插入提示词并发送给模型。