📌 핵심 요약
✅ Anthropic OpenClaw의 현재 사용 가능 여부 확인
✅ 재사용 및 상업적 이용 관련 라이선스 조건
✅ API 접근 및 사용 방법 안내
✅ 특정 데이터 사용 및 제약 사항
📑 목차
2026년 4월 22일, Anthropic이 OpenClaw 스타일 Claude CLI 사용을 공식적으로 다시 허용했습니다. 지난 몇 주간 인증 이슈로 불편을 겪던 개발자 커뮤니티에는 반가운 소식입니다. 이번 글에서는 재허용의 의미, 최신 설정 방법, 그리고 1M 컨텍스트·Fast 모드 같은 핵심 기능을 한 번에 정리합니다.
무엇이 달라졌나 — 재허용의 핵심
이번 변경의 핵심은 간단합니다. Anthropic API 키와 기존 Claude CLI 인증 프로필 모두를 OpenClaw에서 계속 쓸 수 있다는 점이 공식적으로 확인되었습니다. 이전에는 토큰 기반 프로필이 만료되거나 차단될 수 있다는 우려 때문에 많은 팀이 대체 툴로 눈을 돌렸습니다.
Anthropic 담당자 발표를 요약하면 세 가지입니다.
- CLI 재사용 허용 —
claude -p형태의 사용도 현행 기준으로는 정책 위반이 아닙니다. - API 키 병행 지원 — 관리형 배포에는 여전히 API 키 경로가 권장됩니다.
- 기존 프로필 인정 — 기존 OAuth 프로필도 별도 마이그레이션 없이 계속 동작합니다.
OpenClaw가 뭐였지 — 30초 복습
OpenClaw는 Claude를 비롯한 여러 LLM을 단일 CLI·설정으로 묶어 쓰는 에이전트 프레임워크입니다. VS Code, 터미널, GitHub Actions 어디서든 같은 agent.json 설정으로 호출할 수 있다는 점이 핵심입니다. Claude Code와 비교하면, 여러 프로바이더를 혼합해서 워크플로우를 짤 수 있다는 것이 가장 큰 차이입니다.
지금 바로 세팅하기 — API 키 방식
Anthropic 공식 문서(docs.openclaw.ai/providers/anthropic) 기준 권장 경로는 API 키입니다. 관리형/장시간 실행 환경에서는 토큰 만료 걱정이 없기 때문입니다.
1. 온보딩 CLI 실행
openclaw onboard
# 또는 파라미터로 직접 넘기기
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"2. agent.json 에 모델 고정
{
"env": { "ANTHROPIC_API_KEY": "sk-ant-..." },
"agents": {
"defaults": {
"model": { "primary": "anthropic/claude-opus-4-6" }
}
}
}3. 동작 확인
간단한 openclaw run "hello" 한 줄이면 인증과 모델 라우팅이 같이 검증됩니다. 여기서 401이 뜨면 키가 틀렸거나, 403이면 조직 정책이 모델을 차단한 경우입니다.
CLI 재사용 방식 — 언제 쓰면 좋은가
API 키가 싫거나, 이미 Claude CLI 로그인을 사용 중이라면 그대로 재활용하는 편이 편합니다. 다만 주의할 점이 있습니다.
- 토큰은 만료된다 — 장시간 무인 배치 작업에는 API 키가 더 안정적입니다.
- 에이전트별 인증 — 새 에이전트를 추가하면 기본 에이전트의 키를 자동 상속하지 않습니다. 의도적 설계입니다.
- 게이트웨이를 타면 제한 — 프록시 너머로 라우팅되는 경우 일부 tier 설정이 무시될 수 있습니다.
Claude 4.6 기능 — 놓치면 아까운 3가지
① Adaptive Thinking (기본 활성)
명시적으로 끄지 않으면 Claude 4.6은 자동으로 생각 수준을 조절합니다. 깊이 있는 응답을 원하면 메시지 단위로 /think:high 같은 오버라이드를 사용하세요. 튜토리얼 문서 생성처럼 가벼운 작업은 /think:low로 속도를 확보합니다.
② /fast 토글
/fast on→service_tier: "auto", 우선순위 큐/fast off→service_tier: "standard_only", 기본 큐만 사용
다만 Amazon Bedrock 같은 프록시 경로에서는 tier 설정이 적용되지 않는 경우가 있으니, 퍼포먼스가 필요한 워크플로우는 직접 api.anthropic.com으로 보내는 것이 안전합니다.
③ Prompt Caching
{
"agents": {
"defaults": {
"models": {
"anthropic/claude-opus-4-6": {
"params": { "cacheRetention": "long" }
}
}
}
}
}옵션은 none / short(5분) / long(1시간) 세 가지입니다. 장기 문서 분석이나 대화 세션이 긴 에이전트에는 long 설정이 비용을 크게 줄여줍니다.
1M 컨텍스트 윈도우 — 언제 켜야 하나
Claude 4.6은 베타 플래그로 최대 100만 토큰 컨텍스트를 지원합니다. 설정은 한 줄입니다.
{
"params": { "context1m": true }
}다만 모든 작업에 켜놓을 이유는 없습니다. 소규모 요청에는 불필요한 프리-로드 비용이 발생할 수 있어, 리포지토리 전체 스캔·긴 로그 분석·대용량 RAG 같은 시나리오에 한정해서 활성화하는 것이 합리적입니다.
팀·에이전트 설정 체크리스트
| 항목 | 권장 설정 | 비고 |
|---|---|---|
| 인증 | API 키 | 장시간/무인 배치에 안전 |
| 기본 모델 | anthropic/claude-opus-4-6 | 4.6 기본 adaptive thinking |
| Fast 모드 | /fast on | 대화형 워크플로우 |
| Cache | long | 긴 세션/RAG |
| 1M 컨텍스트 | 시나리오별 토글 | 대용량 스캔에만 |
| 프록시 | 가능하면 직접 호출 | tier 제어 보장 |
마이그레이션 가이드 — 토큰 → API 키
기존 Claude CLI 토큰을 쓰고 있다면, 지금이 API 키로 옮기기 좋은 타이밍입니다.
- Anthropic Console에서 조직 단위 API 키 발급
ANTHROPIC_API_KEY환경변수 등록 (1Password/Vault 권장)openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"- agent.json에서
model.primary고정,cacheRetention설정 openclaw run1회 테스트 후 기존 토큰 프로필 삭제
자주 묻는 질문 (FAQ)
Q1. 재허용은 언제부터 적용되나?
공식 공지 기준 2026년 4월 22일부터 이미 유효합니다. 별도의 온보딩 없이 기존 프로필이 그대로 동작합니다.
Q2. OpenClaw와 Claude Code 차이는?
Claude Code는 Anthropic 공식 CLI로 Claude 모델에 최적화되어 있습니다. OpenClaw는 여러 프로바이더(Anthropic, OpenAI, Gemini 등)를 통합 설정으로 묶어 쓰는 프레임워크입니다. 혼합 워크플로우가 필요하면 OpenClaw가 유리합니다.
Q3. API 키와 CLI 중 뭐가 더 안전한가?
조직 단위로 사용량·권한 관리가 필요하면 API 키가 유리합니다. 개인 개발 환경이라면 기존 Claude CLI 인증도 그대로 써도 됩니다. 단, 토큰은 만료·회수될 수 있다는 점만 기억하세요.
Q4. 1M 컨텍스트를 기본으로 켜두면 안 되나?
가능하지만 추천하지 않습니다. 짧은 요청에도 컨텍스트 초기화 비용이 발생할 수 있어, 리포지토리 전체 스캔이나 긴 로그 분석처럼 필요할 때만 켜는 것이 비용 효율적입니다.
Q5. 프록시 환경에서 Fast 모드가 안 먹혀요.
Bedrock 같은 관리형 엔드포인트는 tier 설정을 일부 무시합니다. 성능이 중요한 경로는 Anthropic 직접 호출로 전환하고, 비용 최적화가 필요한 경로만 프록시를 유지하는 하이브리드 전략이 실용적입니다.
마무리 — 지금 해야 할 일
재허용이 발표된 만큼, 대체 툴로 우회했던 워크플로우를 OpenClaw로 다시 통합하기 좋은 시점입니다. 체크리스트는 단순합니다. API 키로 재온보딩, 4.6 모델 고정, 캐시 long 설정, 필요 시 1M 컨텍스트 토글. 이 네 가지만 확인해도 팀 단위 생산성은 즉시 개선됩니다.
공식 문서(docs.openclaw.ai/providers/anthropic)와 재허용 공지(news.hada.io/topic?id=28761)를 함께 확인하면 도입 결정이 더 쉬워집니다.
