前言

最近把自己在 macOS 上從 0 到 1 跑通 Claude Code 的全過程整理出來，包括 Node.js 安裝、工具部署，以及如何用國內(nèi) API 中轉(zhuǎn)服務(wù)完成配置。整個流程親測可行，每一步都有具體命令和配置示例，希望能幫你少踩坑，快速用上這款工具。

正文

一、準(zhǔn)備工作：安裝 Node.js

Claude Code 依賴 Node.js 環(huán)境，官方要求最低版本 ≥18，建議直接安裝 LTS 版本（長期支持版），穩(wěn)定性更好。

方法一：官網(wǎng)下載（推薦新手）

訪問 Node.js 官網(wǎng)，選擇 macOS 對應(yīng)的 LTS 版本安裝包，下載后雙擊按向?qū)瓿砂惭b即可，一路默認(rèn)選項(xiàng)就行。

方法二：Homebrew 安裝（適合熟悉終端的用戶）

如果你已經(jīng)安裝了 Homebrew，直接在終端執(zhí)行：

brew install node

驗(yàn)證安裝是否成功

安裝完成后，打開終端輸入以下命令，能正常顯示版本號就說明安裝成功了：

node --version
# 輸出示例：v20.11.0（版本號可能因最新 LTS 版本變化）
npm --version
# 輸出示例：10.2.4（npm 會隨 Node.js 一起安裝）

二、安裝 Claude Code 工具

Node.js 環(huán)境準(zhǔn)備好后，用 npm 全局安裝 Claude Code：

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

安裝完成后驗(yàn)證一下，終端輸入：

claude --version

如果能顯示版本信息，說明工具安裝成功了。

三、配置 API 連接（核心步驟）

Claude Code 需要通過 API 調(diào)用后端服務(wù)，這里我用 88api 作為中轉(zhuǎn)，你也可以用自己熟悉的 API 服務(wù)。

1. 獲取 API Key（以 88api 為例）

首先訪問88api 官網(wǎng)(https://api.88api.shop)，注冊并登錄賬號：

1.注冊登錄以后，點(diǎn)擊頁面上方的“控制臺”，然后進(jìn)入后再點(diǎn)擊側(cè)邊欄的 “API 令牌”

2.點(diǎn)擊添加令牌

3. 創(chuàng)建令牌

名稱隨便寫，沒有含義，直接點(diǎn)擊提交即可。

4. 獲取 API KEY

獲得 API Key 后請妥善保管，API Key 是你的身份憑證，等同于賬號密碼，切勿公開或分享給他人。

點(diǎn)擊“知道了”，可以看到我們剛才創(chuàng)建的，在這里也同樣可以點(diǎn)擊 復(fù)制 按鈕去獲取 API Key。

2. 配置 API 信息（兩種方法，選一種即可）

方法一：配置文件（推薦，永久生效）

在用戶目錄下創(chuàng)建配置文件，步驟如下：

配置文件路徑（固定位置，不要改）：

~/.claude/settings.json

配置內(nèi)容（替換成你的 API Key）：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密鑰",  // 替換成剛復(fù)制的 88api Key
    "ANTHROPIC_BASE_URL": "https://api.88api.shop"  // 中轉(zhuǎn)服務(wù)地址
  }
}

創(chuàng)建步驟（終端執(zhí)行）：

# 創(chuàng)建 .claude 目錄（如果已存在會自動跳過）
mkdir -p ~/.claude
# 用 nano 編輯配置文件（新手友好的編輯器）
nano ~/.claude/settings.json

打開編輯器后，粘貼上面的 JSON 內(nèi)容，把“你的API密鑰”替換成實(shí)際 Key，按 Ctrl+O 保存，Ctrl+X 退出。

方法二：環(huán)境變量（臨時或永久）

如果不想用配置文件，也可以通過環(huán)境變量設(shè)置：

臨時生效（只對當(dāng)前終端窗口有效）：

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密鑰"  # 替換成實(shí)際 Key

永久生效（對所有終端窗口有效）：
把以下內(nèi)容添加到你的 shell 配置文件（比如 ~/.zshrc 或 ~/.bash_profile）：

export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密鑰"  # 替換成實(shí)際 Key

保存后執(zhí)行 source ~/.zshrc（或?qū)?yīng)配置文件）讓設(shè)置生效。

?? 注意：配置完成后必須重啟終端，如果在 VS Code 等 IDE 的集成終端中使用，需要徹底重啟 IDE（不是只關(guān)終端窗口），否則配置可能不生效。

3. VSCode 插件配置（可選）

如果你用 VSCode 的 Claude 插件，還需要額外創(chuàng)建一個插件專用配置文件：

配置文件路徑：

~/.claude/config.json

配置內(nèi)容：

{
  "primaryApiKey": "any"
}

創(chuàng)建步驟：

# 確保 .claude 目錄已存在
mkdir -p ~/.claude
# 編輯配置文件
nano ~/.claude/config.json

粘貼內(nèi)容后保存退出即可。注意這是插件專用的 config.json，和前面命令行工具的 settings.json 是兩個文件，別搞混了。

四、開始使用 Claude Code

配置完成后，終端輸入以下命令啟動工具：

claude

首次啟動可能會有簡單引導(dǎo)，按提示操作即可。如果想查看所有可用命令，輸入 claude --help。

五、常見問題排查

問題 1：啟動后提示“Unable to connect to Anthropic services”

癥狀：啟動 Claude Code 后報錯，無法連接服務(wù)。
原因：首次啟動的引導(dǎo)流程未完成。
解決方法：在用戶根目錄創(chuàng)建 .claude.json 文件跳過引導(dǎo)：

配置文件路徑：

~/.claude.json

配置內(nèi)容：

{
  "hasCompletedOnboarding": true
}

創(chuàng)建命令（終端執(zhí)行）：

cat > ~/.claude.json << 'EOF'
{
  "hasCompletedOnboarding": true
}
EOF

創(chuàng)建后驗(yàn)證一下：

cat ~/.claude.json

確認(rèn)文件內(nèi)容正確后，重啟 Claude Code 即可。

?? 調(diào)試小技巧：如果還是連不上，先檢查網(wǎng)絡(luò)、重啟終端/IDE，再確認(rèn) API Key 和 ANTHROPIC_BASE_URL 配置是否正確（特別是 Key 有沒有復(fù)制錯）。

總結(jié)

到這里，Claude Code 在 macOS 上的安裝、API 配置和基本使用就全部完成了。整個流程最關(guān)鍵的是 API 中轉(zhuǎn)服務(wù)的配置，用國內(nèi)服務(wù)確實(shí)能省去不少海外賬號和網(wǎng)絡(luò)的麻煩。

如果你跟著步驟走還是遇到問題，歡迎在評論區(qū)留言，我會盡量幫忙解答。技術(shù)工具的配置有時就是一層窗戶紙，捅破了就簡單了，希望這篇教程能幫你少走彎路，快速用上 Claude Code~

到此這篇關(guān)于小白也能照著做：Claude Code 在 macOS 上的安裝與 API配置全流程的文章就介紹到這了,更多相關(guān)Claude Code 安裝與API配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論