Claude 环境变量配置 | 搭配 DeepSeek V4 模型

要让 Claude 相关的环境变量(比如 ANTHROPIC_AUTH_TOKEN)永久生效,关键是把变量写入 shell 的启动配置文件,而不是仅在当前终端里 export

下面按操作系统给出最常见、最稳妥的做法。


Linux / macOS(终端)

1. 确定你用的 shell
打开终端,运行:

echo $SHELL

通常输出 /bin/bash(bash)或者 /bin/zsh(zsh,macOS 默认)。

2. 编辑对应的配置文件

  • bash 用户:编辑 ~/.bashrc(大多数 Linux)或者 ~/.bash_profile / ~/.profile(macOS 可能用其中一种)
  • zsh 用户:编辑 ~/.zshrc

用任意编辑器打开,例如:

nano ~/.zshrc   # 如果是 zsh
nano ~/.bashrc # 如果是 bash

3. 在文件末尾添加环境变量

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

保存并退出(nanoCtrl+O 保存,Ctrl+X 退出)。

4. 让配置立刻生效

source ~/.zshrc   # 或 source ~/.bashrc

之后新打开的终端窗口都会自动拥有这个变量。

⚠️ 如果同时有 ~/.bash_profile~/.bashrc,建议添加到 ~/.bash_profile 里并在其中 source ~/.bashrc,保证登录 shell 和非登录 shell 都能加载。


Windows

方法一:图形界面(推荐)

  1. Win 键,搜索 “编辑系统环境变量”“环境变量”
  2. 在“系统属性” → “高级” → “环境变量”。
  3. “用户变量”(只对你生效)或 “系统变量”(对所有用户生效)中,点击“新建”。
  4. 依次添加所需的环境变量(如 ANTHROPIC_AUTH_TOKENANTHROPIC_BASE_URL 等),并填写对应的值
  5. 确认,并重启已经打开的终端或 IDE。

方法二:PowerShell 命令(永久设置)

以管理员身份打开 PowerShell,执行:

[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.deepseek.com/anthropic", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "deepseek-v4-pro[1m]", "User")
  • 第三个参数 "User" 表示只对当前用户永久生效;若改为 "Machine" 则全局生效(需要管理员权限)。
  • 设置后重启 PowerShell 或新打开 CMD 即可。

常见 Claude Code 相关环境变量

  • ANTHROPIC_AUTH_TOKEN:你的 API 密钥,必填(DeepSeek 等第三方接口使用此变量替代 ANTHROPIC_API_KEY)。
  • ANTHROPIC_BASE_URL:自定义 API 地址,接入 DeepSeek 等第三方接口时设置。
  • ANTHROPIC_MODEL:默认模型。
  • ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL / ANTHROPIC_DEFAULT_HAIKU_MODEL:分别指定各模型等级的备选模型。
  • CLAUDE_CODE_SUBAGENT_MODEL:子 Agent 使用的模型。
  • CLAUDE_CODE_EFFORT_LEVEL:思考努力程度。

配置完成后,可以运行 claude 检查是否能正常读取。