环境变量配置

在 macOS、Linux、Windows 以及本地开发工程中安全配置 AnyStarX 的环境变量。

通过系统环境变量管理 API Key 和接口地址,可以避免将敏感凭据直接硬编码在代码文件中。主流 SDK 与命令行工具均支持自动从运行环境中读取对应的标准变量。

推荐标准环境变量

兼容 OpenAI 协议的工具与 SDK 通常读取以下变量:

OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://console.anystarx.com/v1
MODEL_ID=MODEL_ID

使用 Claude 原生协议或 Anthropic 兼容工具时,通常配置以下变量:

ANTHROPIC_BASE_URL=https://console.anystarx.com
ANTHROPIC_AUTH_TOKEN=sk-...
ANTHROPIC_API_KEY=sk-...

macOS 与 Linux 环境配置

在当前终端会话中临时生效:

export OPENAI_API_KEY="sk-..."
export OPENAI_BASE_URL="https://console.anystarx.com/v1"

若需使配置在后续所有新建终端中均保持生效,可将导出语句写入 Shell 配置文件(以 zsh 为例):

echo 'export OPENAI_API_KEY="sk-..."' >> ~/.zshrc
echo 'export OPENAI_BASE_URL="https://console.anystarx.com/v1"' >> ~/.zshrc
source ~/.zshrc

如果系统默认使用 bash,则将上述目标文件替换为 ~/.bashrc

Windows PowerShell 环境配置

在当前 PowerShell 窗口中临时生效:

$env:OPENAI_API_KEY="sk-..."
$env:OPENAI_BASE_URL="https://console.anystarx.com/v1"

写入当前用户的持久化环境变量:

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-...", "User")
[Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://console.anystarx.com/v1", "User")

持久化设置完成后,需要重新启动终端窗口加载最新变量。

工程目录中的本地配置文件

在基于 Vite、Next.js 或通用 Node.js 的工程项目中,推荐将配置保存在根目录下的 .env.local 文件中:

OPENAI_API_KEY=sk-...
OPENAI_BASE_URL=https://console.anystarx.com/v1
MODEL_ID=MODEL_ID

必须确保项目的 .gitignore 文件已将 .env.local 排除在版本控制之外,防止密钥被意外推送到代码仓库。

环境变量生效验证

在配置完成后,可以通过打印变量值验证当前终端是否已成功加载:

macOS 与 Linux 环境:

echo "$OPENAI_API_KEY"
echo "$OPENAI_BASE_URL"

Windows PowerShell 环境:

echo $env:OPENAI_API_KEY
echo $env:OPENAI_BASE_URL

如果输出为空,说明当前环境尚未加载对应变量,需要检查配置文件路径并确认已重新打开终端或执行加载命令。

本页内容