为什么选择 Claude Code？
Claude Code 是 Anthropic 推出的命令行 AI 编程助手， 可以直接在终端中理解整个代码库、执行复杂编辑、操作 Git 工作流。
但境内用户面临两个核心障碍：
- 登录验证：首次运行需要 Anthropic 账号登录
- API 访问：Anthropic API 在国内无法直接调用
本文提供一套完整的解决方案——绕过登录 + 切换国产模型，让 Claude Code 在国内可用。
环境准备
操作系统
| 系统 | 版本要求 |
|---|---|
| macOS | 13.x (Ventura) 及以上 |
| Windows | 10 / 11（推荐搭配 WSL2） |
| Linux | Ubuntu 20.04+ / Debian 11+ / Fedora 38+ |
硬件要求
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 内存 | 8 GB | 16 GB+ |
| 存储 | 2 GB 可用空间 | — |
| 网络 | 稳定的互联网连接（用于 API 调用） | — |
软件依赖
- Node.js 18.x 及以上（Claude Code 的核心运行环境）
node --version # 建议 v20 LTS - Git 2.x 及以上
git --version # 用于代码管理和版本控制 - npm / yarn / pnpm（任选其一）
安装步骤
第一步：安装基础环境
确保 Node.js 和 Git 已正确安装。
Windows 用户需要特别注意：
- 从 nodejs.org 下载并安装 Node.js
- 从 git-scm.com 下载并安装 Git
- 安装时勾选「添加到 PATH」
第二步：安装 Claude Code
npm install -g @anthropic-ai/claude-code
安装完成后，终端中即可使用 claude 命令。
第三步：绕过登录验证
在生产环境中，Claude Code 首次运行会要求通过 Anthropic 官方账号登录。 我们可以通过编辑配置文件跳过这一步骤。
编辑或新建 ~/.claude.json（Windows 路径：C:\Users\<用户名>\.claude.json），
将 hasCompletedOnboarding 设为 true：
{
"hasCompletedOnboarding": true
}
关键操作：在
claude.json中添加上述代码，即可跳过 Anthropic 官方登录验证。
安装 cc-switch
cc-switch 是一个开源工具， 用于为 Claude Code 切换不同的 AI 模型提供商，支持 DeepSeek、Qwen、GLM 等国产大模型。
Windows 安装
从 GitHub Releases 下载：
.msi安装包（推荐）—— 自动配置环境变量-Portable.zip便携版（免安装）—— 解压即用
macOS 安装
# 通过 Homebrew 安装
brew install --cask cc-switch
# 更新到最新版本
brew upgrade --cask cc-switch
# 或从 GitHub Releases 下载 .dmg 手动安装
配置国产大模型
打开 VS Code，安装 Claude Code 扩展后，cc-switch 会直接接管终端中的 claude 命令。
也可以直接使用终端配置：
-
添加提供商：打开 CC Switch → 点击 "Add Provider" → 选择预设（如 DeepSeek、Qwen、GLM 等） 或创建自定义配置 → 填入 API Key
-
启用提供商：在主界面选择目标提供商 → 点击 "Enable"， 或直接从系统托盘右键切换
-
启动 Claude Code：打开终端 →
cd your-project claude无需额外配置，CC Switch 已自动接管
-
切换模型：在 CC Switch 中切换到另一个提供商，Claude Code 立即生效（无需重启终端）
使用演示
配置完成后，在任意项目中运行 claude 即可进入交互式编程助手：
常见问题
Q: cc-switch 支持哪些模型？
目前支持 DeepSeek（V3/R1）、Qwen（通义千问）、GLM（智谱清言）等国产主流大模型， 以及 via VS Code 插件市场中提供的其他兼容模型。
Q: 使用国产模型和官方 Claude 有什么区别？
主要区别在于底层模型能力。Claude 官方模型在代码理解和生成方面表现最优， 但国产模型在日常开发中的表现也足够胜任。建议根据实际任务复杂度选择合适的模型。
Q: 是否需要科学上网？
使用 cc-switch 切换到国产模型后，全程无需科学上网。 API 调用走的是 DeepSeek / Qwen / GLM 等国内服务商的接口。
Q: cc-switch 是否安全？
cc-switch 是开源项目，代码托管在 GitHub 上。API Key 仅存储在本机， 不会上传到任何第三方服务器。建议从官方 GitHub Releases 页面下载，避免使用不明来源的安装包。
总结
通过 Claude Code + cc-switch + 国产大模型 的组合，境内开发者可以 无障碍地享受命令行 AI 编程体验。整套方案的要点：
- 编辑
~/.claude.json绕过登录验证 - 安装 cc-switch 并配置国产模型 API Key
- 终端中直接使用
claude命令，cc-switch 自动接管
这种方案尤其适合：
- 日常代码重构和优化
- 项目文档生成
- 代码审查辅助
- 快速原型开发
工具是手段，效率是目的。选择最适合自己工作流的方案，才是明智之举。