Claude Code 全平台完整安装教程及模型适配

一、Claude Code 多平台完整安装教程

前置说明

1. 运行依赖：Node.js，国内网络无需翻墙，切换淘宝镜像即可高速安装

1. 官方原生接口国内无法使用，安装后搭配国产大模型接口即可正常使用

1. 支持环境：Windows 原生、Windows WSL 子系统、主流 Linux

1. Windows 原生安装（最简单首选）

1.1 安装运行环境

1. 官网下载安装 Node.js LTS 稳定版
   地址：https://nodejs.org/

1. 安装过程勾选 Add to PATH 自动加入系统环境变量

1. 安装完成重启 PowerShell，校验环境

|---------------------------|
| powershell node -v npm -v |

1.2 切换国内镜像（解决安装卡顿、无响应）

|-------------------------------------------------------------------------------------------|
| powershell npm config set registry https://registry.npmmirror.com npm cache clean --force |

1.3 全局安装 Claude Code

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

1.4 校验与启动

|-----------------------------------------------------------------------|
| powershell # 查看版本 claude --version # 进入项目目录启动 cd /d D:\你的项目路径 claude |

1.5 卸载命令

|-------------------------------------------------------|
| powershell npm uninstall -g @anthropic-ai/claude-code |

2. Windows 通过 WSL 安装（纯净 Linux 环境）

2.1 管理员身份打开 PowerShell，开启 WSL

|--------------------------|
| powershell wsl --install |

执行后重启电脑，自动安装默认 Ubuntu 系统，设置账号密码。

2.2 进入 Ubuntu 终端执行环境部署

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| bash # 更新软件源 sudo apt update # 安装 Node.js 与 npm sudo apt install nodejs npm -y # 切换国内 npm 镜像 npm config set registry https://registry.npmmirror.com # 全局安装 Claude Code sudo npm install -g @anthropic-ai/claude-code --unsafe-perm=true # 校验版本 claude --version |

2.3 WSL 访问 Windows 本地项目

Windows 磁盘统一挂载在 /mnt/ 目录

|---------------------------------------|
| bash # 进入D盘项目 cd /mnt/d/项目文件夹名 claude |

3. 原生 Linux 系统安装（Ubuntu / CentOS）

Ubuntu / Debian 系列

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| bash sudo apt update sudo apt install nodejs npm -y npm config set registry https://registry.npmmirror.com sudo npm install -g @anthropic-ai/claude-code --unsafe-perm=true |

CentOS / RHEL 系列

|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| bash sudo yum install nodejs npm -y npm config set registry https://registry.npmmirror.com sudo npm install -g @anthropic-ai/claude-code --unsafe-perm=true |

启动使用

|---------------------|
| bash cd 项目目录 claude |

4. Claude Code 通用常用指令

|-------------------------------------------------------------------------------------|
| Plain Text claude 启动编程助手 /model 查看当前调用模型 /clear 清空会话上下文 /exit 退出终端会话 /help 查看全部内置命令 |

二、国产大模型适配配置教程（Windows 环境为主）

核心原理

Claude Code 仅识别 Anthropic 协议接口 ，不能使用 OpenAI 格式 /v1 接口，所有模型统一配置 3 项环境变量即可使用，密钥平台通用。

环境变量配置位置

此电脑 → 右键属性 → 高级系统设置 → 环境变量 → 用户变量新建

|--------------------------------------------------------------------------------------|
| Plain Text ANTHROPIC_BASE_URL 接口地址 ANTHROPIC_MODEL 模型名称 ANTHROPIC_AUTH_TOKEN 平台API密钥 |

配置完成必须重启终端生效。

1. DeepSeek 全系模型配置（最优首选）

接口固定地址

https://api.deepseek.com/anthropic

可用模型

1. deepseek-v4-pro 旗舰编程最强

1. deepseek-v4-flash 高速低成本

1. deepseek-coder 旧版普通代码模型

1. deepseek-chat 通用聊天模型

完整配置示例

|---------------------------------------------------------------------------------------------------------------------------------------|
| Plain Text ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic ANTHROPIC_MODEL=deepseek-v4-pro ANTHROPIC_AUTH_TOKEN=你的DeepSeek sk密钥 |

2. 阿里通义千问 Qwen 配置

|----------------------------------------------------------------------------------------------------------------------------------------------------|
| Plain Text ANTHROPIC_BASE_URL=https://coding.dashscope.aliyuncs.com/apps/anthropic ANTHROPIC_MODEL=qwen3-coder-plus ANTHROPIC_AUTH_TOKEN=阿里百炼API密钥 |

3. 豆包编程模型配置（火山方舟）

|-----------------------------------------------------------------------------------------------------------------------------------------------|
| Plain Text ANTHROPIC_BASE_URL=https://ark.cn-beijing.volces.com/api/v3/anthropic ANTHROPIC_MODEL=doubao-seed-code ANTHROPIC_AUTH_TOKEN=火山方舟密钥 |

4. 智谱 GLM 模型配置

|-----------------------------------------------------------------------------------------------------------------------------------|
| Plain Text ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/paas/v4/anthropic ANTHROPIC_MODEL=glm-4.7 ANTHROPIC_AUTH_TOKEN=智谱API密钥 |

三、主流模型实力对比 & 定位区分

1. 代码能力 VS 聊天能力区分

1. deepseek-v4-pro
   代码能力：顶尖级别，多文件重构、项目调试、工程代码全能
   聊天能力：中等偏上，日常沟通够用，不偏向闲聊创意
   定位：Claude Code 写代码第一选择

1. deepseek-chat
   代码能力：一般，仅适合简单代码
   聊天能力：极强，通用对话、文案、日常闲聊最优
   定位：纯聊天使用，不适合编程开发

1. 通义千问 Qwen
   代码优秀，中文业务逻辑适配好，综合均衡

1. 豆包 Seed-Code
   性价比高，响应快，前端开发友好，综合偏弱于 V4-Pro

1. GLM-4.7
   复杂算法、底层代码强势，国内第一梯队编程模型

2. DeepSeek-V4-Pro VS 原生 Claude Opus 3.5

1. 代码实力：V4-Pro 基本持平甚至部分场景超越 Claude Opus

1. 上下文：V4-Pro 100 万 Token 远大于原生 Claude

1. 访问体验：V4-Pro 国内直连低延迟；原生 Claude 必须翻墙、易掉线

1. 使用成本：Claude Opus 价格是 V4-Pro 10~20 倍

1. 合规性：DeepSeek 国内合规数据安全；原生模型存在跨境风险

3. DeepSeek 计费规则与省钱方案

1. 计费模式：无包月套餐、无固定会员，纯按量充值计费，余额永久有效

1. 核心福利：代码场景缓存命中低价扣费，反复读取项目文件大幅省钱

1. 省钱搭配

• 复杂项目重构、排错：使用 deepseek-v4-pro

• 简单改代码、日常询问：使用 deepseek-v4-flash

1. 个人开发者月均消耗：5~20 元足够日常开发使用

1. 避坑提醒：不使用第三方低价包月中转，存在代码泄露、接口不稳定风险

四、最终性价比选型推荐

1. 专业开发、项目调试、代码重构
   首选：deepseek-v4-pro，无限贴近原生 Claude 顶级体验，成本极低

1. 轻度编程、快速改代码
   首选：deepseek-v4-flash，速度快开销最小

1. 前端开发、日常轻度开发
   首选：豆包编程模型，延迟最低性价比高

1. 复杂算法、底层开发
   首选：智谱 GLM-4.7

1. 纯聊天娱乐，不用来写代码
   首选：deepseek-chat

五、常见报错解决

1. claude 不是内部命令
   解决：重启电脑，确认 Node.js 环境变量配置成功

1. 调用接口报错 400
   解决：误用 /v1 接口，必须改为 anthropic 协议地址

1. 认证失败
   解决：核对 API 密钥是否完整无空格、密钥余额是否充足

1. 调用超时
   解决：切换 DeepSeek 模型，国内节点最稳定