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 测试,并在企业防火墙中放行该域名。