零基础学AI编程之一 Claude Code安装保姆级教程
2026/5/1 3:39:26 网站建设 项目流程

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 快 → 没法测,一个个试

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

配置步骤如下:

  1. 第一步:编辑或新增 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>"

}

}

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

注意:

不同系统配置文件路径不同,具体如下:

MacOS & Linux:~/.claude.json。

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

{

"hasCompletedOnboarding": true

}

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

一句话:CC Switch = Claude Code 的「网络设置面板」,把手动改 JSON 的事变成图形界面操作。

2、Windows 安装步骤(全程国内网络)

第一步:下载 CC Switch

CC Switch安装包在置顶的资源,下载即可

https://github.com/farion1231/cc-switch/releases

第二步:安装

如果电脑阻止,你要点击仍要运行

双击.msi→ 一路 Next → 安装完成。

第三步:启动

双击桌面快捷方式或开始菜单里的 CC Switch。

设置里——勾选跳过claude code 初次安装确认

这时候再打开powershell,输入:claude,就可以启动了

这是安全验证,然后选择1或者esc跳过都行

但是,现在没有登陆,也没有账号,所以还是用不了

三、添加 魔芋AI 供应商使用最新的大模型

官网:https://www.moyu.info/

1、获取API的key

先注册、登陆、充值

然后再左侧——令牌管理——添加令牌——输入名称——选择分组(倍率越高的分组线路速度越快,线路越稳定,推荐选择max,以获取最流畅的编码体验)——提交——复制备用

2、获取模型的3大要素

  1. 获取Baseurl、API的key、model的ID

(如何找):API文档或者网页介绍

http://101.200.167.88:8001/

model_ID可以在这里获取

3、在cc swith中添加api的渠道模型

右上角的+号

记住这里一定要开始完整url,然后再粘贴访问地址

点开高级选项,可以点击拉取模型,或者复制模型id到模型映射中

点击保存

点击这个按钮进行测试

4.启动 Claude Code

powershell

复制

claude

完事,CC Switch 自动帮你把配置写好了。

5.总结

CC Switch 不是必须的,但强烈推荐。 特别是你后面如果要在多个 API 商之间切换(比如 魔芋AI、其他中转),用 CC Switch 会方便很多。

最后

Claude Code,就是当前AI版本的毕业工具。

你根本无需使用各种乱七八糟的那些Agent,用好Claude Code,你就真的能感受到,什么是最牛逼的Agent了。

做出这个时代,属于你自己的作品。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询