Claude Code CLI 安裝與 MYAI168 設定指南 — macOS 版

本指南目標：在 macOS 安裝 Claude Code CLI，並接上自己的 MYAI168 API，使用 Claude Opus 4.8。

Claude Code 走 Anthropic Messages 協定，接 MYAI168 的 Anthropic 原生端點，不需任何 proxy。金鑰以 apiKeyHelper 腳本提供——這不是官方的必要設定（官方支援直接設 ANTHROPIC_API_KEY 環境變數；apiKeyHelper 的官方定位是動態產生／輪替憑證用），本教學選用它是讓金鑰不進 shell 環境變數、也方便集中更換。

端點與模型（最關鍵）

• 端點：https://www.myai168.com/rocna/api/anthropic（結尾不要加 /v1）
• 模型：claude-opus-4-8

base_url 結尾務必是 .../anthropic，「絕對不要加 /v1」。Claude Code 會自己接上 /v1/messages；若已含 /v1 會變成錯誤路徑，並回報誤導性的「模型不存在／model does not exist」錯誤。（這是最容易踩的坑。）

重要安全須知

• Claude Code 能在工作目錄裡讀寫、執行檔案。實際使用請 cd 進專案資料夾再開，不要在家目錄開啟。
• API Key 視同密碼，不要外流；外流就到 MYAI168 後台撤銷換新。

前置

Node.js 22 以上（官方 npm 套件自 v2.1.198 起要求；低於 22 安裝時會出現 EBADENGINE 警告）。

先確認是否已安裝：

claude --version

有版本號就跳到「二、建立 apiKeyHelper」；若顯示 command not found，用 npm 安裝：

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

裝完讓指令生效並確認：

source ~/.zshrc
claude --version

（若仍 command not found，多半是 PATH 未生效，重開終端機視窗再試。）

本教學不論用 cc-switch 或手動設定，都以 apiKeyHelper 提供金鑰（並非官方必要設定——官方也支援直接設 ANTHROPIC_API_KEY 環境變數；沿用本教學流程請先建好它）：

mkdir -p ~/.claude

建立金鑰腳本（把下面「一整塊」複製、貼到終端機、按一次 Enter；把金鑰換成你真正的 MYAI168 key）：

cat > ~/.claude/api-key-helper.sh << 'EOF'
#!/bin/bash
echo "你的-MYAI168-key"
EOF
chmod +x ~/.claude/api-key-helper.sh

驗證能吐金鑰（應印出金鑰字串）：

~/.claude/api-key-helper.sh

cc-switch 是跨平台 GUI，macOS 操作介面與 Windows 相同。（安裝方式見開發者中心的「cc-switch macOS」分頁。）

• 開 cc-switch，點上方「Claude Code」分頁。
• 點「+」新增，選 Custom Configuration。
• 基本欄位：
  • Provider Name：myai168-claude
  • API Key：你的金鑰
  • API Endpoint：https://www.myai168.com/rocna/api/anthropic（不含 /v1）
• 展開 Advanced Options：
  • API Format：Anthropic Messages (Native)
  • Auth Field：ANTHROPIC_API_KEY（不要選 AUTH_TOKEN）
• Model Mapping：把 Sonnet／Opus／Fable／Haiku 的 Requested model 都填 claude-opus-4-8；Default fallback model 也填 claude-opus-4-8。
• Config JSON 區：務必確認含 apiKeyHelper（指向「二、建立 apiKeyHelper」建立的腳本）。cc-switch 預設可能不會幫你加 apiKeyHelper；本教學設定以 apiKeyHelper 提供金鑰，若 Config JSON 沒有，手動補成：

  {
    "apiKeyHelper": "/Users/你的帳號/.claude/api-key-helper.sh",
    "env": {
      "ANTHROPIC_BASE_URL": "https://www.myai168.com/rocna/api/anthropic",
      "ANTHROPIC_MODEL": "claude-opus-4-8"
    }
  }

• 按 Save → 在卡片上 Enable。

驗證 cc-switch 寫出的設定檔（重點：base URL 不含 /v1、有 apiKeyHelper、用 ANTHROPIC_API_KEY）：

cat ~/.claude/settings.json

若不用 cc-switch，直接用指令建立 settings.json（路徑中的 annie91 換成你的 macOS 使用者名稱，可用 whoami 查；整塊貼上、按 Enter）：

cat > ~/.claude/settings.json << 'EOF'
{
  "apiKeyHelper": "/Users/annie91/.claude/api-key-helper.sh",
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.myai168.com/rocna/api/anthropic",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  }
}
EOF

重要：用了 apiKeyHelper 就不要再 export ANTHROPIC_API_KEY，否則會跳 Auth conflict 警告。若 ~/.zshrc 有舊的 Claude Code function／export，請編輯 ~/.zshrc 把那些刪掉。

（再次提醒：base URL 結尾 .../anthropic，不含 /v1。）

開「全新終端機視窗」（避免殘留環境變數干擾），直接打：

claude

（不要帶任何環境變數，apiKeyHelper 會自動提供金鑰。）

首次畫面：色彩主題 → 選；Security notes → Enter；Terminal setup → 1. Yes；Trust this folder? → 1. Yes。應直接進 "Welcome back" 主畫面，不會跳登入選單。

驗證：打 /status，確認 base URL 是 MYAI168、Model 是 claude-opus-4-8。再問一句話，能回話即成功（左下角顯示 Opus 4.8 · API Usage Billing，表示走 API 金鑰計費而非官方訂閱）。

「模型不存在／It may not exist or you may not have access」

最常見：base_url 加了 /v1。改成 .../anthropic（不含 /v1）。其次（Windows）：殘留的 .claude.json.backup 干擾 → 刪除它（Remove-Item -Force "$env:USERPROFILE\.claude.json.backup"）。

Not logged in / Please run /login

缺 apiKeyHelper，或 helper 沒吐出金鑰。確認腳本存在、有執行權限（macOS 要 chmod +x）、settings.json 有 apiKeyHelper 欄位。登入選單只接受官方帳號，不要走；靠 apiKeyHelper 略過。

Auth conflict 警告

同時設了 apiKeyHelper 和 ANTHROPIC_API_KEY。移除 env／shell 裡的 ANTHROPIC_API_KEY。

401 / developer key is wrong

金鑰錯誤。檢查 helper 腳本裡的 key 是否正確、有無多餘空格。

回話報 404 / not found

（僅在已確認沒加 /v1 仍 404 時）試把 base URL 改成 .../anthropic/v1 再測；一般情況維持不含 /v1。

claude 指令找不到（新終端機）

macOS：source ~/.zshrc 或重開終端機。Windows：開新 PowerShell 讓 PATH 生效。

切換／確認模型

對話中 /model 切換；/status 確認端點與模型。

更新（官方指定用 install @latest；不要用 npm update -g——它受原安裝的 semver 範圍限制，可能不會更新到最新版）：

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

更換 API Key（外流或定期輪替）

1. 到 MYAI168 後台撤銷舊 key、產新 key。
2. macOS：改 ~/.claude/api-key-helper.sh 裡 echo 後的字串。
3. 若用 cc-switch，也在卡片更新 API Key 後重新 Enable。

設定檔位置（macOS）

• ~/.claude/settings.json：端點與 apiKeyHelper 設定。
• ~/.claude/api-key-helper.sh：提供金鑰的腳本。

官方文件

• https://code.claude.com/docs/en/authentication
• https://docs.claude.com/en/docs/claude-code/overview