很多人第一次听说 Claude Code，第一反应是「国内能用吗？」然后就关掉页面了。这里有一个认知盲区：Claude Code 不是 Claude 模型本身，是一个 Agent 框架，可以接任何模型——Claude 原生模型、国产大模型，随便你选。

关键认知

Claude Code 不是 Claude 模型本身。

Claude Code 是一个 Agent 框架。框架这东西，封不了。

更关键的是：这个框架可以接任何模型——Claude 原生模型、国产大模型，随便你选。

Step 0：先判断你是哪种情况

两个问题：

1. 你用的是 Mac 还是 Windows？
2. 你有没有魔法（科学上网）？

四种组合，对应四条路径：

情况	系统	魔法	路径
A	Mac	✅ 有	一键安装
B	Mac	❌ 无	国内镜像
C	Windows	✅ 有	WSL2
D	Windows	❌ 无	国内镜像+WSL2

Step 1：安装 Claude Code 框架

🍎 Mac · 有魔法

curl -fsSL https://claude.ai/install.sh | bash

🍎 Mac · 无魔法

curl -fsSL https://mirror.cn/claude-install.sh | bash

或使用国内镜像源：

curl -fsSL https://ghproxy.com/https://raw.githubusercontent.com/anthropics/claude-code/main/install.sh | bash

🪟 Windows · 有魔法

推荐用 WSL2：

# 先装 WSL2
wsl --install -d Ubuntu-22.04

# 进入 WSL 后执行
curl -fsSL https://claude.ai/install.sh | bash

🪟 Windows · 无魔法

# 进入 WSL 后执行
curl -fsSL https://mirror.cn/claude-install.sh | bash

Step 2：跳过强制登录

找到配置文件 %USERPROFILE%\.claude.json（Windows）或 ~/.claude.json（Mac/Linux）。

添加：

{
  "hasCompletedOnboarding": true
}

Step 3：配置国内模型（CC Switch）

安装 CC Switch

CC Switch 是一个让 Claude Code 快速切换模型的工具：

npm install -g cc-switch

配置国产模型

DeepSeek

cc-switch add deepseek \
  --api-key your-deepseek-key \
  --api-base https://api.deepseek.com \
  --model deepseek-chat

通义千问

cc-switch add qwen \
  --api-key your-qwen-key \
  --api-base https://dashscope.aliyuncs.com \
  --model qwen-turbo

智谱 GLM

cc-switch add glm \
  --api-key your-glm-key \
  --api-base https://open.bigmodel.cn \
  --model glm-4

切换模型

# 查看可用模型
cc-switch list

# 切换模型
cc-switch use deepseek

# 验证
claude -p "你好"

Step 4：CLAUDE.md 模板

在项目根目录创建 CLAUDE.md：

# 项目配置

## 技术栈
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL

## 开发规范
- 使用 TypeScript strict 模式
- 组件放在 src/components/
- 样式使用 Tailwind CSS

## 常用命令
- npm run dev    # 启动开发服务器
- npm run build  # 构建生产版本
- npm run test   # 运行测试

全局配置 vs 项目配置

配置类型	文件位置	作用域
全局配置	~/.claude.json	所有项目
项目配置	./CLAUDE.md	当前项目

全局配置示例

{
  "hasCompletedOnboarding": true,
  "model": "deepseek-chat",
  "apiKey": "your-key"
}

常见问题

Q：npm 安装失败？

A： 使用国内镜像或 WSL2。

Q：免登录不生效？

A： 确认 .claude.json 格式正确。

Q：国产模型响应慢？

A： 优先选 DeepSeek，响应速度快。

Q：WSL2 安装失败？

A： 在 BIOS 里开启虚拟化，或使用 Docker 方案。

五分钟安装清单

步骤	命令
1. 安装	curl -fsSL https://mirror.cn/claude-install.sh | bash
2. 免登录	在 ~/.claude.json 添加 hasCompletedOnboarding: true
3. 安装 CC Switch	npm install -g cc-switch
4. 配置模型	cc-switch add deepseek --api-key xxx
5. 切换模型	cc-switch use deepseek
6. 验证	claude -p "你好"

一句话总结

Claude Code 国内安装：框架可以封，但国产模型随便接。

安装命令：

curl -fsSL https://mirror.cn/claude-install.sh | bash

配置国产模型：

npm install -g cc-switch
cc-switch add deepseek --api-key your-key
cc-switch use deepseek