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

本指南目標：在 Linux 桌面安裝 Claude Code CLI，並接上自己的 MYAI168 API，使用 Claude Opus 4.8。（以 Ubuntu／Debian 為例。）

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

設定邏輯與 macOS 相同（apiKeyHelper＋settings.json，base_url 不含 /v1），路徑用 Linux 家目錄、shell 設定檔依你的 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（Claude Code 官方 npm 套件需 Node.js 22 以上，低於 22 請一併升級）：

node --version
npm --version

沒有就裝（Ubuntu／Debian）：

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

確認 shell：echo $SHELL —— bash → ~/.bashrc；zsh → ~/.zshrc。

不要用 sudo。若遇 npm 權限錯誤，把 npm 全域目錄指到家目錄再裝：

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

確認：

claude --version

（若找不到指令：確認 ~/.local/bin 或 ~/.npm-global/bin 在 PATH；例如：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

之後再確認一次。）

建立金鑰腳本（整塊貼上、按一次 Enter；把金鑰換成你真正的 MYAI168 key）：

mkdir -p ~/.claude
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，Linux 桌面操作介面與其他平台相同。（安裝方式見開發者中心的「cc-switch Linux」分頁。）

• 開 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」建立的腳本）。若沒有，補成：

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

• 按 Save → 在卡片上 Enable。

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

cat ~/.claude/settings.json

用 heredoc 寫 settings.json（整塊貼上、按 Enter；路徑中的帳號換成你的，可用 whoami 查）：

cat > ~/.claude/settings.json << 'EOF'
{
  "apiKeyHelper": "/home/你的帳號/.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。

（Linux 家目錄通常是 /home/帳號；若不確定，用 echo $HOME 確認。）

開「全新終端機」（不要另外 export ANTHROPIC_* 變數）：

mkdir -p ~/cc-test
cd ~/cc-test
claude

過首次畫面（主題、安全、信任資料夾）後，打 /status 確認端點與模型，再問一句話，能回話即成功。

「模型不存在／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 沒吐出金鑰。確認腳本存在、有執行權限（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。

切換／確認模型

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

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

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

設定檔位置（Linux）

• ~/.claude/settings.json
• ~/.claude/api-key-helper.sh

官方文件

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