AI 自動化

Claude Code 與 Claude API 雲端 Mac 設定:SSH PTY 與 launchd 指南(2026)

MacLogin AI 自動化團隊 2026年5月23日 約 12 分鐘
Claude Code 雲端 Mac SSH — Mac mini M4 Anthropic API

團隊在 MacLogin 租用 Apple Silicon Mac mini,是為了取得原生 macOS、常駐的 SSH,以及機房出口直連 api.anthropic.com,而無需自行採購硬體。本文結論:將 Claude API 自動化與 Claude Code 訂閱 OAuth 分開;互動式 CLI 務必使用 ssh -t;透過 launchd 注入 ANTHROPIC_API_KEY,勿寫入全域可讀 dotfile。

建議搭配閱讀:OpenClaw launchd 環境變數供應商限流退避SSH keepalive 疑難排解, 雲端 Mac 運行 ECC 完整指南,以及 OpenClaw 引導部署,以及 Multica 對比 Devin。, Claude Opus 4.8 Super-Agent 跑分, and Claude Agent SDK 官方教學

揭露說明:本文提及的 Mac 租賃服務提供方為 MacLogin。Claude Code 行為以 Anthropic 官方文件為準;上線前請核對與您版本相符的 CLI 參數。

誰適合在雲端 Mac 上跑 Claude

2026 年 MacLogin 客戶群中,以下三類情境最為常見:

  • 經 SSH 使用 Claude Code — 在租賃主機上執行互動式 CLI,從筆電或桌面 Code 分頁連線。
  • Claude API 自動化 — 同一台 Mac 上的 OpenClaw 閘道、CI 或內部工具消費 API Key。
  • 混合路由 — 編碼用 Sonnet、批次分揀用 Haiku,並記錄 429 處理策略。

API Key 與 claude.ai OAuth

模式憑證在 MacLogin 上的適用情境
Claude APIANTHROPIC_API_KEYOpenClaw、CI、無頭 Agent
Claude Code 訂閱claude auth login互動式 REPL、Remote Control
僅推理 Tokensetup-token不適用於 Remote Control

可引用規則:在與訂閱版 Claude Code 相同的 Shell 中匯出 ANTHROPIC_API_KEY 可能導致 OAuth 失效,需先 unset 該變數再重新驗證。

在 launchd 主機上存放 Claude API 金鑰

  1. 優先使用鑰匙圈或 launchd 的 EnvironmentVariables — 詳見 環境變數操作手冊
  2. 每份租約一把 Key — 切勿在租戶之間共用正式環境金鑰。
  3. 退租即撤銷 — 流程對齊 租約結束下線
<key>EnvironmentVariables</key>
<dict>
  <key>ANTHROPIC_API_KEY</key>
  <string>sk-ant-…</string>
</dict>

Claude Code 的 SSH PTY 操作手冊

部分 SSH 用戶端在未配置 PTY 的情況下呼叫 claude,可能觸發:Input must be provided… when using --printanthropics/claude-code#48440)。

ssh -t user@your-maclogin-host "cd ~/project && claude"
檢查項目通過標準
ssh host "claude --version"輸出版本號
ssh -t host "claude"REPL 可接受輸入
tmux + claude筆電休眠後工作階段仍存活

Keepalive 設定請與 斷線疑難排解 對齊 — 用戶端 ServerAliveInterval 設為 60 秒 是較穩妥的預設值。

OpenClaw + Claude API 路由

在 MacLogin 上 7×24 運行的閘道建議:

  • 在 allowlist JSON 中固定 model ID,變更需稽核。
  • 從亞太節點起步,API 逾時建議 45 秒,再依 p95 實測調校。
  • 遇到 429/529 時,先執行 重試退避手冊,避免靜默失敗。

區域與出口頻寬

MacLogin 提供香港、東京、首爾、新加坡及美東節點。請在各候選區域實測連線耗時:

curl -o /dev/null -s -w '%{time_connect}\n' https://api.anthropic.com

台灣與港澳團隊常選東京或新加坡,以改善相對本地寬頻的 npm 與 API 可達性;硬體 CapEx 對比見 Mac mini 買還是租

九步上線清單

  1. 依工程師分布選擇區域。
  2. 完成 首次 SSH 主機金鑰信任
  3. 安裝 Claude Code;確認 claude --version2.1.51(Remote Control 所需)。
  4. 選定 API 或 OAuth 驗證路徑。
  5. 驗證 ssh -t REPL。
  6. 長任務放入 tmux
  7. 為 OpenClaw 設定 launchd 環境變數。
  8. 設定 429 退避,可選 Ollama 降級層。
  9. 若每小時 >15% 請求走降級,觸發告警。

為何選 Mac mini M4

統一記憶體讓 claude、Node 閘道與 git 保持回應 — 租賃可在無 CapEx 前提下擴展多區域。

常見問題

API Key 能否用於 Claude Code Remote Control?
不能 — Remote Control 需要 claude.ai OAuth。請先 unset ANTHROPIC_API_KEY,再執行 claude auth login
SSH 下 Claude 為何立即結束?
缺少 PTY — 請使用 ssh -t,或修正連接器以配置終端機。
如何處理 429 限流?
退避、佇列上限、可選本機 Ollama — 請參閱上文連結的供應商限流文章。
外包人員能否共用正式環境 Key?
不建議 — 應發放具 TTL 的作用域 Key,並在租約結束時撤銷。
MacLogin 能否連線 api.anthropic.com?
通常可以 — 請在租賃主機上執行 curl 測試,並在企業防火牆中放行該網域。
MacLogin AI 自動化團隊
專注 OpenClaw 閘道、Claude API 路由與 Apple Silicon 雲端自動化。

租用雲端 Mac 執行 Claude Code

選擇就近區域,數分鐘開通 SSH。