WONG公益站里Claude Code环境变量设置教程-公众号：白日梦与诗

关联主题::
同级:: 2025-11-19_星期三
下一级::

📋 方法一：环境变量配置（推荐）

通过设置环境变量来指定自定义 API 端点和密钥。

1 临时设置（当前终端会话有效）

# macOS / Linux export ANTHROPIC_API_KEY="your-api-key" export ANTHROPIC_BASE_URL="https://newapi.netlib.re" # Windows PowerShell $env:ANTHROPIC_API_KEY="your-api-key" $env:ANTHROPIC_BASE_URL="https://newapi.netlib.re" # Windows CMD set ANTHROPIC_API_KEY=your-api-key set ANTHROPIC_BASE_URL=https://newapi.netlib.re

2 永久设置（添加到配置文件）

macOS / Linux (Bash)

# 编辑 ~/.bashrc 或 ~/.bash_profile nano ~/.bashrc # 添加以下内容 export ANTHROPIC_API_KEY="your-api-key" export ANTHROPIC_BASE_URL="https://newapi.netlib.re" # 保存后重新加载 source ~/.bashrc

macOS / Linux (Zsh)

# 编辑 ~/.zshrc nano ~/.zshrc # 添加以下内容 export ANTHROPIC_API_KEY="your-api-key" export ANTHROPIC_BASE_URL="https://newapi.netlib.re" # 保存后重新加载 source ~/.zshrc

Windows (PowerShell)

# 编辑 PowerShell 配置文件 notepad $PROFILE # 添加以下内容 $env:ANTHROPIC_API_KEY="your-api-key" $env:ANTHROPIC_BASE_URL="https://newapi.netlib.re" # 保存后重新加载 . $PROFILE

3 验证配置

# 检查环境变量 echo $ANTHROPIC_API_KEY echo $ANTHROPIC_BASE_URL # Windows PowerShell echo $env:ANTHROPIC_API_KEY echo $env:ANTHROPIC_BASE_URL

4 测试连接

claude "你好，请介绍一下自己"

**✅ 成功！**如果看到 Claude 的回复，说明配置正确。

⚙️ 方法二：配置文件（推荐高级用户）

直接编辑 Claude Code 的配置文件。

1 找到配置文件位置

操作系统	配置文件路径
macOS	`~/.config/claude/config.json`
Linux	`~/.config/claude/config.json`
Windows	`%APPDATA%\claude\config.json`

2 编辑配置文件

# macOS / Linux nano ~/.config/claude/config.json # 或使用任意文本编辑器 code ~/.config/claude/config.json

3 添加反代配置

{ "apiKey": "your-api-key", "baseURL": "https://newapi.netlib.re", "defaultModel": "claude-3-5-sonnet-20241022", "maxTokens": 4096, "temperature": 0.7 }

💡 配置参数说明：

apiKey - 您的反代服务器 API 密钥
baseURL - 反代服务器地址（不需要 /v1 后缀）
defaultModel - 默认使用的模型
maxTokens - 最大生成 token 数
temperature - 响应随机性（0-1）

4 测试配置

claude "你好"

🎯 方法三：命令行参数（临时使用）

通过命令行参数临时指定 API 配置。

claude --api-key "your-api-key" --base-url "https://newapi.netlib.re" "你好" # 或使用简写 claude -k "your-api-key" -b "https://newapi.netlib.re" "你好"

💡 使用场景：

临时切换不同的反代服务器
测试新的 API 端点
不想修改全局配置

🔄 方法四：多配置管理

为不同的反代服务器创建配置文件。

1 创建配置文件

# 创建配置目录 mkdir -p ~/.claude-configs # 创建不同的配置文件 nano ~/.claude-configs/proxy1.json nano ~/.claude-configs/proxy2.json

2 配置文件示例

# proxy1.json { "apiKey": "key-for-proxy1", "baseURL": "https://proxy1.example.com" } # proxy2.json { "apiKey": "key-for-proxy2", "baseURL": "https://proxy2.example.com" }

3 使用指定配置

claude --config ~/.claude-configs/proxy1.json "你好" # 或创建别名 alias claude-proxy1='claude --config ~/.claude-configs/proxy1.json' alias claude-proxy2='claude --config ~/.claude-configs/proxy2.json' # 使用别名 claude-proxy1 "你好"

🛠️ 常见配置示例

示例 1：基础配置

export ANTHROPIC_API_KEY="sk-ant-1234567890" export ANTHROPIC_BASE_URL="https://newapi.netlib.re"

示例 2：带端口的配置

export ANTHROPIC_API_KEY="sk-ant-1234567890" export ANTHROPIC_BASE_URL="https://newapi.netlib.re:8443"

示例 3：本地反代配置

export ANTHROPIC_API_KEY="local-test-key" export ANTHROPIC_BASE_URL="http://localhost:8000"

示例 4：使用子路径

export ANTHROPIC_API_KEY="sk-ant-1234567890" export ANTHROPIC_BASE_URL="https://newapi.netlib.re/claude"

🔍 测试与验证

1. 检查配置

# 查看当前配置 claude config show # 或查看环境变量 env | grep ANTHROPIC

2. 测试连接

# 简单测试 claude "hello" # 详细测试（显示调试信息） claude --verbose "hello" # 指定模型测试 claude --model claude-3-5-sonnet-20241022 "hello"

3. 检查日志

# 启用调试日志 export CLAUDE_LOG_LEVEL=debug claude "test" # 查看日志文件（如果存在） tail -f ~/.claude/logs/debug.log

❓ 常见问题

Q1: 提示 “API endpoint unreachable”

可能原因：

反代服务器地址错误
网络连接问题
防火墙阻止

解决方法：

# 测试反代服务器是否可访问 curl -I https://newapi.netlib.re # 检查 DNS 解析 nslookup newapi.netlib.re # 测试 API 端点 curl https://newapi.netlib.re/v1/messages \ -H "x-api-key: your-key" \ -H "anthropic-version: 2023-06-01"

Q2: 提示 “Invalid API key”

解决方法：

确认 API Key 格式正确
检查环境变量是否正确设置
联系反代服务商确认密钥状态

# 验证环境变量 echo "API Key: $ANTHROPIC_API_KEY" echo "Base URL: $ANTHROPIC_BASE_URL"

Q3: 配置不生效

排查步骤：

确认已重新加载配置文件（source ~/.bashrc）
检查环境变量优先级（命令行 > 环境变量 > 配置文件）
尝试重启终端
使用 —verbose 查看详细日志

Q4: SSL 证书错误

临时解决（仅开发环境）：

# 跳过 SSL 验证（不推荐生产环境） export ANTHROPIC_SKIP_SSL_VERIFY=true claude "test"

⚠️ 生产环境建议配置正确的 SSL 证书

配置自定义 Header：

# 通过环境变量设置 export ANTHROPIC_HEADERS='{"X-Custom-Header": "value"}' # 或在配置文件中 { "apiKey": "your-key", "baseURL": "https://newapi.netlib.re", "headers": { "X-Custom-Header": "value", "X-Another-Header": "value2" } }

🔐 安全建议

⚠️ 重要提醒：

**不要硬编码密钥：**使用环境变量或配置文件
**保护配置文件：**设置正确的文件权限
**不提交到 Git：**将配置文件添加到 .gitignore
**定期轮换密钥：**定期更换 API Key
**使用 HTTPS：**确保反代服务器使用 HTTPS

设置文件权限

# macOS / Linux chmod 600 ~/.config/claude/config.json # 仅允许当前用户读写 ls -la ~/.config/claude/config.json

Git 忽略配置

# .gitignore .claude/ .claude-configs/ config.json *.env

📊 完整配置示例

环境变量完整配置

# ~/.zshrc 或 ~/.bashrc # Claude 反代配置 export ANTHROPIC_API_KEY="sk-ant-1234567890abcdef" export ANTHROPIC_BASE_URL="https://newapi.netlib.re" # 可选配置 export CLAUDE_DEFAULT_MODEL="claude-3-5-sonnet-20241022" export CLAUDE_MAX_TOKENS="4096" export CLAUDE_TEMPERATURE="0.7" # 调试选项（可选） # export CLAUDE_LOG_LEVEL="debug" # export ANTHROPIC_SKIP_SSL_VERIFY="false"

配置文件完整示例

{ "apiKey": "sk-ant-1234567890abcdef", "baseURL": "https://newapi.netlib.re", "defaultModel": "claude-3-5-sonnet-20241022", "maxTokens": 4096, "temperature": 0.7, "timeout": 60, "headers": { "X-Custom-Header": "your-value" }, "retries": 3, "retryDelay": 1000 }

🎓 快速上手

1 设置环境变量

export ANTHROPIC_API_KEY="your-api-key" export ANTHROPIC_BASE_URL="https://newapi.netlib.re"

2 测试连接