Skip to content

Claude Code macOS 安装教程

概述

MyCoding 提供了 Claude Code 在 macOS 系统上的完整安装和配置指南。

主要功能

  • 统计查询:API 使用统计和分析
  • 使用教程:Claude Code 完整安装和配置指南
  • 购买服务:通过淘宝或拼车方式获取 API 密钥

Claude Code macOS 安装教程

步骤 1:安装 Node.js 环境

方法一:使用 Homebrew(推荐)

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

bash
# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二:官网下载

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

macOS 注意事项

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

验证安装是否成功

安装完成后,打开 Terminal,输入以下命令:

bash
node --version
npm --version

如果显示版本号,说明安装成功了!

步骤 2:安装 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="https://mycoding.cc/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

# 禁用自动更新(推荐)
export DISABLE_AUTOUPDATOR=1

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

方法二:永久设置

编辑你的 shell 配置文件(根据你使用的 shell):

对于 zsh (默认):

bash
# 对于 zsh (默认)
echo 'export ANTHROPIC_BASE_URL="https://mycoding.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

对于 bash:

bash
# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://mycoding.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

步骤 4:开始使用 Claude Code

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

启动 Claude Code:

bash
claude

在特定项目中使用:

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

# 启动 Claude Code
claude

macOS 常见问题解决

安装时提示权限错误

尝试以下解决方法:

  • 使用 sudo 安装:sudo npm install -g @anthropic-ai/claude-code
  • 或者配置 npm 使用用户目录:npm config set prefix ~/.npm-global

macOS 安全设置阻止运行

如果系统阻止运行 Claude Code:

  • 打开"系统偏好设置" → "安全性与隐私"
  • 点击"仍要打开"或"允许"
  • 或者在 Terminal 中运行:sudo spctl --master-disable

环境变量不生效

检查以下几点:

  • 确认修改了正确的配置文件(.zshrc 或 .bash_profile)
  • 重新启动 Terminal
  • 验证设置:echo $ANTHROPIC_BASE_URL

验证环境变量

验证 Claude Code 环境变量:

bash
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

预期输出:

https://mycoding.cc/api
cr_xxxxxxxxxxxxxxxxxx

成功安装提示

🎉 恭喜你!

你已经成功安装并配置了 Claude Code,现在可以开始享受 AI 编程助手带来的便利了。

如果在使用过程中遇到任何问题,可以查看官方文档或社区讨论获取帮助。

相关链接