Claude Code 與 Claude API 雲端 Mac 設定:SSH PTY 與 launchd 指南(2026)
團隊在 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 上跑 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 API | ANTHROPIC_API_KEY | OpenClaw、CI、無頭 Agent |
| Claude Code 訂閱 | claude auth login | 互動式 REPL、Remote Control |
| 僅推理 Token | setup-token | 不適用於 Remote Control |
可引用規則:在與訂閱版 Claude Code 相同的 Shell 中匯出 ANTHROPIC_API_KEY 可能導致 OAuth 失效,需先 unset 該變數再重新驗證。
在 launchd 主機上存放 Claude API 金鑰
- 優先使用鑰匙圈或 launchd 的
EnvironmentVariables— 詳見 環境變數操作手冊。 - 每份租約一把 Key — 切勿在租戶之間共用正式環境金鑰。
- 退租即撤銷 — 流程對齊 租約結束下線。
<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 --print(anthropics/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 買還是租。
九步上線清單
- 依工程師分布選擇區域。
- 完成 首次 SSH 主機金鑰信任。
- 安裝 Claude Code;確認
claude --version≥ 2.1.51(Remote Control 所需)。 - 選定 API 或 OAuth 驗證路徑。
- 驗證
ssh -tREPL。 - 長任務放入
tmux。 - 為 OpenClaw 設定 launchd 環境變數。
- 設定 429 退避,可選 Ollama 降級層。
- 若每小時 >15% 請求走降級,觸發告警。
為何選 Mac mini M4
統一記憶體讓 claude、Node 閘道與 git 保持回應 — 租賃可在無 CapEx 前提下擴展多區域。
常見問題
ANTHROPIC_API_KEY,再執行 claude auth login。ssh -t,或修正連接器以配置終端機。curl 測試,並在企業防火牆中放行該網域。