在官方推出原生安装的之前,安装CC需安装node.js 和 npm,并且这种安装方式不会自动更新最新版本,手动更新老是莫名其妙就改错了。 于是我卸载了之前安装的版本,重新走了一遍原生安装CC的流程
如果之前已通过 npm 安装过 Claude Code,可以在终端运行以下命令切换到原生版本:
claude install
原生安装
原生需要国内用户需提前开启魔法,并设置为全局模式 / TUN 模式,在安装过程中全程保持开启。
Mac 打开终端:Command + 空格 → 输入 terminal → 回车
window打开powershell:Win + R →输入powershell→ 回车
然后安装下面的语句 ,这里一定要留意安装路径(后面要改其配置文件)
Windows(在 PowerShell 中运行):
irm https://claude.ai/install.ps1 | iex
Mac(在 Terminal 中运行):
curl -fsSL https://claude.ai/install.sh | bash
这句话什么意思呢,以 Windows 命令为例:
| | |
|---|
irm | Invoke-RestMethod | |
| | | |
iex | Invoke-Expression | |
整体意思:从 Anthropic 官网下载安装脚本,并立即执行它。由于脚本中包含大量海外地址的下载请求,安装过程约需 3 分钟,节点延迟高时可能更久,请耐心等待。
如果运行后不确定是否在下载,可以打开系统的进程管理工具查看终端是否有下载:
- Windows:打开
任务管理器(Ctrl + Shift + Esc)→ 查看"进程"标签 - Mac:打开
活动监视器(Command + 空格 搜索"活动监视器")→ 查看网络或 CPU 活动
如果拥有trae/cursor等AI-ide工具,那么可以把以下提示词发给agent
帮我自动检查环境并通过原生方式安装 Claude Code,按以下步骤执行:第一步:网络环境提醒在安装前,请提示我:> ⚠️ 国内用户需提前开启代理工具,并设置为**全局模式**或 **TUN 模式**,在整个安装过程中全程保持开启,否则安装可能失败等待我确认后再执行下一步。**第二步:前期检查**检测我的操作系统类型(Mac / Linux / Windows)。运行 `claude --version` 检查是否已安装。- 如果已安装:显示当前版本号,询问我是通过 npm 安装还是原生安装的。 - 如果是 npm 安装:执行 `claude install` 切换到原生版本,并结束后续步骤。 - 如果已是原生安装:提示我 "Claude Code 已是原生安装版本,直接输入 `claude` 即可使用",并结束所有后续步骤。- 如果未安装:继续执行下一步。**第三步:执行原生安装命令**根据检测到的系统,自动执行对应命令:- Mac / Linux:curl -fsSL https://claude.ai/install.sh | bash- Windows:irm https://claude.ai/install.ps1 | iex 安装过程完成后,记录并告知我实际的安装路径(后续修改配置文件会用到)。第四步:验证安装执行 `claude --version` 确认安装结果。- 如果成功:提示我直接输入 `claude` 即可启动工具并开始登录流程。- 如果失败:提示我检查代理是否全程开启,并重新执行第三步。
npm安装(不推荐)
运行以下命令,确认 Node.js 和 npm 已安装:
node --versionnpm --version
如果提示 command not found,说明尚未安装,可以让 AI 指导你完成安装。
第二步:安装 Claude Code
标准安装(需要访问国外服务器):
npm install -g @anthropic-ai/claude-code
使用淘宝镜像安装(国内推荐,速度更快):
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com
这句话什么意思呢,以 Windows 命令为例:
| |
|---|
npm install | |
-g | 全局安装,整台电脑都能使用(而不只是某个项目文件夹) |
@anthropic-ai/claude-code | |
--registry=... | |
Node.js 是让 JavaScript 能在本地电脑上运行的环境。
JavaScript 原本只能在浏览器里执行,Node.js 的出现让它突破了这个限制,在本地运行——它是 JS 的"后端运行环境",Claude Code(npm 版本)正是依赖它才能在你的电脑上跑起来。
npm(Node Package Manager) 是 Node.js 的标配包管理器,就像一个拥有数百万工具的"应用商店"。只需一行命令,就能下载并使用别人写好的工具包,无需重复造轮子。
验证安装成功
claude --version
正常输出版本号即代表安装成功。
登录与授权
安装完成后,在终端输入 claude,程序会自动引导你完成配置 和 登录授权流程。这里需要换成国内模型并且跳过这个登陆(用claude原装容易封号)
可以将 Claude Code 的基座模型 配置为使用国内模型的coding-plan计划。
截止 2026.03,表现较好的国内模型:MiniMax2.5、GLM-5、Kimik2.5
配置方法:编辑下载cloudecode路径的 ~/.claude/settings.json,按照各家模型的 API 文档填入 baseURL 和 apiKey,不确定怎么改可以把settings文件内容粘贴给 AI,让它按照各个厂商的配置文件帮你修改(参考:Kimi Coding Plan 接入文档[1])。
{"autoUpdatesChannel":"latest","env":{"ANTHROPIC_BASE_URL":"https://api.kimi.com/coding/","ANTHROPIC_AUTH_TOKEN":"api-key","ANTHROPIC_API_KEY":""}}
引用链接
[1]Kimi Coding Plan 接入文档: https://claude.ai/chat/1e6f7885-4d3e-4f1d-9732-f3388fe29170#