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。