Claude Code 本地教程

macOS 教程

本教程将指导你在 macOS 系统上安装和配置 Claude Code。

1. 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

版本要求

Claude Code 要求的 Node.js 版本 ≥ 18.0，最好使用 v20 或更高版本。

macOS 安装方法

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

bash
# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二：官网下载

  1. 访问 https://nodejs.org/
  2. 下载适合 macOS 的 LTS 版本
  3. 打开下载的 .pkg 文件
  4. 按照安装程序指引完成安装

macOS 注意事项

  • 如果遇到权限问题，可能需要使用 sudo
  • 首次运行可能需要在系统偏好设置中允许
  • 建议使用 Terminal 或 iTerm2

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

bash
node --version
npm --version

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

2. 安装 Claude Code

安装 Claude Code

打开 Terminal，运行以下命令：

bash
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

如果遇到权限问题，可以使用 sudo：

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

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

bash
claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

3. 设置环境变量

配置 Claude Code 环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

方法一：临时设置（当前会话）

在 Terminal 中运行以下命令：

bash
export ANTHROPIC_BASE_URL="你的apiUrl"  (你的apiUrl:导航栏->我的->账户信息概览->Claude Code 配置)
export ANTHROPIC_AUTH_TOKEN="你的API密钥" (你的API密钥:导航栏->我的->账户信息概览->Claude Code 配置)

注意

记得将 "你的API密钥" 替换为在 "API Keys" 标签页中创建的实际密钥。

方法二：永久设置

编辑你的 shell 配置文件（根据你使用的 shell）：

对于 zsh（macOS 默认）：

bash
echo 'export ANTHROPIC_BASE_URL="你的apiUrl"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

对于 bash：

bash
echo 'export ANTHROPIC_BASE_URL="你的apiUrl"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

提示

设置后环境变量会在新打开的终端窗口中自动生效。

4. 开始使用 Claude Code

现在你可以开始使用 Claude Code 了！

启动 Claude Code

在 Terminal 中直接运行：

bash
claude

在特定项目中使用

bash
# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

提示

  • 确保已经设置好环境变量后再启动 Claude Code
  • 如果使用永久设置，记得重新打开终端窗口或执行 source ~/.zshrc（或 source ~/.bash_profile）
  • 首次启动可能需要一些时间来初始化

下一步

现在你已经完成了 Claude Code 的安装和配置，可以开始使用了！如果遇到问题，请查看常见问题。

5. CC-Switch 图形化管理工具（可选）

CC-Switch 是一款跨平台桌面工具，为 Claude Code、Codex、OpenCode、Gemini CLI 等 AI 命令行工具提供图形化管理界面，让配置更简单直观。

主要功能

  • Provider 管理：可视化添加和切换多个 AI 服务商，支持预设和自定义配置
  • 本地 API 代理：支持按应用接管、自动故障切换，一个 Provider 配置同步到 Claude Code / Codex / Gemini
  • Prompt 管理：Markdown 编辑器创建系统提示词预设，实时预览，一键激活
  • Skills 管理：自动扫描 GitHub 仓库的 Skills，一键安装/卸载
  • 环境变量冲突检测：自动检测 Claude、Codex、Gemini 之间的配置冲突

下载安装

从 GitHub Releases 下载 macOS 版本：

  • 下载 .zip 文件（支持 Intel 和 Apple Silicon，M 系列芯片通过 Rosetta 2 运行）
  • 解压后将应用拖入 Applications 文件夹

Homebrew 安装

也可以通过 Homebrew 安装，具体命令请参考 GitHub 仓库说明。

快速使用

  1. 安装并打开 CC-Switch
  2. 在 Provider 页面添加你的中转 API 地址和密钥
  3. 选择要接管的应用（如 Claude Code），一键应用配置
  4. 无需手动设置环境变量，CC-Switch 会自动管理