Claude Code Mac 使用教程

前置说明

重要提示

  • 使用中转服务时，国内用户请勿使用代理工具
  • 建议使用 /model 命令切换至 Haiku 或 Sonnet 模型以优化成本和性能

概述

本教程将指导您在 macOS 系统上安装和配置 Claude Code 开发工具。

安装步骤

1. 安装 Node.js

访问 Node.js 官方下载页面：https://nodejs.org/en/download

安装要求：

  • 根据您的 Mac 芯片架构（Intel 或 Apple Silicon）选择对应的安装包
  • 确保 Node.js 版本为 18.0 或更高版本

验证安装：

安装完成后，在终端中执行以下命令验证：

bash 
node --version
npm --version

2. 安装 Claude Code

在终端中执行以下命令安装 Claude Code：

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

权限问题处理：

如果安装过程中遇到权限错误，请依次执行以下命令解决：

bash 
npm prefix -g
sudo chown -R $(whoami) $(npm prefix -g)/{lib/node_modules,bin,share}
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

环境配置

配置 API 密钥

根据您获取的 API 密钥和中转服务地址配置环境变量。提供两种配置方式：

方式一：临时配置

适用于临时测试场景，配置仅在当前终端会话中有效。

bash 
export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_API_KEY=您的API密钥
export ANTHROPIC_BASE_URL=https://yyken.com

# 启动 Claude Code（请先关闭代理工具）
claude

注意

此配置方式仅在当前终端窗口有效，关闭终端后需要重新设置。

方式二：永久配置（推荐）

步骤 1：确认 Shell 类型

macOS Catalina (10.15) 及更高版本默认使用 zsh，早期版本使用 bash。执行以下命令查看当前 Shell：

bash 
echo $SHELL
  • 输出 /bin/zsh → 使用 zsh 配置方法
  • 输出 /bin/bash → 使用 bash 配置方法

步骤 2：编辑配置文件

Zsh 用户（推荐）：

bash 
# 编辑配置文件
vim ~/.zshrc

# 在文件末尾添加以下内容（按 i 进入编辑模式）
export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_API_KEY=您的API密钥
export ANTHROPIC_BASE_URL=https://yyken.com

# 按 ESC 退出编辑模式，输入 :wq 保存并退出

# 使配置立即生效
source ~/.zshrc

Bash 用户：

bash 
# 编辑配置文件
vim ~/.bash_profile

# 在文件末尾添加以下内容（按 i 进入编辑模式）
export ANTHROPIC_API_TOKEN=""
export ANTHROPIC_API_KEY=您的API密钥
export ANTHROPIC_BASE_URL=https://yyken.com

# 按 ESC 退出编辑模式，输入 :wq 保存并退出

# 使配置立即生效
source ~/.bash_profile

步骤 3：验证配置

bash 
# 验证环境变量是否设置成功
echo $ANTHROPIC_API_KEY
echo $ANTHROPIC_BASE_URL

# 如果正确显示您设置的值，说明配置成功

步骤 4：启动 Claude Code

bash 
# 请先关闭代理工具
claude

# 如果出现 "Unable to connect to Anthropic services" 错误
# 请继续执行下一节的认证配置

提示

  • 永久配置后，每次打开新终端窗口都会自动加载环境变量
  • 如需修改配置，重新编辑对应的配置文件即可
  • 修改后需执行 source ~/.zshrc 或 source ~/.bash_profile 使配置生效

配置认证绕过

如果启动时出现认证错误，需要配置跳过 Anthropic 服务认证。

操作步骤：

  1. 进入项目目录并启动 Claude Code：
bash 
# 切换到您的项目目录
cd your_project
claude
  1. 此时会弹出登录认证页面或提示网络连接失败，无需处理。
  2. 编辑配置文件 $HOME/.claude.json，添加认证跳过标记：
bash 
vim ~/.claude.json

# 在配置文件的第一行添加以下字段
"hasCompletedOnboarding": true,
  1. 保存配置后，重新在终端启动 claude 即可开始使用。

提示

首次启动时如果出现推荐配置页面，请选择 yes 应用密钥，否则会出现 Not logged in 提示。

常见问题

启动报错：command not found

解决方案：重新安装 Claude Code：

bash 
npm install -g @anthropic-ai/claude-code --ignore-scripts

重新安装 Claude Code

卸载：

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

重新安装：

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

注意

重新安装后，请参考「配置认证绕过」章节完成认证配置。

配置完依旧显示 Not logged in · Please run /login

请确认首次启动时是否在推荐配置页面选择了 yes 应用密钥。如果选错了，请删除 .claude 目录和 .claude.json 重新配置：

bash 
rm -rf ~/.claude ~/.claude.json

然后重新按照「环境配置」章节从头配置即可。