Claude Code 接入国产大模型完整指南

适用环境：Windows 10/11 | 更新时间：2026-05-22

---

一、什么是 Claude Code

Claude Code（简称 CC）是 Anthropic 推出的命令行 AI 编程工具。通过修改配置文件，可以将其后端模型替换为 DeepSeek、智谱 GLM 等国产大模型，大幅降低成本。

架构链路：

Claude Code（终端交互） → 配置文件（settings.json） → 国产模型 API

---

二、安装 Claude Code

2.1 前置环境

软件	下载地址	说明
Node.js	https://nodejs.org	推荐 v18+，Claude Code 运行依赖
Git for Windows	https://git-scm.com	可选，但推荐安装，否则退回 PowerShell

验证安装：

node --version   # 应显示 v18+
git --version    # 应显示 git version x.x.x

2.2 安装 Claude Code

方式一：npm 安装（推荐）

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

方式二：PowerShell 一键安装

irm https://claude.ai/install.ps1 | iex

方式三：WinGet 安装

winget install Anthropic.ClaudeCode

2.3 验证安装

claude --version
# 应输出类似：2.1.91 (Claude Code)

---

三、配置文件说明

3.1 配置文件位置

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

即 ~/.claude/settings.json

3.2 配置结构

{
  "env": {
    "ANTHROPIC_BASE_URL": "模型 API 地址",
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_MODEL": "默认使用的模型",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "Opus 级别映射",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "Sonnet 级别映射",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "Haiku 级别映射",
    "CLAUDE_CODE_SUBAGENT_MODEL": "子代理模型"
  }
}

3.3 模型槽位含义

槽位	Claude Code 中的角色	推荐映射
Opus	最强推理，最高成本	旗舰模型
Sonnet	日常使用，平衡	旗舰模型
Haiku	轻量任务，低成本	快速模型
SubAgent	子代理自动任务	快速模型

---

四、接入 DeepSeek V4

4.1 获取 API Key

1. 打开 https://platform.deepseek.com

2. 注册/登录账号

3. 充值（几块钱即可，V4 价格极低）

4. 进入 API Keys → 点击创建 → 复制 Key（格式：sk-xxxxxxxx）

4.2 配置文件

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的DeepSeek API Key",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash"
  }
}

4.3 可用模型

模型名	上下文	特点	适用场景
deepseek-v4-pro	1M tokens	最强推理能力	复杂编码、架构设计
deepseek-v4-flash	1M tokens	速度快、成本低	日常对话、子代理
deepseek-chat	128K tokens	V3 经典模型	通用任务

4.4 价格参考

模型	输入（缓存命中）	输入（未命中）	输出
V4 Flash	$0.0028/M	$0.14/M	$0.28/M
V4 Pro	$0.0036/M	$0.435/M	$0.87/M

Pro 当前有 75% 折扣（截至 2026/05/31）

---

五、接入智谱 AI（GLM）

5.1 获取 API Key

1. 打开 https://open.bigmodel.cn

2. 注册并完成实名认证

3. 进入 API Keys → 创建 Key（格式：xxxxxxxx.yyyyyyyyyy）

5.2 配置文件

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/paas/v4",
    "ANTHROPIC_AUTH_TOKEN": "你的智谱API Key",
    "ANTHROPIC_MODEL": "glm-4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "glm-4-flash"
  }
}

5.3 可用模型

模型名	特点
glm-4-flash	免费/低价，中文优秀
glm-4-plus	增强版，能力更强
glm-4	标准版

---

六、使用 Claude Code

6.1 启动

# 进入项目目录
cd D:\你的项目
​
# 启动 Claude Code
claude

6.2 常用命令

命令	作用
/model	查看/切换当前模型
/context	查看上下文使用情况
/init	创建 CLAUDE.md 项目说明
/help	查看所有可用命令
Esc 或 /exit	退出

6.3 验证模型

启动后输入：

你是谁？用的是什么模型？

如果回复中提到 DeepSeek 或 GLM，说明配置成功。

---

七、常见问题

Q1：402 Insufficient Balance

原因：API 账号余额不足

解决：到对应平台（DeepSeek / 智谱）充值

Q2：claude 命令不存在

解决：重启终端；如果是 npm 安装的，检查 %AppData%\npm 是否在 PATH 中

Q3：模型未生效

解决：

1. 确认 settings.json 路径正确：C:\Users\你的用户名\.claude\settings.json

2. 确认 JSON 格式正确（无多余逗号）

3. 完全退出 Claude Code 后重新打开

Q4：API Key 无效

解决：

• 检查 Key 是否完整复制（无空格、无换行）

• DeepSeek Key 格式：sk-xxxxxxxx

• 智谱 Key 格式：xxxxxxxx.yyyyyyyyyy

• 确认对应的 Base URL 正确

Q5：如何切换回原始 Claude

解决：删除或清空 settings.json 中的 env 配置，恢复默认即可

---

八、快速对照表

	DeepSeek V4	智谱 GLM
API 地址	api.deepseek.com/anthropic	open.bigmodel.cn/api/paas/v4
Key 格式	sk-xxxx	xxxx.yyyy
旗舰模型	deepseek-v4-pro	glm-4-plus
快速模型	deepseek-v4-flash	glm-4-flash
中文能力	优秀	极佳
价格	便宜（有折扣）	免费模型可用
上下文	1M tokens	128K tokens

---

提示：一次只能接入一个模型提供商。如需切换，修改 settings.json 中的 ANTHROPIC_BASE_URL 和对应的模型名即可。