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
打开 https://platform.deepseek.com
注册/登录账号
充值(几块钱即可,V4 价格极低)
进入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
打开 https://open.bigmodel.cn
注册并完成实名认证
进入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:模型未生效
解决:
确认
settings.json路径正确:C:\Users\你的用户名\.claude\settings.json确认 JSON 格式正确(无多余逗号)
完全退出 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和对应的模型名即可。