一篇搞定 Claude Code 国内安装：DeepSeek 接入 + 多模型切换 + 全报错排查（Mac/Windows 双平台）

个人主页：夏天拐跑了西瓜
专栏传送门：《大模型应用开发》、《Spring 生态全家桶体系化实战》
学习方向：Java 后端｜AI‑Agent 大模型应用开发爱好者
⭐人生格言：路虽远，行则将至

封面图

本文适合：想在国内网络环境下使用 Claude Code CLI，但不想折腾科学网络、不想登录 Anthropic 账号的开发者。

全文基于国内纯内网环境实测，覆盖 Mac/Linux 与 Windows 双平台，看完即可一次跑通：安装 → DeepSeek 接口配置 → 多模型切换 → 常见报错根治。

一、前言（国内用户最大痛点）

国外教程全部默认科学网络，国内裸连直接：安装超时、下载失败、login 卡死、无法拉取模型、接口报错、JSON 报错。

本文基于 国内纯内网环境 实测，整理：

  • 国内如何成功安装 Claude Code（解决超时、下载失败）

  • 不用魔法、不用登录 Anthropic 账号

  • DeepSeek 官方 Anthropic 兼容接口配置

  • 完整全套模型配置（主模型 + 子代理全部补齐）

  • 多模型自由切换（coder/chat/reasoner）

  • Windows 环境完整安装配置步骤（PowerShell 全流程）

  • 常见报错全集 + 对应根治方案

二、国内安装最大问题总结（必看）

国内直接执行官方脚本会出现：

  • 安装脚本超时

  • 资源下载失败

  • 卡在 login 登录界面

  • 无法连接官方接口

  • 自动更新失败

核心结论：国内绝对不能走官方原生鉴权，必须全程 DeepSeek 代理接口 + 屏蔽官方网络校验。

三、国内成功安装 Claude Code 步骤（无魔法）

在这里插入图片描述

3.1 推荐安装方式（国内成功率最高）

优先使用 npm 本地安装，规避官方脚本国外 CDN 超时：

# 国内镜像安装（必用！解决超时、下载失败）
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

3.2 验证是否安装成功

claude --version

输出版本号即为成功，国内环境无需登录。

四、国内用户最关键：彻底规避官方登录校验

国内打开 claude 默认会强制：Not logged in，卡在登录界面。

原因：Claude Code 默认优先走官方 Anthropic 服务器，国内不通。

根治方法：

  • 不使用任何官方登录

  • 全部使用 DeepSeek 官方 Anthropic 兼容接口

  • 配置环境变量屏蔽模型校验

五、DeepSeek 国内可用接口说明（重点）

DeepSeek 专门提供适配 Claude Code 的 Anthropic 协议接口，国内可直接访问：

https://api.deepseek.com/anthropic

支持三个模型：

模型名 定位
deepseek-coder-v2 代码能力最强
deepseek-chat 通用对话
deepseek-reasoner 深度推理

国内用户唯一可用地址！不是 /v1！！

六、终极完整配置（一次配好不再折腾）

6.1 先修复之前的 JSON 报错

频繁报错：Invalid or malformed JSON

原因：换行、空格、数字未加引号、配置错乱。

一键清空损坏配置：

echo '{}' > ~/.claude/settings.json

6.2 最终完整版 settings.json（国内 100% 可用）

补齐 全部模型变量（主模型 + 子代理全套配置）：

{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"sk-你的密钥","ANTHROPIC_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-coder-v2","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-coder-v2","CLAUDE_CODE_MAX_CONTEXT_TOKENS":128000,"CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WARNING":"1"}}
变量 作用
ANTHROPIC_BASE_URL DeepSeek Anthropic 兼容接口地址
ANTHROPIC_AUTH_TOKEN DeepSeek 平台申请的 API Key
ANTHROPIC_MODEL 当前生效的主模型（唯一）
ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL 不同等级任务的默认模型
CLAUDE_CODE_SUBAGENT_MODEL 子代理模型，避免子任务报错
CLAUDE_CODE_MAX_CONTEXT_TOKENS 最大上下文长度
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WARNING 关闭未知模型黄色警告

6.3 一键写入命令（Mac/Linux）

echo '{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"sk-你的密钥","ANTHROPIC_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-coder-v2","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-coder-v2","CLAUDE_CODE_MAX_CONTEXT_TOKENS":128000,"CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WARNING":"1"}}' > ~/.claude/settings.json

七、高频疑问：一个 settings.json 能不能配置多个模型？

官方硬性限制：同一时刻只能生效一个主模型。

常见疑问：为什么配置了多个 model 不生效？

解答：

  • ANTHROPIC_MODEL 是当前主模型（唯一生效）

  • 下面几个 ANTHROPIC_DEFAULT_*_MODEL 是子任务模型

  • 无法同时启用 coder + chat

所以必须：切换模型（见下一章）

八、国内可用多模型切换方案（Mac/Linux，实测可用）

8.1 方案1：环境变量动态切换（最稳）

# 代码模型
ANTHROPIC_MODEL="deepseek-coder-v2" claude

# 通用模型
ANTHROPIC_MODEL="deepseek-chat" claude

# 推理模型
ANTHROPIC_MODEL="deepseek-reasoner" claude

8.2 方案2：一键切换脚本 ds.sh

ds.sh：

#!/bin/bash
KEY="sk-你的密钥"
BASE_URL="https://api.deepseek.com/anthropic"

case $1 in
coder) MODEL="deepseek-coder-v2";;
chat) MODEL="deepseek-chat";;
reasoner) MODEL="deepseek-reasoner";;
*) echo "用法：./ds.sh [coder|chat|reasoner]";exit;;
esac

export ANTHROPIC_BASE_URL=$BASE_URL
export ANTHROPIC_AUTH_TOKEN=$KEY
export ANTHROPIC_MODEL=$MODEL
export ANTHROPIC_DEFAULT_OPUS_MODEL=$MODEL
export ANTHROPIC_DEFAULT_SONNET_MODEL=$MODEL
export ANTHROPIC_DEFAULT_HAIKU_MODEL=$MODEL
export CLAUDE_CODE_SUBAGENT_MODEL=$MODEL

claude

运行：

chmod +x ds.sh
./ds.sh coder

九、Windows 环境完整配置步骤（国内无魔法全流程）

前面章节以 Mac/Linux 为主，本章给出 Windows 下的完整落地步骤，配置原理完全一致，只是命令和文件路径不同。

9.1 环境准备：安装 Node.js

Windows 上同样通过 npm 安装，先装 Node.js LTS（自带 npm）：

  • 官方下载：https://nodejs.org/zh-cn
  • 国内下载慢可用镜像：https://npmmirror.com/mirrors/node/ （选 LTS 版本的 node-vXX-win-x64.msi）

安装完成后打开 PowerShell（推荐 Windows Terminal）验证：

node -v
npm -v

能输出版本号即可。

9.2 安装 Claude Code（只能用 npm，官方脚本不支持 Windows）

官方的 curl 一键脚本只支持 Mac/Linux，Windows 必须走 npm：

# 国内镜像安装（必用！解决超时、下载失败）
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 验证安装
claude --version

提示：如果 claude 命令找不到，重新开一个 PowerShell 窗口；还不行则检查 npm config get prefix 的路径是否加入了系统 PATH。

9.3 写入 settings.json（Windows 路径与命令）

Windows 下配置文件路径为：

C:\Users\你的用户名\.claude\settings.json

即 %USERPROFILE%\.claude\settings.json，内容与前文完整版完全一致，一键写入命令改用 PowerShell：

# 先创建目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude"

# 一键写入完整配置（替换 sk-你的密钥）
Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Value '{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"sk-你的密钥","ANTHROPIC_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-coder-v2","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-coder-v2","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-coder-v2","CLAUDE_CODE_MAX_CONTEXT_TOKENS":128000,"CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WARNING":"1"}}' -Encoding UTF8

清空损坏配置同理：

Set-Content -Path "$env:USERPROFILE\.claude\settings.json" -Value '{}' -Encoding UTF8

注意：不要在 PowerShell 里用 echo > 重定向写 JSON，容易引入编码问题导致 Invalid or malformed JSON，统一用 Set-Content。

9.4 Windows 多模型切换方案

方案1：PowerShell 临时环境变量（当次会话生效）

# 代码模型
$env:ANTHROPIC_MODEL="deepseek-coder-v2"; claude

# 通用模型
$env:ANTHROPIC_MODEL="deepseek-chat"; claude

# 推理模型
$env:ANTHROPIC_MODEL="deepseek-reasoner"; claude

方案2：setx 永久写入用户环境变量（改完需重开终端生效）

setx ANTHROPIC_BASE_URL "https://api.deepseek.com/anthropic"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"
setx ANTHROPIC_MODEL "deepseek-coder-v2"

方案3：一键切换脚本 ds.ps1（Windows 版 ds.sh）

新建 ds.ps1：

param([string]$Mode = "coder")

$KEY = "sk-你的密钥"
$BASE_URL = "https://api.deepseek.com/anthropic"

switch ($Mode) {
    "coder"    { $MODEL = "deepseek-coder-v2" }
    "chat"     { $MODEL = "deepseek-chat" }
    "reasoner" { $MODEL = "deepseek-reasoner" }
    default { Write-Host "用法：.\ds.ps1 [coder|chat|reasoner]"; exit }
}

$env:ANTHROPIC_BASE_URL = $BASE_URL
$env:ANTHROPIC_AUTH_TOKEN = $KEY
$env:ANTHROPIC_MODEL = $MODEL
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = $MODEL
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = $MODEL
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = $MODEL
$env:CLAUDE_CODE_SUBAGENT_MODEL = $MODEL

claude

运行：

.\ds.ps1 coder

首次运行如报"在此系统上禁止运行脚本"，先执行一次：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned，输入 Y 确认。

9.5 Windows 专属报错速查

  • claude 不是内部或外部命令：安装后未刷新 PATH，重开终端；或 npm 全局目录不在 PATH
  • 禁止运行脚本（ExecutionPolicy）：执行上面 Set-ExecutionPolicy 命令
  • 想直接用 bash/ds.sh：安装 Git Bash 或 WSL2（wsl --install），WSL2 内可直接照搬前文 Mac/Linux 全部命令
  • 官方 curl 安装脚本执行失败：Windows 不支持，只用本章 npm 方式

十、所有报错 + 100% 解决办法（重点收录）

报错1：Invalid or malformed JSON

原因：配置文件乱码、换行、语法错误、数字没加引号

解决：

echo '{}' > ~/.claude/settings.json

清空后重新写入单行配置。

报错2：Not logged in / 强制登录

原因：国内无法连接官方服务器

解决：彻底放弃官方登录，只用 DeepSeek 兼容接口

报错3：Model may not exist / 模型不存在

常见踩坑原因：

  • 错误加前缀：deepseek/deepseek-coder-v2

  • 用错地址：用了 /v1 而不是 /anthropic

解决：模型名纯名称、地址固定 anthropic

报错4：黄色 unknown model warning

解释：正常警告，客户端不认识第三方模型，不影响使用

解决：添加环境变量关闭

CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WARNING="1"

报错5：国内安装超时、下载失败、资源拉取不全

原因：官方安装脚本走国外 CDN，国内网络不通

解决：放弃官方脚本，必须使用淘宝 npm 镜像源安装（前文已提供安装命令），可 100% 规避网络超时问题

十一、最终国内用户避坑总结

  1. 国内不能走官方登录、不能走官方接口

  2. 必须使用 DeepSeek /anthropic 兼容地址

  3. 模型名 绝对不能加 deepseek/ 前缀

  4. settings.json 只能单模型主生效，多模型只能切换

  5. JSON 必须单行、严谨格式，否则直接报错

  6. 全套补齐 6 个模型变量，杜绝子任务报错

  7. 黄色警告无需理会，属于正常客户端提示

  8. Windows 只能走 npm 安装，配置文件用 Set-Content 写入，避免编码问题

如果本文帮你跑通了 Claude Code，欢迎点赞收藏；遇到新的报错欢迎评论区交流，持续更新。

Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

Google能索引，AI却抓不到

很多技术团队有个错觉：只要Google能正常收录，内容就没问题。但现实是，你的页面在Google搜索结果里好好的，在ChatGPT、Perplexity、Claude的答案里却像从未存在过一样。

avatar DeepSeek技术社区

初识智能体

在过去两年中，几乎所有人都体验过大语言模型（如 ChatGPT、Claude、DeepSeek）的强大能力：写周报、润色邮件、解答编程疑难。被动响应：你问一句，它答一句。如果你的 Prompt 没有写清楚约束条件，它无法主动追问或修正目标。知行脱节：大模型能用流畅的文字告诉你“如何部署一个高可用 K8s 集群”，但它无法替你登录服务器敲下命令、查看报错日志并自动回滚。信息孤岛：大模型的知识止步于预

avatar DeepSeek技术社区
cover

Windows 下部署 New API 中转站全过程实录（含 6 个真实踩坑）

avatar DeepSeek技术社区