Claude Code Mac 版安装与配置指南

Claude Code Mac 版安装与配置指南

Claude Code 是基于 Anthropic Claude 模型的高级代码理解与生成组件，旨在帮助开发者快速完成代码撰写、调试和优化。Claude Code 依托大语言模型的深度推理能力，不仅能理解复杂的代码上下文，还能进行多轮交互式编程。

Claude Code 自 2025 年 2 月发布以来逐步从工具进化为「智能代理」。核心优势在于深度上下文理解、多语言支持和宪法式 AI 安全机制，能显著提升开发效率并降低学习门槛。虽然名为 Code，但其功能是一款真正意义上的通用 Agent。

环境准备：Node.js

安装前提：需安装 Node.js（版本 >= 18，当前稳定版本是 24），安装时需管理员权限。

1. 访问 https://nodejs.org/en/download
2. 选择正确的芯片架构：
   • ARM64（M1/M2/M3 芯片的 Mac）
   • x64（Intel 芯片的 Mac）
3. 下载后点击安装包进行安装
4. 安装完成后，打开终端验证：

node --version
npm --version

建议使用 Node 版本管理工具（如 nvm 或 n）进行安装，详见文末对比。

安装 Claude Code

安装时需要管理员权限。

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

国内 npm 镜像可选：

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

安装完成后校验：

claude -v

配置大模型

使用 CCSwitch 配置

CCSwitch 是一个可视化的 Claude Code 配置管理工具，支持管理多个 API 节点、一键切换供应商及测试连接状态。

1. 下载 CCSwitch

下载地址：https://github.com/farion1231/cc-switch/releases/tag/v3.10.3

2. 配置 API Key

安装成功后，打开 CCSwitch 界面管理 API 接口和 Key。以下以智普大模型（GLM 4.6）为例：

1. 购买大模型用量套餐：https://bigmodel.cn/usercenter/glm-coding/overview
2. 创建 API Key：https://bigmodel.cn/usercenter/proj-mgmt/apikeys

配置国产模型（GLM 4.6）到 CCSwitch： a) 点击「添加新的供应商」→「Zhipu GLM」 b) 填写信息：

• 供应商名称：自动填充
• Base URL：自动填充
• API Token：填入你的 API Key
• 其他配置清空 c) 点击「保存」 d) 点击「启用」 e) 点击「测试」按钮，显示连接正常即可

3. 手动配置检查

参考智普大模型文档：https://docs.bigmodel.cn/cn/guide/develop/claude

settings 文件 路径：~/.claude/settings.json (MacOS & Linux)

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

其中 your_zhipu_api_key 替换为你生成的 API Key。

claude.json 文件 路径：~/.claude.json (MacOS & Linux)

{
  "hasCompletedOnboarding": true
}

配置成功后，请重新打开一个新的终端窗口以使环境配置生效。

开始使用

配置完成后，进入工作目录，在终端中执行 claude 命令。

若遇到「Do you want to use this API key」提示，选择 Yes。 启动后选择信任 Claude Code 访问文件夹里的文件。

进入前 Claude Code 会确认使用目录地址，确认地址后回车。

现在就可以正常使用 Claude Code 进行开发了。

大模型 API Key 配置地址

• 智普：https://bigmodel.cn/usercenter/proj-mgmt/apikeys
• Deepseek：https://platform.deepseek.com/api_keys
• Kimi：https://platform.moonshot.cn/console/api-keys

Node 版本管理工具对比

使用场景	推荐
新手 / 简单	n
最通用	nvm
极致速度	fnm
团队 / 锁版本	Volta
多语言统一管理	asdf / mise

1. n

• 语言：Node.js
• 安装：npm i -g n
• 优点：极其简单、轻量，适合快速切换版本
• 缺点：需要 sudo，不太适合多项目并行
• 适合：个人开发、快速切版本

n latest
n lts
n 18.20.4

2. nvm (Node Version Manager)

• 特点：最经典、最常用
• 优点：支持 .nvmrc，每个项目可用不同 Node 版本，社区成熟
• 缺点：Windows 需用 nvm-windows，shell 启动略慢
• 适合：大多数开发者

nvm install 20
nvm use 20