一、什么是Claude Code？

Claude Code 是 Anthropic 推出的终端 AI 编程助手，可在命令行内完成代码生成、脚本编写等开发工作，也可以用于日常资料批处理分析等，深度赋能本地办公提效。

由于官方原生服务在中国大陆存在网络与地域访问限制，本篇教程带你全程使用国产大模型，零特殊网络环境即可正常使用。

二、安装前准备

1. 设备要求：macOS 10.15 及以上版本苹果电脑

2. 资源准备：备好第三方大模型转发 API Key（本文演示：阿里云百炼）

3. 网络说明：全程采用国内镜像源适配，无需境外代理

三、安装步骤

整套部署仅4个核心步骤，通俗易懂，新手也能一键复刻：

1. 部署运行环境 Node.js（相当于给终端配置程序翻译解析引擎）

2. 全局安装 Claude Code 客户端

3. 安装 CC-Switch 管理工具，接入国产大模型

4. 初始化基础配置，终端启动交互

步骤1：安装依赖环境 Node.js

1.1 安装 Mac 神器 Homebrew

Homebrew 是 macOS 专用软件包管理器，一键通过终端管理各类开发工具，简化安装、卸载、升级操作。

1. 打开电脑终端，复制执行国内加速安装脚本：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

1. 脚本运行弹出中文菜单，输入数字 1 选择清华大学镜像源，回车

2. 根据界面指引输入电脑开机密码，等待自动部署完成

终端输入验证是否安装成功：

brew -v

1.2 通过 Homebrew 安装 Node.js

Node.js 是 Claude Code 必备运行基座

1. 终端执行安装命令：

brew install node

1. 安装完成后验证安装是否成功：

node -vnpm -v

步骤2：安装 Claude Code

1. 终端执行一句话安装指令：

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

1. 校验安装结果：正常展示版本号，代表客户端安装完成。

claude --version

步骤3：本土化大模型配置（核心关键）

Claude Code 官方原生模型国内不好直连，我们替换为国产主流大模型：通义千问3.5、Kimi 2.5、GLM5等。

借助 CC-Switch 可视化工具，一键管理、切换模型与API配置：

1. 这里找个开源仓库地址：https://github.com/farion1231/cc-switch

   

2. 页面下拉，找到 macOS 对应安装包，下载并本地安装

   

3. 打开 CC-Switch，选择已采购/开通的模型厂商（本文以阿里云百炼为例）

   

填入你的专属 API Key（从你选购的阿里云百炼粘贴过来），保存配置，完成模型绑定。

步骤4：启动 Claude Code 终端交互

1. 查看 Claude Code 本地安装路径

which claude

1. 一键启动客户端（适配国内SSL兼容方案）

claude

1. 首次启动按照系统默认推荐配置确认，进入主交互界面

   

2. 输入自然语言指令，即可实现代码开发、问题问答、项目处理等全场景交互

踩坑点：SSL证书报错/服务商连接失败

CC-Switch 内置独立SSL校验逻辑，无法通过图形界面关闭拦截。

解法：后面通过命令强制关闭SSL认证就好了

export NODE_TLS_REJECT_UNAUTHORIZED=0 && claude

以上就是 macOS 环境下，Claude Code 国内无门槛完整安装配置教程。不同设备、网络环境会出现个性化小报错，无需自查排查，直接复制报错日志发给AI问答工具，即可快速定位解决，省时高效。

下期更新：Claude Code 日常使用教程，带你解放编程生产力！到这里觉得满意的话来个点赞收藏吧老铁～