环境变量

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

进程标记

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

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

变量	说明
`STEP_PERMISSION_PRESET`、`STEP_APPROVAL_MODE`	覆盖权限模式，见交互与输入
`STEP_DISABLE_WORKFLOW`	设置为 `1` 关闭 workflow / ultraloop 注册

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

[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 等能力标记。持久的自定义模型配置见平台与模型。

各供应商使用自己的 API Key 环境变量，例如 ANTHROPIC_API_KEY、OPENAI_API_KEY，完整常用列表见平台与模型。

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 按主机名或后缀匹配绕过代理的目标。

export HTTPS_PROXY="http://127.0.0.1:7890"
export NO_PROXY="localhost,127.0.0.1"
step

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