> ## Documentation Index
> Fetch the complete documentation index at: https://platform.stepfun.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 环境变量

环境变量用于标记 Step Code 子进程、控制权限与多代理，以及在 CI 或容器中临时注入模型配置。设置后请从同一终端启动 Step Code。

## 进程标记

| 变量              | 说明                             |
| --------------- | ------------------------------ |
| `AI_AGENT=step` | 通用进程标记，让外部工具识别进程由 Step Code 启动 |

该标记会被子进程继承；SDK 嵌入时不自动设置。

## 运行时开关

| 变量                                            | 说明                                                     |
| --------------------------------------------- | ------------------------------------------------------ |
| `STEP_PERMISSION_PRESET`、`STEP_APPROVAL_MODE` | 覆盖权限模式，见[交互与输入](/docs/zh/step-code/guides/interaction#权限模式) |
| `STEP_DISABLE_WORKFLOW`                       | 设置为 `1` 关闭 workflow / ultraloop 注册                     |

## 遥测

在全局 `config.toml` 中关闭遥测：

```toml theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
[telemetry]
enabled = false
```

遥测包含设备与账号标识，不包含提示词、代码与路径。遥测与模型请求、主动提交的反馈是不同的数据通道；关闭遥测不会停止模型调用。

## 用环境变量注入模型

| 变量                        | 说明                                       |
| ------------------------- | ---------------------------------------- |
| `STEPCODE_CONFIG_PATH`    | 指向 JSON 模型配置，启动时注入模型目录，不写回 `models.json` |
| `STEP_API_KEY`            | `stepcode` 平台的默认密钥变量                     |
| `STEP_MAX_CONTEXT_TOKENS` | 注入模型的上下文窗口覆盖                             |
| `STEP_MAX_OUTPUT_TOKENS`  | 注入模型的最大输出覆盖                              |

适合 CI、容器等场景临时接入模型端点。注入模型按 wire 模型 ID 匹配内置目录时，会继承 adaptive thinking 等能力标记。

持久的自定义模型配置见[平台与模型](/docs/zh/step-code/configuration/models)。

## 供应商凭证

各供应商使用自己的 API Key 环境变量，例如 `ANTHROPIC_API_KEY`、`OPENAI_API_KEY`，完整常用列表见[平台与模型](/docs/zh/step-code/configuration/models#api-key-供应商)。

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
export STEP_API_KEY="YOUR_STEP_API_KEY"
```

`YOUR_STEP_API_KEY` 是密钥值占位符，替换为您的密钥。凭据优先级为 CLI `--api-key` > `auth.json` > 环境变量。不要将真实密钥提交到仓库。

静态托管插件 steppage 使用 `STEPFUN_API_KEY`，请保留工具要求的变量名。

## 代理

`HTTP_PROXY` / `HTTPS_PROXY` 配置出站代理，也可在全局 `config.toml` 设置 `httpProxy`。`NO_PROXY` 按主机名或后缀匹配绕过代理的目标。

```bash theme={"theme":{"light":"light-plus","dark":"dark-plus"}}
export HTTPS_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1"
step
```

将端口替换为实际代理端口。此例让回环请求不经过代理。

## 下一步

* [平台与模型](/docs/zh/step-code/configuration/models)：供应商凭证清单。
* [数据路径](/docs/zh/step-code/configuration/data-paths)：本地目录结构。
* [配置文件](/docs/zh/step-code/configuration/files)：对应配置键。