1. 安装 Claude Code

• 安装 Node.js 18+。
• Windows 用户需安装 Git for Windows。
• 在命令行界面，执行以下命令安装 Claude Code：

npm install -g @anthropic-ai/claude-code

• 安装结束后，执行以下命令，若显示版本号则安装成功：

claude --version

2. 配置环境变量

Linux / Mac 用户执行以下命令配置 DeepSeek Anthropic API 环境变量，其中 API Key 在 DeepSeek Platform 获取：

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

Windows 用户执行：

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

3. 进入项目目录，执行 claude 命令，即可开始使用了。

cd /path/to/my-project
claude

.遇到问题

:\claude>$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" 文件名、目录名或卷标语法不正确。 F:\claude>$env:ANTHROPIC_AUTH_TOKEN="sk-f77b7cf902834b0eaa252126243cd10c" 文件名、目录名或卷标语法不正确。 F:\claude>$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]" 文件名、目录名或卷标语法不正确。 F:\claude>$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]" 文件名、目录名或卷标语法不正确。 F:\claude>$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]" 文件名、目录名或卷标语法不正确。 F:\claude>$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash" 文件名、目录名或卷标语法不正确。 F:\claude>$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash" 文件名、目录名或卷标语法不正确。

根本原因

在 PowerShell 中，当环境变量值包含 ** 方括号[]** 等特殊字符时，直接使用双引号包裹会被 PowerShell 解析器误解为通配符或数组语法，从而触发这个错误。

正确的 PowerShell 设置方法

使用单引号包裹变量值，单引号会让 PowerShell 将内容视为纯字符串，不进行任何解析：

powershell

# 正确写法（全部使用单引号）
$env:ANTHROPIC_BASE_URL='https://api.deepseek.com/anthropic'
$env:ANTHROPIC_AUTH_TOKEN='sk-****************0c'
$env:ANTHROPIC_MODEL='deepseek-v4-pro[1m]'
$env:ANTHROPIC_DEFAULT_OPUS_MODEL='deepseek-v4-pro[1m]'
$env:ANTHROPIC_DEFAULT_SONNET_MODEL='deepseek-v4-pro[1m]'
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL='deepseek-v4-flash'
$env:CLAUDE_CODE_SUBAGENT_MODEL='deepseek-v4-flash'
$env:CLAUDE_CODE_EFFORT_LEVEL='max'

如果你是在 CMD 中运行

如果你实际使用的是 CMD 命令提示符（不是 PowerShell），则需要使用 CMD 的环境变量语法：

cmd

set ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
set ANTHROPIC_AUTH_TOKEN=sk-f7***********243cd10c
set ANTHROPIC_MODEL=deepseek-v4-pro[1m]
set ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
set ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
set ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
set CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
set CLAUDE_CODE_EFFORT_LEVEL=max

DeepSeek Anthropic 兼容端点说明

1. ANTHROPIC_BASE_URL：Claude Code 默认向 api.anthropic.com 发请求，这里改成 DeepSeek 的 Anthropic 协议兼容端点 [https://api.deepseek.com/anthropic] 实现零改造切换服务商。
2. ANTHROPIC_AUTH_TOKEN：你的 DeepSeek API Key。可以从 DeepSeek Platform 创建。
3. ANTHROPIC_MODEL：Claude Code 启动时的默认模型。当用户不指定模型档位（Opus/Sonnet/Haiku）时，走这个模型。
4. ANTHROPIC_DEFAULT_OPUS_MODEL：当你在 Claude Code 里选择 Opus（最高智能档位）时，实际调用的 DeepSeek 模型。这里映射到 deepseek-v4-pro。
5. ANTHROPIC_DEFAULT_SONNET_MODEL：选择 Sonnet（平衡档位）时，实际调用的模型。同样映射到 deepseek-v4-pro，相当于把 Sonnet 和 Opus 都指向同一个最强模型。
6. ANTHROPIC_DEFAULT_HAIKU_MODEL：选择 Haiku（快速/廉价档位）时，实际调用的模型。映射到 deepseek-v4-flash，用于简单任务或代码补全。
7. CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：设为 1 时，禁用 Claude Code 的非核心网络请求（比如遥测、埋点、功能标志拉取、版本检查等），减少向 Anthropic 官方服务器的"漏网"流量，提升隐私性。
8. CLAUDE_CODE_EFFORT_LEVEL：推理深度，设为 high 表示让模型在生成代码前做更充分的思考（多步分析、关联文件检查），适合复杂编码任务。这个参数支持 low/medium/high/xhigh/max 几个值，推理深度越高 tokens 消耗越大，也越适用于复杂任务，一般任务设置成 high 即可。

验证