Claude Code / DeepSeek V4
Claude Code接入DeepSeek V4教程
这是一篇给新手直接照着跑的配置教程：先用 DeepSeek 官方 Anthropic 兼容接口把 Claude Code 跑起来，再处理模型选择、报错排查和真实项目里的安全边界。
小白先把软件下载好
下载 Node.js LTS
打开 nodejs.org，下载 LTS 版本。Windows 用户双击安装包，一路 Next；Mac 用户下载 macOS 安装包后照提示安装。Claude Code 需要 Node.js 18+。
打开终端
Windows 打开 PowerShell；Mac 打开 Terminal。先输入 node -v 和 npm -v，能看到版本号，说明 Node 和 npm 已经装好。
安装 Claude Code
Windows PowerShell 用户优先用 npm.cmd 安装，避免 npm.ps1 被系统策略拦住。安装完成后输入 claude --version 验证。
启动 Claude Code
验证成功后输入 claude 启动。第一次先让它说明能力，不要马上让它改文件；在真实项目里用时，先 cd 到项目文件夹再启动。
官方安装命令
node -v npm -v npm install -g @anthropic-ai/claude-code claude --version
国内 npm 慢时用镜像
Windows PowerShell 用户直接复制下面这一段，粘贴后按回车。
npm.cmd install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com claude --version
如果出现红字：npm.ps1 被禁止运行
这说明 PowerShell 安全策略拦住了 npm 脚本，不是 Node.js 没装好，也不是 Claude Code 包坏了。先不要乱改环境变量，复制下面这行重新安装。
npm.cmd install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
如果还是报同样错误，再复制下面这行，出现确认时输入 Y，然后重新执行上面的安装命令。
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
如果看到 changed packages 后，npx 又报红
changed packages 表示 Claude Code 已经装好了。后面 npx 报红，是 PowerShell 拦住了 npx.ps1。这里不要再用 npx，直接复制下面这行验证。
claude --version
如果提示找不到 claude，关闭 PowerShell 重新打开再试；还不行再用下面这行查看安装位置。
where.exe claude
如果 node -v 没有版本号，先别继续配置 DeepSeek，说明 Node.js 没装好或终端没有识别到环境变量。
启动后连不上 Anthropic 官方服务
如果看到 Unable to connect to Anthropic services 或 api.anthropic.com，这不是安装失败。它表示 Claude Code 已经打开了，但默认去连接 Anthropic 官方服务，当前网络、地区或账号环境连不上。
国内新手先用 DeepSeek 跑通
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic" $env:ANTHROPIC_AUTH_TOKEN="sk-你的DeepSeek_API_Key" $env:ANTHROPIC_MODEL="deepseek-v4-flash" claude
把 sk-你的DeepSeek_API_Key 换成你自己的 DeepSeek Key。如果你要使用 Anthropic 官方 Claude，需要确认账号、地区和网络能正常访问官方服务。
Windows PowerShell 完整版
$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" claude
Mac / Linux / WSL 完整版
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 claude
安装好以后怎么启动
只是先打开试试
看到版本号以后，直接复制下面这行启动 Claude Code。
claude
如果出现 Choose the text style that looks best with your terminal，这不是报错，是让你选终端主题。默认 Dark mode 可以直接用，按回车继续。
看到 Choose the text style that looks best with your terminal 直接按回车 以后想改主题： /theme
第一次打开后，先复制这句话，不要马上让它改文件。
请先告诉我你能做什么，不要修改我的文件。
在自己的项目里用
先进入项目文件夹，再启动 Claude Code。路径可以从文件夹地址栏复制。
cd 你的项目文件夹路径 claude
进入后先让它读项目，不要直接修改。
请先阅读这个项目，不要改文件，告诉我它是什么技术栈、主要目录和下一步建议。
配置变量
ANTHROPIC_*
主模型
V4-Pro
子代理
V4-Flash
安全重点
Key / Git
5 步跑通
先装好 Node.js 和 Claude Code
先确认本机 node、npm、claude 三个命令都能正常运行，不要一开始就怀疑模型接口。
先启动一次 Claude Code
安装后输入 claude 启动；第一次只问它能做什么，不要马上让它改文件。
申请 DeepSeek API Key
进入 DeepSeek 开发者平台创建 Key，保存后不要公开发送，不要写进仓库。
配置 Anthropic 兼容接口
Claude Code 读取的是 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 这一组变量。
从小项目开始测试
先让它读 README、总结目录、列计划，再允许它改 1 到 2 个文件。
Mac / Linux
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 claude
Windows PowerShell
$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" claude
常见报错
npm.ps1 被禁止运行
这是 Windows PowerShell 的执行策略拦住了 npm 脚本，不是 Node 或 Claude Code 坏了。先把命令里的 npm 改成 npm.cmd；如果还不行，再执行 Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，确认输入 Y。
npx.ps1 被禁止运行
如果 npm.cmd install 后看到 changed packages，说明已经安装成功。不要再用 npx @anthropic-ai/claude-code --version，直接用 claude --version 验证；如果找不到 claude，关闭 PowerShell 重新打开。
Unable to connect to Anthropic services
这说明 Claude Code 已经启动成功，但默认连接 Anthropic 官方服务失败。国内用户先配置 DeepSeek 的 Anthropic 兼容接口，再重新执行 claude。
401 Unauthorized
Key 写错、复制少字符、前后有空格，或把其他平台 Key 填到了 ANTHROPIC_AUTH_TOKEN。
model not found
模型名不匹配。先按官方或服务商面板写 deepseek-v4-pro[1m]、deepseek-v4-pro、deepseek-v4-flash 之一测试。
请求超时
先缩小任务范围，再看网络和服务状态。大仓库第一次全量分析很容易慢。
改动范围太大
任务提示词里明确只改哪些文件、哪些目录不碰、改完必须解释 diff。
真实项目怎么用
先让 Claude Code 读项目，不要马上改。
让它输出计划和涉及文件，再确认是否合理。
每次只给一个小目标，改完看 git diff。
线上项目先跑 build/test，再部署。
常见问题
Claude Code 接 DeepSeek V4 是官方支持吗？
DeepSeek 提供 Anthropic 兼容接口，并在官方文档里给出 Claude Code 集成方式。实际模型名和参数以 DeepSeek 当前文档与控制台为准。
为什么不用 OPENAI_API_KEY？
Claude Code 这条接入方式走 Anthropic 兼容变量，核心是 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN。把 OpenAI 兼容变量照搬过来，经常会 401 或完全不生效。
V4-Pro 和 V4-Flash 怎么分工？
复杂读仓库、架构设计、跨文件修复优先 V4-Pro；简单搜索、子代理、小改动可以让 V4-Flash 控成本。
下一步
如果官方接口能跑通，再考虑国内中转站；如果官方接口都跑不通，先别换平台，优先排查 Key、base_url、模型名和 Claude Code 版本。