前言
最近想试试Claude Code的本地代码辅助功能，却发现不少教程要么默认海外环境，要么步骤零散。
作为macOS用户，从Node.js安装到API配置，每一步都怕出错。所以整理了这篇亲测可行的完整流程，新手也能跟着一步步跑通。
正文
一、准备工作：安装Node.js
Claude Code运行依赖Node.js，最低要求Node.js ≥18（建议LTS版本），以下是两种安装方法：
方法一：官网下载（推荐）
访问Node.js官网，下载macOS对应的LTS版本，双击安装包按向导完成安装即可。
方法二：Homebrew安装
如果已安装Homebrew，直接在终端执行：
brewinstallnode验证安装
安装完成后，打开终端输入以下命令，出现版本号即成功：
node--version# 输出示例：v20.11.0npm--version# 输出示例：10.2.4二、安装Claude Code
Node.js准备好后，通过npm全局安装Claude Code：
npminstall-g@anthropic-ai/claude-code验证安装
安装完成后，输入以下命令检查版本：
claude--version出现版本信息即安装成功。
三、配置API连接（核心步骤）
Claude Code需要API密钥才能调用服务，这里使用API中转服务实现国内直连（无需海外账户）。
获取API Key
我这次使用88api中转接口（https://api.88api.shop），个人认为较稳定划算，或者大家也可以用自己的。获取Key的步骤如下：
1.注册登录后，点击 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写，没有含义，直接点击提交即可。
- 获取 API KEY
获得 API Key 后请妥善保管，API Key 是你的身份凭证，等同于账号密码，切勿公开或分享给他人。
- 点击“知道了”，可以看到我们刚才创建的，在这里也同样可以点击 复制 按钮去获取 API Key。
配置方式（二选一）
方法一：配置文件（推荐，永久生效）
在用户目录下创建.claude文件夹和settings.json配置文件：
配置文件路径：
~/.claude/settings.json配置内容（替换为你的API Key）：
{"env":{"ANTHROPIC_AUTH_TOKEN":"你的API密钥","ANTHROPIC_BASE_URL":"https://api.88api.shop"}}创建步骤：
# 创建.claude目录（如已存在可跳过）mkdir-p~/.claude# 编辑配置文件（nano是终端文本编辑器，也可用vim）nano~/.claude/settings.json粘贴上述配置内容，按Ctrl+O保存，Ctrl+X退出。
方法二：环境变量（临时或永久）
如果不想用配置文件，可通过环境变量配置：
临时生效（仅当前终端）：
exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"永久生效（需配置shell文件）：
将以下内容写入~/.zshrc（或你的shell配置文件，如.bashrc）：exportANTHROPIC_BASE_URL="https://api.88api.shop"exportANTHROPIC_AUTH_TOKEN="你的API密钥"保存后执行：
source~/.zshrc
⚠️注意：
- 请将"你的API密钥"替换为实际生成的Key
- 配置后需重启终端，若在VS Code等IDE的集成终端使用，需重启整个IDE才能生效
VSCode插件配置（可选）
如果使用VSCode的Claude插件，需额外创建config.json文件：
配置文件路径：
~/.claude/config.json配置内容：
{"primaryApiKey":"any"}创建步骤：
# 创建文件nano~/.claude/config.json粘贴内容后保存退出（同上）。
⚠️区分两个配置文件：
settings.json是命令行工具配置，config.json是VSCode插件专用，不要混淆。
四、开始使用Claude Code
配置完成后，在终端输入：
claude即可启动Claude Code。如需查看命令说明，可执行：
claude--help五、常见问题排查
问题1：启动后提示“Unable to connect to Anthropic services”
症状：启动Claude Code后无法连接服务。
原因：首次启动引导未完成。
解决方案：在用户根目录创建.claude.json文件跳过引导：
配置文件路径：
~/.claude.json配置内容：
{"hasCompletedOnboarding":true}创建方法：
cat>~/.claude.json<<'EOF' { "hasCompletedOnboarding": true } EOF验证文件是否创建：
cat~/.claude.json重启Claude Code即可。
调试小技巧
若配置后仍无法连接，可按以下步骤排查：
- 检查网络连接是否正常
- 确认API Key是否正确（重新复制粘贴一次）
- 重启终端或IDE后重试
总结
本文从Node.js安装到API配置，完整覆盖了macOS下Claude Code的本地化部署流程。关键步骤在于配置文件的正确填写和环境变量的生效（记得重启终端/IDE）。如果遇到连接问题，可优先检查.claude.json文件是否创建。按步骤操作，基本能一次跑通，有问题欢迎在评论区交流~
