Mac下Claude Code完整配置指南:API中转+环境变量设置一步到位

前言

这篇文章整理了我亲测有效的完整流程:从Node.js安装到Claude Code部署,再到国内API直连配置,每个步骤都附了具体命令和配置示例。我用88api作为接口中转,省去了海外账户注册和翻墙的麻烦,国内环境可直接调用,希望能帮你少走弯路。

正文

1. 安装Node.js

Claude Code要求Node.js版本≥18(建议LTS版), macOS下有两种安装方式:

方法一:官网下载

访问Node.js官网,下载LTS版本安装包,双击后按向导完成安装。

方法二:Homebrew安装(推荐)

如果已安装Homebrew,直接在终端执行:

bash 复制代码
brew install node
验证安装

安装完成后,在终端输入以下命令检查版本,确保Node.js和npm都已正确安装:

bash 复制代码
node --version  # 输出v18.x.x或更高
npm --version   # 输出对应的npm版本

2. 安装Claude Code

Node.js就绪后,通过npm全局安装Claude Code:

bash 复制代码
npm install -g @anthropic-ai/claude-code
验证安装

安装完成后,输入以下命令检查版本,确认安装成功:

bash 复制代码
claude --version

3. 配置API连接

前提:获取API Key

使用Claude Code需要API Key,我这次实操中用了88api作为接口中转(官网:https://api.88api.shop),国内环境可直连,无需海外账户。

推荐大家可以试试,或者大家可以用自己的。

获取Key的步骤如下:

  1. 注册并登录后,点击侧边栏"API令牌"。

  2. 点击"添加令牌"

  3. 选择分组

    1. 根据需要调用的模型选择分组
      a. claude 模型建议使用 calude code 分组、
      b. gpt 模型建议使用 codex分组
    2. 可通过平台的模型广场查看不同模型支持的分组
    3. 若在使用中出现上游分组饱和,请切换分组使用
  4. 点击提交

  5. 点击复制按钮复制API令牌,也就是API KEY

方法一:配置文件(推荐)

通过配置文件永久保存API信息,步骤如下:

配置文件路径:

复制代码
~/.claude/settings.json

配置内容:

json 复制代码
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",  // 替换为实际复制的Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中转接口地址
  }
}

创建步骤 :

在终端执行以下命令创建目录和文件:

bash 复制代码
# 创建.claude目录(如已存在可跳过)
mkdir -p ~/.claude

# 用nano编辑配置文件
nano ~/.claude/settings.json

粘贴上述配置内容,按Ctrl+O保存,Ctrl+X退出编辑器。

方法二:环境变量

如果不想用配置文件,可通过环境变量临时或永久配置:

临时设置(当前终端有效):

bash 复制代码
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"  # 替换为实际Key

永久设置 :

将环境变量写入shell配置文件(如~/.zshrc):

bash 复制代码
# 编辑配置文件
nano ~/.zshrc

# 在文件末尾添加以下内容
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"  # 替换为实际Key

# 使配置生效
source ~/.zshrc

⚠️ 注意:配置后需重启终端;若在VS Code/Cursor等IDE的集成终端使用,需彻底重启IDE,否则配置可能不生效。

VSCode插件配置(可选)

如果使用VSCode的Claude插件,需额外创建config.json:

配置文件路径:

复制代码
~/.claude/config.json

配置内容:

json 复制代码
{
  "primaryApiKey": "any"
}

创建步骤:

bash 复制代码
# 创建文件
nano ~/.claude/config.json

粘贴配置内容并保存(同上,Ctrl+O保存,Ctrl+X退出)。

4. 开始使用

配置完成后,在终端输入以下命令启动Claude Code:

bash 复制代码
claude

如需查看命令说明,可执行:

bash 复制代码
claude --help

5. 常见问题排查

问题1:Unable to connect to Anthropic services

症状 :启动后提示无法连接服务。

解决方案 :创建~/.claude.json文件跳过引导流程:

配置文件路径:

复制代码
~/.claude.json

配置内容:

json 复制代码
{
  "hasCompletedOnboarding": true
}

创建方法 :

在终端执行:

bash 复制代码
cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

验证文件是否创建:

bash 复制代码
cat ~/.claude.json

重启Claude Code即可。

💡 调试技巧:若仍无法连接,可检查网络、重启终端/IDE,或确认API Key配置是否正确。

总结

这篇教程从Node.js安装到API配置,完整覆盖了Mac下Claude Code的部署流程。核心是通过配置文件或环境变量对接API中转,解决国内环境调用问题。如果你在操作中遇到其他报错,欢迎在评论区留言,我们一起排查解决。技术配置虽繁琐,但一步一步跟着做,总能跑通的!

相关推荐
IndustrialSphere8 小时前
工业历史趋势图为什么会误导人?用三条数据检查倒序、缺测和截断
api·数据可视化·工业软件·industrialsphere·历史数据
小七-七牛开发者12 小时前
周 1 上线 | DSH 喜提原神进场动画,Anthropic 启动 IPO 路演;黄仁勋辞任;微软全球大宕机超 24 小时
ai·大模型·agent·token·工作流·claudecode·ai coding
Karl_fang12 小时前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
ZhengEnCi13 小时前
AI 规则越多越费 Token:无关规则让每次回答多耗 46% 的规则体检提示词
aigc·ai编程·claude
XLYcmy13 小时前
基于大语言模型的智能漏洞检测与修复系统 作品报告评审分析报告 下
机器学习·llm·prompt·api·token·漏洞修复·漏洞检测
ServBay14 小时前
连AI自己也不愿意维护自己的屎山代码
后端·ai编程·claude
jerrywus16 小时前
用 AMD Radeon Cloud 免费跑 ComfyUI:从开机到打开界面
前端·agent·claude
泓博17 小时前
Android仿写苹果缩放窗口
人工智能·gpt·深度学习
Michaelyeung19 小时前
Windows 上给 Claude Code 配 MCP,今天踩的 3 个坑,你看看你在不在坑里
claude
ZzT20 小时前
三个 Claude 代码审查 skill 用了半年、1,306 条评论:最简单的修复率 68.9%,最复杂的 59.2%
ai编程·claude