Anthropic says OpenClaw-style Claude CLI usage is allowed again

개요

Anthropic의 Claude 모델과 Claude CLI 사용에 대한 OpenClaw의 지원 정책 변경 내용을 설명하고, API 키, Claude CLI 재사용, 프롬프트 캐싱, 1M 컨텍스트 창 기능 등을 활용하는 방법을 안내합니다.

주요 내용

* Claude CLI 사용 허용 재확인: Anthropic은 OpenClaw 스타일의 Claude CLI (예: claude -p) 사용을 다시 허용한다고 명시했습니다. OpenClaw는 이 정책을 따르며, Claude CLI 재사용 및 claude -p 사용을 지원합니다.
* Anthropic API 키 설정: OpenClaw에서 Anthropic API 키를 사용하여 Claude 모델에 액세스하는 방법이 설명되어 있습니다. openclaw onboard 명령을 통해 API 키를 설정하거나 비대화형으로 설정할 수 있으며, ANTHROPIC_API_KEY 환경 변수로도 구성 가능합니다.
* Thinking Defaults (Claude 4.6): OpenClaw에서 Claude 4.6 모델 사용 시, 명시적인 thinking 레벨이 설정되지 않으면 기본적으로 적응형(adaptive) thinking이 활성화됩니다. 이는 /think:<level> 메시지 또는 모델 파라미터(agents.defaults.models["anthropic/<model>"].params.thinking)를 통해 재정의할 수 있습니다.
* Fast Mode (Anthropic API): OpenClaw의 /fast 토글은 api.anthropic.com으로 직접 전송되는 API 키 및 OAuth 인증 요청을 포함한 Anthropic 트래픽을 지원합니다. /fast on은 service_tier: "auto"로, /fast off는 service_tier: "standard_only"로 매핑됩니다. 이 설정은 프록시나 게이트웨이를 통해 Anthropic 트래픽을 라우팅하는 경우에는 적용되지 않습니다.
* Prompt Caching (Anthropic API): OpenClaw는 Anthropic API의 프롬프트 캐싱 기능을 지원합니다. cacheRetention 파라미터를 사용하여 캐시 지속 시간을 설정할 수 있으며, 기본값은 short (5분)입니다. 에이전트별로 캐시 설정을 재정의하는 것도 가능합니다.
* 1M Context Window (Anthropic Beta): Anthropic의 1M 컨텍스트 창 기능이 베타 버전으로 제공되며, OpenClaw에서 params.context1m: true를 통해 활성화할 수 있습니다. 이 기능은 지원되는 Opus/Sonnet 모델에 적용되며, Anthropic에서 해당 자격 증명에 대한 장기 컨텍스트 사용을 허용해야 합니다. 레거시 Anthropic 토큰 인증 사용 시에는 경고가 기록되고 표준 컨텍스트 창으로 대체됩니다.
* Bedrock Claude Notes: Bedrock 상의 Anthropic Claude 모델은 cacheRetention 파라미터 전달을 지원합니다. 비-Anthropic Bedrock 모델은 런타임 시 cacheRetention: "none"으로 강제됩니다.
* 인증 오류 해결: 401 오류 또는 토큰 비활성화와 같은 일반적인 인증 문제에 대한 해결 방법을 제공합니다. API 키 누락, 프로필 설정 오류, 사용 불가능한 프로필 등에 대한 진단 및 해결 방안을 제시합니다.

시사점

OpenClaw는 Anthropic과의 통합을 강화하여 Claude CLI 재사용을 공식적으로 지원하며, API 키 기반의 보다 안정적인 운영 및 과금 관리를 제공하고, 프롬프트 캐싱 및 1M 컨텍스트 창과 같은 고급 기능을 활용할 수 있도록 합니다.