메뉴
HN
Hacker News 40일 전

앤스로픽, 클로드 CLI 재사용을 다시 허용

IMP
7/10
핵심 요약

앤스로픽(Anthropic) 측이 OpenClaw와 같은 서드파티 도구에서 클로드 CLI(Claude CLI)를 재사용하는 방식을 다시 허용했다고 공식적으로 확인했습니다. 이에 따라 OpenClaw는 사용자가 자신의 CLI 로그인을 연동해 클로드 모델을 사용하는 것을 승인된 정책으로 간주하고 이를 지원합니다. 다만 장기적으로 안정적인 서비스 운영과 명확한 요금 청구를 위해서는 전용 API 키를 사용하는 것을 권장하고 있습니다.

번역된 본문

메인 콘텐츠로 건너뛰기

OpenClaw 홈페이지 영어 검색... ⌘ K 검색... 탐색

제공업체(Providers) Anthropic 시작하기(Get started) 설치(Install) 채널(Channels) 에이전트(Agents) 도구 및 플러그인(Tools & Plugins) 모델(Models) 플랫폼(Platforms) 게이트웨이 및 운영(Gateway & Ops) 참조(Reference) 도움말(Help) 개요(Overview) 제공업체 디렉토리(Provider Directory) 모델 제공업체 빠른 시작(Model Provider Quickstart) 개념 및 구성(Concepts and configuration) 모델(Models) CLI 모델 제공업체(Model Providers) 모델 장애 조치(Model Failover) 제공업체(Providers) Alibaba Model Studio Amazon Bedrock Amazon Bedrock Mantle Anthropic Arcee AI Chutes Claude Max API Proxy Cloudflare AI Gateway ComfyUI Deepgram DeepSeek fal Fireworks GitHub Copilot GLM (Zhipu) Google (Gemini) Groq Hugging Face (Inference) inferrs Kilocode LiteLLM LM Studio MiniMax Mistral Moonshot AI NVIDIA Ollama OpenAI OpenCode OpenCode Go OpenRouter Perplexity Qianfan Qwen Runway SGLang StepFun Synthetic Together AI Venice AI Vercel AI Gateway vLLM Volcengine (Doubao) Vydra xAI Xiaomi MiMo Z.AI

현재 페이지: Anthropic (Claude) 옵션 A: Anthropic API 키 CLI 설정 Anthropic 구성 스니펫 사고 기본값 (Claude 4.6) 빠른 모드 (Anthropic API) 프롬프트 캐싱 (Anthropic API) 구성 기본값 에이전트별 cacheRetention 재정의 Bedrock Claude 참고사항 1M 컨텍스트 창 (Anthropic 베타) Claude CLI 백엔드 참고사항 문제 해결(Troubleshooting)


Anthropic (Claude) 앤스로픽은 클로드 모델 패밀리를 구축하며, API와 클로드 CLI(Claude CLI)를 통해 액세스를 제공합니다. OpenClaw에서는 Anthropic API 키와 클로드 CLI 재사용을 모두 지원합니다. 이미 구성된 기존 레거시 Anthropic 토큰 프로필은 런타임 시에도 계속해서 적용됩니다.

앤스로픽 직원은 우리에게 OpenClaw 방식의 클로드 CLI 사용이 다시 허용되었음을 알렸습니다. 따라서 앤스로픽이 새로운 정책을 발표하지 않는 한, OpenClaw는 클로드 CLI 재사용 및 claude -p 사용을 이 통합에 대해 승인된 것으로 간주합니다. 장기간 실행되는 게이트웨이 호스트의 경우, Anthropic API 키를 사용하는 것이 여전히 가장 명확하고 예측 가능한 프로덕션 경로입니다.

호스트에서 이미 클로드 CLI를 사용 중인 경우, OpenClaw는 해당 로그인을 직접 재사용할 수 있습니다.

앤스로픽의 현재 공개 문서:

  • Claude Code CLI 참조
  • Claude Agent SDK 개요
  • Pro 또는 Max 플랜으로 Claude Code 사용
  • Team 또는 Enterprise 플랜으로 Claude Code 사용

가장 명확한 요금 청구 경로를 원한다면, 대신 Anthropic API 키를 사용하세요. OpenClaw는 OpenAI Codex, Qwen Cloud Coding Plan, MiniMax Coding Plan 및 Z.AI / GLM Coding Plan을 포함한 다른 구독 방식의 옵션도 지원합니다.


옵션 A: Anthropic API 키 적합한 경우: 표준 API 액세스 및 사용량 기반 요금 청구. Anthropic 콘솔에서 API 키를 생성하세요.

CLI 설정

openclaw onboard # 선택: Anthropic API 키
# 또는 비대화형 모드
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Anthropic 구성 스니펫

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-..."
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-opus-4-6"
      }
    }
  }
}

사고 기본값 (Claude 4.6) 명시적인 사고(thinking) 수준이 설정되지 않은 경우, OpenClaw에서는 Anthropic Claude 4.6 모델이 기본적으로 적응형 사고(adaptive thinking)를 사용하도록 설정됩니다. 메시지별로 재정의하거나(/think:<level>) 모델 파라미터에서 설정할 수 있습니다: agents.defaults.models["anthropic/<model>"].params.thinking

관련 Anthropic 문서:

  • 적응형 사고(Adaptive thinking)
  • 확장된 사고(Extended thinking)

빠른 모드 (Anthropic API) OpenClaw의 공유 /fast 토글은 API 키 및 api.anthropic.com으로 전송되는 OAuth 인증 요청을 포함한 직접적인 퍼블릭 Anthropic 트래픽을 지원합니다.

  • /fast onservice_tier: "auto"에 매핑됩니다.
  • /fast offservice_tier: "standard_only"에 매핑됩니다.

구성 기본값:

{
  "agents": {
    "defaults": {
      "models": {
        "anthropic/claude-sonnet-4-6": {
          "params": {
            "fastMode": true
          }
        }
      }
    }
  }
}

중요한 제한 사항:

  • OpenClaw는 직접적인 api.anthropic.com 요청에 대해서만 Anthropic 서비스 티어를 주입합니다. anthropic/*을 프록시나 게이트웨이를 통해 라우팅하는 경우, /fastservice_tier를 변경하지 않고 그대로 둡니다.
  • 명시적인 Anthropic serviceTier 또는 service_tier 모델 파라미터가 둘 다 설정된 경우, /fast 기본값보다 우선하여 적용됩니다.
  • Anthropic은 응답의 usage.service_tier 아래에 유효한 티어를 보고합니다.
  • 우선 순위 티어(Priority Tier) 용량이 없는 계정의 경우, service_tier: "auto"는 여전히 표준(standard)으로 해석될 수 있습니다.

프롬프트 캐싱 (Anthropic API) OpenClaw는 Anthropic의 프롬프트 캐싱 기능을 지원합니다. 이...

원문 보기
원문 보기 (영어)
Skip to main content OpenClaw home page English Search... ⌘ K Search... Navigation Providers Anthropic Get started Install Channels Agents Tools & Plugins Models Platforms Gateway & Ops Reference Help Overview Provider Directory Model Provider Quickstart Concepts and configuration Models CLI Model Providers Model Failover Providers Alibaba Model Studio Amazon Bedrock Amazon Bedrock Mantle Anthropic Arcee AI Chutes Claude Max API Proxy Cloudflare AI Gateway ComfyUI Deepgram DeepSeek fal Fireworks GitHub Copilot GLM (Zhipu) Google (Gemini) Groq Hugging Face (Inference) inferrs Kilocode LiteLLM LM Studio MiniMax Mistral Moonshot AI NVIDIA Ollama OpenAI OpenCode OpenCode Go OpenRouter Perplexity Qianfan Qwen Runway SGLang StepFun Synthetic Together AI Venice AI Vercel AI Gateway vLLM Volcengine (Doubao) Vydra xAI Xiaomi MiMo Z.AI On this page Anthropic (Claude) Option A: Anthropic API key CLI setup Anthropic config snippet Thinking defaults (Claude 4.6) Fast mode (Anthropic API) Prompt caching (Anthropic API) Configuration Defaults Per-agent cacheRetention overrides Bedrock Claude notes 1M context window (Anthropic beta) Claude CLI backend Notes Troubleshooting ​ Anthropic (Claude) Anthropic builds the Claude model family and provides access via an API and Claude CLI. In OpenClaw, Anthropic API keys and Claude CLI reuse are both supported. Existing legacy Anthropic token profiles are still honored at runtime if they are already configured. Anthropic staff told us OpenClaw-style Claude CLI usage is allowed again, so OpenClaw treats Claude CLI reuse and claude -p usage as sanctioned for this integration unless Anthropic publishes a new policy. For long-lived gateway hosts, Anthropic API keys are still the clearest and most predictable production path. If you already use Claude CLI on the host, OpenClaw can reuse that login directly. Anthropic’s current public docs: Claude Code CLI reference Claude Agent SDK overview Using Claude Code with your Pro or Max plan Using Claude Code with your Team or Enterprise plan If you want the clearest billing path, use an Anthropic API key instead. OpenClaw also supports other subscription-style options, including OpenAI Codex , Qwen Cloud Coding Plan , MiniMax Coding Plan , and Z.AI / GLM Coding Plan . ​ Option A: Anthropic API key Best for: standard API access and usage-based billing. Create your API key in the Anthropic Console. ​ CLI setup openclaw onboard # choose: Anthropic API key # or non-interactive openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY" ​ Anthropic config snippet { env : { ANTHROPIC_API_KEY : "sk-ant-..." } , agents : { defaults : { model : { primary : "anthropic/claude-opus-4-6" } } } , } ​ Thinking defaults (Claude 4.6) Anthropic Claude 4.6 models default to adaptive thinking in OpenClaw when no explicit thinking level is set. You can override per-message ( /think:<level> ) or in model params: agents.defaults.models["anthropic/<model>"].params.thinking . Related Anthropic docs: Adaptive thinking Extended thinking ​ Fast mode (Anthropic API) OpenClaw’s shared /fast toggle also supports direct public Anthropic traffic, including API-key and OAuth-authenticated requests sent to api.anthropic.com . /fast on maps to service_tier: "auto" /fast off maps to service_tier: "standard_only" Config default: { agents : { defaults : { models : { "anthropic/claude-sonnet-4-6" : { params : { fastMode : true } , } , } , } , } , } Important limits: OpenClaw only injects Anthropic service tiers for direct api.anthropic.com requests. If you route anthropic/* through a proxy or gateway, /fast leaves service_tier untouched. Explicit Anthropic serviceTier or service_tier model params override the /fast default when both are set. Anthropic reports the effective tier on the response under usage.service_tier . On accounts without Priority Tier capacity, service_tier: "auto" may still resolve to standard . ​ Prompt caching (Anthropic API) OpenClaw supports Anthropic’s prompt caching feature. This is API-only ; legacy Anthropic token auth does not honor cache settings. ​ Configuration Use the cacheRetention parameter in your model config: Value Cache Duration Description none No caching Disable prompt caching short 5 minutes Default for API Key auth long 1 hour Extended cache { agents : { defaults : { models : { "anthropic/claude-opus-4-6" : { params : { cacheRetention : "long" } , } , } , } , } , } ​ Defaults When using Anthropic API Key authentication, OpenClaw automatically applies cacheRetention: "short" (5-minute cache) for all Anthropic models. You can override this by explicitly setting cacheRetention in your config. ​ Per-agent cacheRetention overrides Use model-level params as your baseline, then override specific agents via agents.list[].params . { agents : { defaults : { model : { primary : "anthropic/claude-opus-4-6" } , models : { "anthropic/claude-opus-4-6" : { params : { cacheRetention : "long" } , // baseline for most agents } , } , } , list : [ { id : "research" , default : true } , { id : "alerts" , params : { cacheRetention : "none" } } , // override for this agent only ] , } , } Config merge order for cache-related params: agents.defaults.models["provider/model"].params agents.list[].params (matching id , overrides by key) This lets one agent keep a long-lived cache while another agent on the same model disables caching to avoid write costs on bursty/low-reuse traffic. ​ Bedrock Claude notes Anthropic Claude models on Bedrock ( amazon-bedrock/*anthropic.claude* ) accept cacheRetention pass-through when configured. Non-Anthropic Bedrock models are forced to cacheRetention: "none" at runtime. Anthropic API-key smart defaults also seed cacheRetention: "short" for Claude-on-Bedrock model refs when no explicit value is set. ​ 1M context window (Anthropic beta) Anthropic’s 1M context window is beta-gated. In OpenClaw, enable it per model with params.context1m: true for supported Opus/Sonnet models. { agents : { defaults : { models : { "anthropic/claude-opus-4-6" : { params : { context1m : true } , } , } , } , } , } OpenClaw maps this to anthropic-beta: context-1m-2025-08-07 on Anthropic requests. This only activates when params.context1m is explicitly set to true for that model. Requirement: Anthropic must allow long-context usage on that credential. Note: Anthropic currently rejects context-1m-* beta requests when using legacy Anthropic token auth ( sk-ant-oat-* ). If you configure context1m: true with that legacy auth mode, OpenClaw logs a warning and falls back to the standard context window by skipping the context1m beta header while keeping the required OAuth betas. ​ Claude CLI backend The bundled Anthropic claude-cli backend is supported in OpenClaw. Anthropic staff told us this usage is allowed again. OpenClaw therefore treats Claude CLI reuse and claude -p usage as sanctioned for this integration unless Anthropic publishes a new policy. Anthropic API keys remain the clearest production path for always-on gateway hosts and explicit server-side billing control. Setup and runtime details are in /gateway/cli-backends . ​ Notes Anthropic’s public Claude Code docs still document direct CLI usage such as claude -p , and Anthropic staff told us OpenClaw-style Claude CLI usage is allowed again. We are treating that guidance as settled unless Anthropic publishes a new policy change. Anthropic setup-token remains available in OpenClaw as a supported token-auth path, but OpenClaw now prefers Claude CLI reuse and claude -p when available. Auth details + reuse rules are in /concepts/oauth . ​ Troubleshooting 401 errors / token suddenly invalid Anthropic token auth can expire or be revoked. For new setup, migrate to an Anthropic API key. No API key found for provider “anthropic” Auth is per agent . New agents don’t inherit the main agent’s keys. Re-run onboarding for that agent, or configure an API key on the gateway host, then verify with openclaw models status . No credentials found for profile anthropic:defa