1. 安装并确认 Claude Code
npm install -g @anthropic-ai/claude-code
claude --version官方当前还提供原生安装方式；如果已经安装，先执行 claude update。
2. macOS / Linux 配置
export ANTHROPIC_BASE_URL="https://api.openlux.ai"
export ANTHROPIC_AUTH_TOKEN="你的 API Key"
claude需要永久生效时，把前两行加入 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。
3. Windows PowerShell 配置
$env:ANTHROPIC_BASE_URL="https://api.openlux.ai"
$env:ANTHROPIC_AUTH_TOKEN="你的 API Key"
claude永久保存可用 [Environment]::SetEnvironmentVariable，保存后必须新开 PowerShell 窗口。
4. 30 秒验证
claude -p "只回复 OK"返回内容说明链路可用。401 优先检查 Key；404 检查地址是否多写路径；超时先用 curl -I https://api.openlux.ai 检查网络。
安全提醒
API Key 只放在本机环境变量或密钥管理器里，不要提交到 Git、截图或粘贴进公开日志。中转服务属于第三方网关，处理敏感代码前应评估数据与合规要求。
常见问题
BASE_URL 后面要加 /v1 吗？
Claude Code 这里使用服务基础地址；OpenLux 配置为 https://api.openlux.ai。不要自行追加 /v1/messages。
为什么设置后仍访问旧地址？
通常是旧终端没有重新加载变量，或项目/用户设置覆盖了环境变量。新开终端并按排查页逐项检查。
参考资料
Anthropic：LLM gateway configuration · Cline：OpenAI Compatible