零基础学AI编程之一 Claude Code安装保姆级教程

本文详细介绍了在国内网络环境下安装和使用Claude AI编程工具的完整教程。主要内容包括：1）通过PowerShell安装ClaudeCode的五个步骤；2）配置CCSwitch工具简化API连接设置；3）添加魔芋AI供应商获取API密钥和模型ID。教程特别针对国内网络无法直连官方API的问题提供了解决方案，推荐使用CCSwitch工具管理多个API供应商配置，并强调ClaudeCode是目前最

CCYe、

1046人浏览 · 2026-04-30 14:28:01

CCYe、 · 2026-04-30 14:28:01 发布

Claude 可以在终端运行（国内可用）、网页端（需登陆账号）、桌面端app（需登陆账号）和vscode+插件的方式（国内可用）运行（4种）

如果是有Claude账号的，直接登录就行了，这里我就不细说了。
因为理论上你已经有Claude账号了，你也不会来看这个教程

一、Windows 全程国内网络安装 Claude Code

所有资料打包网盘：「claud-code」链接：https://pan.baidu.com/s/1-ar2k4q1EOnizMJgyNHVQA?pwd=ttfq 提取码: ttfq

前提条件安装node.js（必须）和git

第一步：确认 Node.js 已安装

node.js下载地址：https://nodejs.cn/（推荐长期支持版本）

打开 PowerShell（windows里搜：powershell，命令提示符：cmd也可以，不过推荐用powershell），执行：

powershell
复制

node -v
npm -v

如果没装：

下载后，安装
一路，下一步即可

然后，再打开powershell，注意：关闭原来的窗口，重新打开powershell
有版本号输出即可（你电脑已经有了）。没有的话去 https://nodejs.cn 下载安装。

如果你的node -v有版本号，而npm -v没有版本号

原因：你没有使用管理员权限打开powshell
解决方案：输入命令：

# 以管理员身份运行 PowerShell，执行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 输入 Y 确认

第二步：设置 npm 淘宝镜像

powershell

复制

npm config set registry https://registry.npmmirror.com

验证：

powershell

复制

npm config get registry

应输出https://registry.npmmirror.com

第三步：安装 Claude Code

powershell

复制

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

验证安装：

powershell

复制

claude --version

问题：cloude的启动需要git

第四步：安装git

1、网盘链接：https://pan.quark.cn/s/4622545c862e

2、Git 官方在国内有镜像站，直接下载安装包：

地址：https://registry.npmmirror.com/binary.html?path=git-for-windows/
选择最新版本 → 下载 .exe 安装包 → 双击安装

下载后，一路下一步即可

验证：git -v

第五步：首次启动

打开 PowerShell：输入：claude

恭喜你：你已经通过国内网络安装上了世界上最牛的ai编程工具 Claude code

注意：可以更改默认的项目目录

方式：打开你新建的一个文件夹,比如：D:\0423，在地址栏，输入：powershell

就会在这个目录中工作

这是 Claude Code 直连 Anthropic 官方服务失败，原因是中国大陆网络无法直接访问http://api.anthropic.com

当前状态： Claude Code 已安装成功，但无法连接官方 API，所以暂时不能用

第六步：如果遇到 invalid beta flag 报错（没遇到就算了）

编辑 C:\Users\Administrator\.claude\settings.json，加一行代码：

"DISABLE_ANTHROPIC_BETA": "true"

重启 Claude Code 即可

没遇到就算了，我安装后未遇到。

二、安装ccswith

1、为什么国内用 Claude Code 需要 CC Switch

配置方式	是什么	作用范围	生效时机
ccswitch 设置	ccswitch 工具内部的模型/提供商配置面板	仅 ccswitch 内部	每次发起请求时动态注入
环境变量	操作系统或终端里的 `export` 变量	当前终端会话	进程启动时读取一次
Claude 配置文件	Claude Code CLI 的本地持久化配置（`~/.claude/settings.json`）	全局默认	Claude Code 启动时加载

没有 CC Switch

你需要手动编辑 JSON 配置文件来管理 Claude Code，遇到问题得自己查环境变量：

手改 ~/.claude/settings.json → 改错了 JSON 报错 → 不知道哪里错了 → 搜半天
想换模型 → 再改配置 → 重启
想换 API 商 → 再改配置 → 重启
想测速哪个 API 快 → 没法测，一个个试

如果，非要自己配置，下面是手动修改模型的方式，可以参考：

配置步骤如下：

第一步：编辑或新增 settings.json 文件，需要修改的配置信息如下：

<USER_API_KEY>：替换为您自己的 API Key。

<Model_Name>：更新为需要使用的模型信息，例如 glm-5。

注意：

不同系统配置文件路径不同，具体如下：

MacOS & Linux：~/.claude/settings.json。

Windows：C:\Users\<用户名>\.claude\settings.json。

{

"env": {

"ANTHROPIC_AUTH_TOKEN": "<USER_API_KEY>",

"ANTHROPIC_BASE_URL": "https://api.lkeap.cloud.tencent.com/coding/anthropic",

"ANTHROPIC_MODEL": "<Model_Name>"

}

}

第二步：在配置完 settings.json 文件后，编辑或新增 .claude.json 文件，修改或新增 hasCompletedOnboarding 字段值为 true。

注意：

不同系统配置文件路径不同，具体如下：

MacOS & Linux：~/.claude.json。

Windows：C:\Users\<用户名>\.claude.json。

{

"hasCompletedOnboarding": true

}

保存配置文件后，在新的终端窗口执行后续命令。