Claude Code 是 Anthropic 官方推出的 AI 编程助手命令行工具，可以在 MacOS 系统上直接安装使用。本文将详细介绍在 MacOS 上安装和配置 Claude Code 的完整流程。

1. 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。MacOS 上有多种安装 Node.js 的方式：

方式一：官方安装包（推荐）

1. 打开浏览器访问 https://nodejs.org

2. 下载 macOS 版本的安装包 (.pkg)

3. 运行下载的安装包，按照向导完成安装

4. 打开终端（Terminal）验证安装：

node --version
npm --version

如果显示版本号，说明安装成功。

方式二：使用 Homebrew

如果你已经安装了 Homebrew：

brew installnode

2. 安装 Claude Code

目前国内使用 Claude Code 一般有两种方式：

• 镜像 Claude Code + 订阅方式：比官方账户模式省60%以上，适合使用强度高的用户

• 官方原版 + API 方式：比官方API模式省50%以上

这里两种方式都做介绍，有条件推荐直接使用原版。

方式一：镜像 Claude Code + 订阅

npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

-g 表示全局安装，可在任意目录调用 claude

如果已经安装过原版的，可执行如下命令卸载：

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

rm -rf ~/.claude*

安装成功后启动 Claude Code：

# 进入项目目录
cd your-project-folder

# 启动 Claude Code
claude

浏览器登录并绑定账户：
注意：一定要用邀请链接注册的才有购买月卡的1万积分赠送，邀请链接：https://gaccode.com/signup?ref=OGKQ807E ；然后复制窗口中的https地址进行绑定

购买兑换码（含体验卡）地址：https://sc.i6ls.com//links/715B86E6
或联系客服：apiqik001

升级 Claude Code 命令：

npm install -g https://gaccode.com/claudecode/install --registry=https://registry.npmmirror.com

方式二：官方原版 + API

这里的 API 使用 https://api.apiqik.com 的服务，价格相对便宜。注册后创建令牌，选择 claude-code 分组。目前只支持 claude-code 分组使用 claude code。
有问题联系客服：apiqik001

安装官方 Claude Code

在终端中执行：

# 全局安装官方 Claude Code

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

安装完成后验证：

claude --version

如果显示版本号，说明 Claude Code 已经安装成功。

配置环境变量（重要）

MacOS 上配置环境变量有多种方式：

方式一：使用 .bash_profile 或 .zshrc（推荐）

如果你使用的是 bash（较老的 macOS 版本）：

echo 'export ANTHROPIC_BASE_URL="https://api.apiqik.com"' >> ~/.bash_profile

echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-token-here"' >> ~/.bash_profile

# 可选

echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514"' >> ~/.bash_profile

echo 'export ANTHROPIC_SMALL_FAST_MODEL="claude-3-5-haiku-20241022"' >> ~/.bash_profile

source ~/.bash_profile

如果你使用的是 zsh（macOS Catalina 及以后版本默认）：

echo 'export ANTHROPIC_BASE_URL="https://api.apiqik.com"' >> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN="sk-your-token-here"' >> ~/.zshrc

# 可选

echo 'export ANTHROPIC_MODEL="claude-sonnet-4-20250514"' >> ~/.zshrc

echo 'export ANTHROPIC_SMALL_FAST_MODEL="claude-3-5-haiku-20241022"' >> ~/.zshrc

source ~/.zshrc

方式二：手动编辑配置文件

使用文本编辑器打开配置文件：

# 对于 zsh 用户

open -e ~/.zshrc



# 对于 bash 用户

open -e ~/.bash_profile

在文件末尾添加：

export ANTHROPIC_BASE_URL="https://api.apiqik.com"

export ANTHROPIC_AUTH_TOKEN="sk-your-token-here"

# 可选

export ANTHROPIC_MODEL="claude-sonnet-4-20250514"

export ANTHROPIC_SMALL_FAST_MODEL="claude-3-5-haiku-20241022"

保存文件后重新加载配置：

# 对于 zsh
source ~/.zshrc

# 对于 bash
source ~/.bash_profile

验证环境变量配置

在终端中验证环境变量是否配置成功：

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_MODEL
echo $ANTHROPIC_SMALL_FAST_MODEL

预期结果：

https://api.apiqik.com
sk-your-token-here
claude-sonnet-4-20250514
claude-3-5-haiku-20241022

4. 开始使用 Claude Code

配置完成后，就可以开始使用 Claude Code 了：

# 进入项目目录
cd your-project-folder

# 启动 Claude Code
claude

第一次运行时，Claude Code 会在浏览器中打开，需要进行身份验证和授权。

5. 常见问题及解决方案

问题1：命令找不到

如果提示 command not found: claude，说明全局安装可能有问题，可以尝试：

# 重新安装

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



# 检查 npm 全局安装路径

npm config get prefix

问题2：权限问题

如果遇到权限错误，可以尝试：

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

问题3：环境变量不生效

确保在正确的 shell 配置文件中设置了环境变量，并且重新启动了终端或重新加载了配置文件。

问题4：网络连接问题

如果在中国大陆地区遇到网络问题，可以使用镜像安装：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

现在你已经成功在 MacOS 上安装并配置了 Claude Code，可以开始享受 AI 编程助手

AI大模型学习路线

如果你对AI大模型入门感兴趣，那么你需要的话可以点击这里大模型重磅福利：入门进阶全套104G学习资源包免费分享！

这份完整版的大模型 AI 学习和面试资料已经上传CSDN，朋友们如果需要可以微信扫描下方CSDN官方认证二维码免费领取【保证100%免费】

这是一份大模型从零基础到进阶的学习路线大纲全览，小伙伴们记得点个收藏！

第一阶段： 从大模型系统设计入手，讲解大模型的主要方法；

第二阶段： 在通过大模型提示词工程从Prompts角度入手更好发挥模型的作用；

第三阶段： 大模型平台应用开发借助阿里云PAI平台构建电商领域虚拟试衣系统；

第四阶段： 大模型知识库应用开发以LangChain框架为例，构建物流行业咨询智能问答系统；

第五阶段： 大模型微调开发借助以大健康、新零售、新媒体领域构建适合当前领域大模型；

第六阶段： 以SD多模态大模型为主，搭建了文生图小程序案例；

第七阶段： 以大模型平台应用与开发为主，通过星火大模型，文心大模型等成熟大模型构建大模型行业应用。

100套AI大模型商业化落地方案

大模型全套视频教程

200本大模型PDF书籍

👉学会后的收获：👈

• 基于大模型全栈工程实现（前端、后端、产品经理、设计、数据分析等），通过这门课可获得不同能力；

• 能够利用大模型解决相关实际项目需求： 大数据时代，越来越多的企业和机构需要处理海量数据，利用大模型技术可以更好地处理这些数据，提高数据分析和决策的准确性。因此，掌握大模型应用开发技能，可以让程序员更好地应对实际项目需求；

• 基于大模型和企业数据AI应用开发，实现大模型理论、掌握GPU算力、硬件、LangChain开发框架和项目实战技能， 学会Fine-tuning垂直训练大模型（数据准备、数据蒸馏、大模型部署）一站式掌握；

• 能够完成时下热门大模型垂直领域模型训练能力，提高程序员的编码能力： 大模型应用开发需要掌握机器学习算法、深度学习框架等技术，这些技术的掌握可以提高程序员的编码能力和分析能力，让程序员更加熟练地编写高质量的代码。

LLM面试题合集

大模型产品经理资源合集

大模型项目实战合集

👉获取方式：
😝有需要的小伙伴，可以保存图片到wx扫描二v码免费领取【保证100%免费】🆓