Claude code安装（击破Anthropic官方封锁）

安装依赖 (part1)

Claude Code 是基于 Node.js 运行的，因此你必须先安装 Node.js。

1. 下载 Node.js：

   • 访问 Node.js 官网(https://nodejs.org/zh-cn/download)。

   • 下载 LTS 版本（长期支持版，目前通常是 v20 或 v22）。

   • 默认配置，一路点击 "Next" 安装即可。

1. 添加path环境变量

1. 验证安装：

   • 打开你的终端（Windows 下用 CMD 或 PowerShell，Mac/Linux 用 Terminal）。

   • 输入 node -v，如果出现类似 v20.x.x 的版本号，说明环境准备好了。

安装Claude code (part2)

1. 执行安装命令

在终端中输入以下命令（使用国内镜像源，下载速度更快）：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

卸载命令：

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

1. 安装后验证版本

claude --version

1. 启动claude

创建测试目录，用命令行窗口进入目录执行

报bun的错

不用理会，再启动一次即可。此时会有Anthropic官方封锁限制，报错下截图：

1. 添加配置解除封锁

编辑用户目录下的.claude.json，比如

路径：C:\Users\FZLX-0003\.claude.json

添加一行配置：

"hasCompletedOnboarding": true,

简单说：hasCompletedOnboarding 就是一个 “是否完成新手引导” 的开关，在国内环境非常关键。为false每次启动都会进入官方新手引导：要你登录 Anthropic 账号、选地区、同意条款、联网验证。为true时直接跳过这一步。

1. 重启终端，再次运行claude

说明已安装Claude code成功 (中国大陆IP用户，可以顺畅使用Claude Code)

配置模型和APIKey (part3)

cc‑switch（全称 Claude Code Switch）是一个开源、跨平台的桌面小工具，核心就是：给 Claude Code 一键换大模型、换 API 提供商，不用手改 JSON 配置。

简单讲：它是 Claude Code 的 “模型 / 账号切换器 + 配置管家”，特别适合国内环境用 Claude Code 接国产模型或中转 API。

1. 下载和安装cc-switch

github地址：https://github.com/farion1231/cc-switch/releases

滚动页面可找到下载入口，下载CC-Switch-v3.10.2-Windows.msi

1. 通过cc-switch设置AI IDE 和 LLM

首先，选择AI编程IDE，这边选择Claude. 目前支持（Claude、Codex、Gemini、OpenCode）

接下来，为AI IDE，设置LLM大模型。

• 这边举例，选择智普大模型（GLM-4.7)，也可其他或自定义

• 

• 填写API Key（需提前在智普官网付费开通）

• 添加后界面变化如下

1. 测试claude是否配置成功

再次重启终端，在测试目录运行claude

如果有询问是否继续，选择Yes。

 成功配置的界面如下

Claude Code的基本使用 (part4)

常见工作流程：https://code.claude.com/docs/zh-CN/common-workflows

把这个文档看完，就可以把claude code的基本用法使用起来了