MacLogin 클라우드 Mac에서 Claude Code와 Claude API: SSH PTY 및 launchd 설정 (2026)
팀이 MacLogin에서 Apple Silicon Mac mini를 임대하는 이유는 네이티브 macOS, 상시 가동 SSH, 그리고 하드웨어를 직접 구매하지 않고도 데이터센터 egress로 api.anthropic.com에 도달하기 위함입니다.본 가이드 결론: Claude API 자동화와 Claude Code 구독 OAuth를 분리하고, 대화형 CLI에는 항상 ssh -t를 사용하며, ANTHROPIC_API_KEY는 launchd로 주입하고 전 세계가 읽을 수 있는 dotfile에는 두지 마세요.
함께 읽어보세요: OpenClaw launchd 환경 변수, 프로바이더 속도 제한 백오프, SSH keepalive 문제 해결, OpenClaw 온보딩, Multica vs Devin 비교., 클라우드 Mac ECC 완전 가이드, Claude Opus 4.8 벤치마크, and Claude Agent SDK 초보 가이드
클라우드 Mac에서 Claude가 필요한 팀
2026년 MacLogin 플릿에서 가장 흔한 세 가지 프로필:
- SSH로 Claude Code — 임대 호스트의 대화형 CLI를 노트북·데스크톱 Code 탭에서 사용.
- 자동화용 Claude API — 동일 Mac의 OpenClaw 게이트웨이, CI, 내부 도구가 키 소비.
- 하이브리드 라우팅 — 코딩은 Sonnet, 배치 분류는 Haiku, 429 처리 문서화.
API 키 vs claude.ai OAuth
| 모드 | 자격 증명 | MacLogin에서 적합 |
|---|---|---|
| Claude API | ANTHROPIC_API_KEY | OpenClaw, CI, 헤드리스 에이전트 |
| Claude Code 구독 | claude auth login | 대화형 REPL, Remote Control |
| 추론 전용 토큰 | setup-token | Remote Control 비권장 |
인용 규칙: 구독 Claude Code와 같은 셸에서 ANTHROPIC_API_KEY를 export하면 OAuth가 깨질 수 있습니다. 키를 unset한 뒤 재인증하세요.
launchd 호스트에 Claude API 시크릿 저장
- 키체인 또는 launchd
EnvironmentVariables우선 — 환경 변수 런북 참고. - 임대당 키 하나 — 테넌트 간 프로덕션 키 공유 금지.
- 반납 시 폐기 — 임대 종료 오프보딩과 동일하게.
<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에서 24/7 게이트웨이:
- allowlist JSON에 model ID 고정, 변경은 감사.
- APAC에서는 API 타임아웃 45초로 시작 후 p95 측정으로 조정.
- 429/529 시 재시도 백오프 런북을 먼저 적용.
리전과 egress
MacLogin은 홍콩, 도쿄, 서울, 싱가포르, 미국 동부를 제공합니다. 후보마다 연결 시간을 측정하세요.
curl -o /dev/null -s -w '%{time_connect}\n' https://api.anthropic.com
한국 팀은 서울 노드를 1순위로 두고 npm·API 도달성을 자사 회선과 비교하세요. 하드웨어 CapEx는 Mac mini 임대 vs 구매를 참고하세요.
9단계 롤아웃
- 엔지니어 분포에 맞춰 리전 선택.
- 첫 SSH 호스트 키 신뢰 완료.
- Claude Code 설치;
claude --version≥ 2.1.51 (Remote Control). - API vs OAuth 인증 경로 선택.
ssh -tREPL 검증.- 장시간 작업은
tmux로 감싸기. - OpenClaw용 launchd 환경 구성.
- 429 백오프 및 선택적 Ollama 계층.
- 시간당 >15%가 폴백이면 알림.
Mac mini M4를 쓰는 이유
통합 메모리로 claude, Node 게이트웨이, git이 반응성 유지 — 임대로 CapEx 없이 리전 확장.
FAQ
ANTHROPIC_API_KEY를 unset하고 claude auth login을 실행하세요.ssh -t를 쓰거나 커넥터가 터미널을 할당하도록 수정.curl을 실행하고 기업 방화벽에서 도메인을 허용하세요.