Claude Code CLI

安裝總覽（macOS 版）

Claude Code CLI 安裝與自定義 API 設定指南 — macOS 版

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

重點說明

Claude Code 本身只講 Anthropic Messages 協定，所以只要供應商有 Anthropic 相容端點就能直接接，不需要任何 proxy。MYAI168 有 Anthropic 原生端點，完美契合。

關鍵做法

Claude Code 的互動模式有一個限制 —— 在沒有「先存在一筆登入紀錄」的情況下，即使設了環境變數的 API key，它仍會強制跳出登入畫面。因此本指南採用官方的 apiKeyHelper 機制來繞過登入，這是最穩定可行的方式。

開始之前：前置準備與安全須知

前置：Node.js 與 API Key

  • Claude Code 透過 npm 安裝，需要 Node.js（建議 18 以上；若已照其他指南裝過 Node 24 就沒問題）。
  • 準備好 MYAI168 的 API Key，以及 Anthropic 原生端點網址：
端點   https://www.myai168.com/jp/api/anthropic
模型   claude-opus-4-8

重要安全須知

  • Claude Code 能在工作目錄裡讀取、編輯、執行檔案。實際使用時請 cd 進特定專案資料夾再開，不要在家目錄（~）開啟，以免它對整個家目錄都有讀寫執行權限。
  • API Key 視同密碼，不要外流、不要貼到公開場合。若不慎外流，立刻到 MYAI168 後台撤銷並換新。
一、安裝 Claude Code

先確認是否已安裝：

claude --version

有版本號就跳到下一節。若顯示 command not found，用 npm 安裝：

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

裝完讓指令生效並確認：

source ~/.zshrc
claude --version

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

二、設定 apiKeyHelper 接上 MYAI168

確保設定資料夾存在：

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

應印出你的金鑰字串，表示成功。

第二步：建立 settings.json 指定 helper 與端點

同樣整塊貼上、按 Enter（把路徑中的 annie91 換成你的 macOS 使用者名稱，可用 whoami 查）：

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

重要：不要同時設 ANTHROPIC_API_KEY

用了 apiKeyHelper，就「不要」再在 ~/.zshrc 或 shell 裡 export ANTHROPIC_API_KEY，否則 Claude Code 會跳出 Auth conflict 警告。若先前曾在 .zshrc 加過指向 Claude Code 的 function 或 export，請編輯 ~/.zshrc 把那些刪掉。

三、啟動與驗證

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

claude

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

首次啟動會依序出現幾個畫面，照下面處理：

  • 選色彩主題 → 選你喜歡的（深色背景選 Dark mode），Enter。
  • Security notes → Enter 繼續。
  • Terminal setup → 選 1. Yes, use recommended settings。
  • Trust this folder？ → 選 1. Yes, I trust this folder。

成功的話會直接進到 "Welcome back" 主畫面，不會跳出登入選單。

進到主畫面後驗證：

/status

確認：沒有要求 /login、Anthropic base URL 是 MYAI168、Model 是 claude-opus-4-8。

再問一句話測試：

你好，報一下你現在用的模型

能正常回話、並回報模型為 Claude Opus 4.8，即代表接通成功。主畫面左下角會顯示「Opus 4.8 · API Usage Billing」，"API Usage Billing" 表示走的是 API 金鑰計費（你的 MYAI168），而非官方訂閱。

四、日常使用

設定完成後，平常直接打 claude 即可走 MYAI168，不需額外指令。

實際開發時，先進到專案資料夾再開：

cd ~/你的專案資料夾
claude

想改回用官方訂閱：把 ~/.claude/settings.json 裡的 apiKeyHelper 那行移除，再重新 /login 即可。

五、常見問題速查

一直跳出登入選單（Select login method）

互動模式需要 apiKeyHelper 才能跳過登入。確認第 2 節兩個檔案都建立正確，且開的是全新終端機視窗。按 Esc 可暫時跳過選單。

401 / developer key is wrong

金鑰錯誤。檢查 api-key-helper.sh 裡的 key 是否為真實金鑰、有無多餘空格或佔位字。

Not logged in / Please run /login（已設 key 卻仍出現）

金鑰沒被讀到。多半是 helper 腳本沒執行權限（重跑 chmod +x）、或路徑寫錯、或殘留環境變數衝突（開新視窗再試）。

Auth conflict 警告

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

回話報 404 / not found

端點路徑問題。把 settings.json 裡的 ANTHROPIC_BASE_URL 改成 .../anthropic/v1（加上 /v1）再試。

切換模型

對話中用 /model；或改 settings.json 的 ANTHROPIC_MODEL。

確認目前認證方式

在 Claude Code 裡打 /status。

六、維護與安全

更新 Claude Code：

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

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

  1. 到 MYAI168 後台撤銷舊 key、產生新 key。
  2. 編輯 ~/.claude/api-key-helper.sh，把 echo 後面那串換成新 key。
  3. 若同一把 key 也用在其他工具，記得一併更新它們的設定檔。

設定檔位置

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

官方文件

其他常見問題頁面