如果你也在找一个能真正"干活"的 AI 编程工具,Claude Code 值得试试。它不是那种弹窗对话框,而是直接跑在终端里的智能编码 Agent,能理解你的代码库、执行命令、处理 Git 流程——全程自然语言交互。这篇文章记录了在 macOS、Linux 和 Windows 上的安装过程,以及如何接入国产模型,省去折腾的时间。 01. 安装
1.1 macOS
macOS 上推荐用 Homebrew 安装,配置好国内源之后不用挂代理,直接在终端执行:
安装完成后运行 claude --version 验证一下,能看到版本号就说明没问题。
1.2 Linux
Linux 上需要先在终端开启代理,不然大概率会遇到下载失败或"不支持该地区"的报错。代理配置如下:
可以用 curl ifconfig.me 验证出口 IP 是否已走代理,确认没问题后执行官方安装脚本:
安装完成终端会出现 ✅ Installation complete! 的提示。
1.3 Windows
Windows 上安装之前有个很容易忽略的前置条件——必须先安装 Git for Windows,不装的话安装脚本会直接报错。从 git-scm.com 下载安装完之后,打开 PowerShell 执行:
安装完记得重开一个终端窗口,让 PATH 刷新生效,然后 claude --version 验证下。
02. 启动和配置
2.1 跳过登录
安装完直接运行 claude,会弹出登录页,但里面提供的几个选项在国内基本都用不了。有个简单的办法——手动改一下配置文件跳过这步:
- macOS / Linux:
~/.claude.json
- Windows:
C:\Users\%USERNAME%\.claude.json
如果你也在找一个能真正"干活"的AI编程工具,Claude Code值得试试。它不是那种弹窗对话框,而是直接跑在终端里的智能编码Agent,能理解你的代码库、执行命令、处理Git流程——全程自然语言交互。这篇文章记录了在macOS、Linux和Windows上的安装过程,以及如何接入国产模型,省去折腾的时间。
01.安装
1.1 macOS
macOS上推荐用Homebrew安装,配置好国内源之后不用挂代理,直接在终端执行:
安装完成后运行claude--version验证一下,能看到版本号就说明没问题。
1.2 Linux
Linux上需要先在终端开启代理,不然大概率会遇到下载失败或"不支持该地区"的报错。代理配置如下:
可以用curl ifconfig.me验证出口IP是否已走代理,确认没问题后执行官方安装脚本:
安装完成终端会出现✅Installation complete!的提示。
1.3 Windows
Windows上安装之前有个很容易忽略的前置条件——必须先安装Git for Windows,不装的话安装脚本会直接报错。从git-scm.com下载安装完之后,打开PowerShell执行:
安装完记得重开一个终端窗口,让PATH刷新生效,然后claude--version验证下。
02.启动和配置
2.1跳过登录
安装完直接运行claude,会弹出登录页,但里面提供的几个选项在国内基本都用不了。有个简单的办法——手动改一下配置文件跳过这步:
-macOS/Linux:~/.claude.json
-Windows:C:Users%USERNAME%.claude.json
在文件里加一行:
保存之后再启动就不会卡在登录页了。
2.2接入国产模型
跳过登录之后,就可以配置国内的模型来驱动Claude Code了。以阿里云百炼平台为例(新注册有免费额度可以先薅一薅),在终端里设置以下环境变量:
配置好了之后,新建一个项目文件夹,进去执行claude,输入/model就能看到当前用的是哪个模型。
如果不想每次都手动export,macOS和Windows上可以装CC Switch来图形化管理这些配置;Linux服务器上则可以用CC Router做命令行的API管理。
03.用起来是什么感觉
相比普通的Chat窗口,Claude Code最不一样的地方在于它不只是"回答你"——它能直接操作文件、跑命令、验证结果,一直到把事情做完为止。把一个问题的背景和目标交代清楚,剩下的可以放手让它跑,遇到问题它会自己调整方向,断断续续跑下来往往就把活儿干完了。
对于想在国内低门槛试用Claude Code的人来说,接入阿里云或其他国产模型服务是个不错的切入点——安装配置并不复杂,上手成本比想象中低不少。
>注:文中Homebrew安装命令、Windows安装前置步骤等,均依据2026年3月官方文档更新。npm方式已被官方标记为不推荐,建议使用原生安装脚本。
保存之后再启动就不会卡在登录页了。
2.2 接入国产模型
跳过登录之后,就可以配置国内的模型来驱动 Claude Code 了。以阿里云百炼平台为例(新注册有免费额度可以先薅一薅),在终端里设置以下环境变量:
配置好了之后,新建一个项目文件夹,进去执行 claude,输入 /model 就能看到当前用的是哪个模型。
如果不想每次都手动 export,macOS 和 Windows 上可以装 CC Switch 来图形化管理这些配置;Linux 服务器上则可以用 CC Router 做命令行的 API 管理。
03. 用起来是什么感觉
相比普通的 Chat 窗口,Claude Code 最不一样的地方在于它不只是"回答你"——它能直接操作文件、跑命令、验证结果,一直到把事情做完为止。把一个问题的背景和目标交代清楚,剩下的可以放手让它跑,遇到问题它会自己调整方向,断断续续跑下来往往就把活儿干完了。
对于想在国内低门槛试用 Claude Code 的人来说,接入阿里云或其他国产模型服务是个不错的切入点——安装配置并不复杂,上手成本比想象中低不少。
注:文中Homebrew安装命令、Windows安装前置步骤等,均依据2026年3月官方文档更新。npm方式已被官方标记为不推荐,建议使用原生安装脚本。