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

本指南目標：在 Windows 安裝 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/mcu/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 後台撤銷換新。

先在 PowerShell 確認：

node --version
npm --version

Node 版本 22 以上（Claude Code 官方 npm 套件需求）就跳到「一、安裝 Claude Code 並清理殘留」；低於 22 或出現「command not recognized」，依下列安裝／升級：

• 方法 A（推薦）：到 https://nodejs.org 下載 LTS 的 Windows 安裝檔（.msi），點兩下一路 Next 裝完，「關掉並重開 PowerShell」再確認 node --version。
• 方法 B（備用）：winget install OpenJS.NodeJS.LTS，裝完重開 PowerShell。

注意：若 Node 原本是其他工具（如 Hermes）附帶的，那工具移除時 Node 會一併消失。建議獨立安裝 Node 較穩定。

若被 PowerShell 執行原則擋住，先放行（只影響目前使用者）：

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

安裝：

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

清掉可能干擾的殘留（全新安裝建議先做）：

Remove-Item -Force "$env:USERPROFILE\.claude.json.backup" -ErrorAction SilentlyContinue

※ 若 %USERPROFILE%\.local\bin\claude.exe 也存在，先確認來源再決定是否刪除——那個位置正是官方 native 安裝器的安裝位置：若你是用官方 native 安裝器裝的（或不確定），請保留它、直接沿用即可（可跳過上面的 npm 安裝）；只有在確定要改用 npm 版、且該檔是損壞或過時的殘留時才刪（Remove-Item -Force "$env:USERPROFILE\.local\bin\claude.exe"）。兩份並存時由 PATH 順序決定實際執行哪一份，可用 Get-Command claude 確認。

開新的 PowerShell，確認：

claude --version

notepad $env:USERPROFILE\.claude\api-key-helper.cmd

（記事本問是否建立新檔 → 是；若資料夾不存在，先 mkdir $env:USERPROFILE\.claude。）

貼入這兩行（換成真正金鑰），存檔：

@echo off
echo 你的-MYAI168-key

驗證（應印出金鑰）：

cmd /c "$env:USERPROFILE\.claude\api-key-helper.cmd"

• 開 cc-switch，點上方「Claude Code」分頁。
• 點「+」新增，選 Custom Configuration。
• 基本欄位：
  • Provider Name：myai168-claude
  • API Key：你的金鑰
  • API Endpoint：https://www.myai168.com/mcu/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」建立的 .cmd）。若沒有，貼入：

  {
    "apiKeyHelper": "C:\\Users\\你的帳號\\.claude\\api-key-helper.cmd",
    "env": {
      "ANTHROPIC_BASE_URL": "https://www.myai168.com/mcu/api/anthropic",
      "ANTHROPIC_MODEL": "claude-opus-4-8"
    },
    "theme": "dark"
  }

• 按 Save → 在卡片上 Enable。

驗證寫出的設定檔：

Get-Content $env:USERPROFILE\.claude\settings.json

重點：base URL 不含 /v1、有 apiKeyHelper、用 ANTHROPIC_API_KEY。

notepad $env:USERPROFILE\.claude\settings.json

貼入（帳號換成你的；env 裡不要放 ANTHROPIC_API_KEY，由 helper 提供）：

{
  "apiKeyHelper": "C:\\Users\\你的帳號\\.claude\\api-key-helper.cmd",
  "env": {
    "ANTHROPIC_BASE_URL": "https://www.myai168.com/mcu/api/anthropic",
    "ANTHROPIC_MODEL": "claude-opus-4-8"
  },
  "theme": "dark"
}

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

開「全新」PowerShell（不要另外 set ANTHROPIC_* 變數，避免與 helper 衝突）：

mkdir $env:USERPROFILE\cc-test -Force
cd $env:USERPROFILE\cc-test
claude

首次畫面：偵測環境金鑰詢問 → 不影響；主題 → 選；Security notes → Enter；Trust this folder? → 1. Yes。

進主畫面問一句話，能回話即成功（左下角 Opus 4.8 · API Usage Billing）。打 /status 應顯示 base URL 為 MYAI168、Model 為 claude-opus-4-8。

「模型不存在／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。

.local\bin\claude.exe missing or broken（Windows）

先確認來源再處理——該位置是官方 native 安裝器的安裝位置：若它是你正在使用的官方 native 安裝主體，請勿刪除，改跑 claude update 修復；只有在你走 npm 版、且確認該檔是損壞的 native 殘留時才刪（Remove-Item -Force "$env:USERPROFILE\.local\bin\claude.exe"）。用 Get-Command claude 可看目前實際執行的是哪一份。

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. Windows：改 %USERPROFILE%\.claude\api-key-helper.cmd 裡 echo 後的字串。
3. 若用 cc-switch，也在卡片更新 API Key 後重新 Enable。

設定檔位置（Windows）

• %USERPROFILE%\.claude\settings.json
• %USERPROFILE%\.claude\api-key-helper.cmd

官方文件

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