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