Anthropic

Anthropic은 Claude 모델 제품군을 만듭니다. OpenClaw는 두 가지 인증 경로를 지원합니다.

• API 키 — 사용량 기반 청구가 적용되는 Anthropic API 직접 액세스(anthropic/* 모델)
• Claude CLI — 같은 호스트의 기존 Claude Code 로그인을 재사용

시작하기

openclaw onboard# choose: Anthropic API key

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

openclaw models list --provider anthropic

{  env: { ANTHROPIC_API_KEY: "example-anthropic-key-not-real" },  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-8" } } },}

claude --version

openclaw onboard# choose: Claude CLI

openclaw models list --provider anthropic

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-8" },      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },      },    },  },}

사고 기본값(Claude Fable 5, 4.8, 4.6)

anthropic/claude-fable-5는 항상 adaptive thinking을 사용하며 기본값은 high effort입니다. Anthropic은 이 모델에서 thinking 비활성화를 허용하지 않으므로 /think off와 /think minimal은 low effort를 사용합니다. OpenClaw는 Fable 5 요청에서 사용자 지정 temperature 값도 생략합니다.

Claude Opus 4.8은 OpenClaw에서 기본적으로 thinking이 꺼진 상태를 유지합니다. /think high|xhigh|max로 adaptive thinking을 명시적으로 활성화하면 OpenClaw는 Anthropic의 Opus 4.8 effort 값을 전송합니다. Claude 4.6 모델은 기본값이 adaptive입니다.

메시지별로 /think:<level> 또는 모델 매개변수에서 오버라이드합니다.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-8": {          params: { thinking: "high" },        },      },    },  },}

안전 거부 폴백(Claude Fable 5)

이 기능이 있는 이유

Fable 5 분류기는 제한된 도메인의 요청에 대해 stop_reason: "refusal"을 반환하며, 무해한 주변 작업(보안 도구, 생명과학, 또는 모델에 원시 추론을 재현해 달라고 요청하는 경우)에도 오탐이 발생합니다. 폴백이 없으면 다른 Claude 모델이 기꺼이 처리할 수 있는 경우에도 턴이 오류로 종료됩니다. Anthropic 자체 거부 메시지는 API 통합자에게 폴백 모델을 구성하라고 안내합니다.

작동 방식

1. anthropic/claude-fable-5로 보내는 모든 직접 API 키 요청에 대해 OpenClaw는 Anthropic의 서버 측 폴백 옵트인을 전송합니다. 즉, server-side-fallback-2026-06-01 베타 헤더와 fallbacks: [{"model": "claude-opus-4-8"}]를 함께 보냅니다. Claude Opus 4.8은 Anthropic이 Fable 5에 허용하는 유일한 폴백 대상입니다.
2. 안전 분류기 거절만 폴백을 트리거합니다. 속도 제한, 과부하, 서버 오류는 이전과 정확히 동일하게 동작하며 OpenClaw의 일반 모델 장애 조치를 거칩니다.
3. 구조는 같은 호출 안에서 일어납니다. 출력 전에 거절되면 지연 시간 외에는 보이지 않으며 전체 답변은 Opus 4.8에서 나옵니다. 스트림 중간 거절의 경우 부분 텍스트는 폴백 모델이 이어서 계속할 접두사로 유지되고, 거절된 모델의 reasoning과 도구 호출은 Anthropic의 재생 규칙에 따라 폐기됩니다(다시 되돌려 보내거나 실행해서는 안 됩니다).
4. Claude Opus 4.8도 거절하면, 이 기능 이전과 정확히 동일하게 해당 턴은 거부를 오류로 표시합니다.

폴백은 Anthropic API 수준에서 발생하므로 claude-opus-4-8이 구성된 모델 목록이나 폴백 체인에 있을 필요는 없습니다. Fable을 사용할 수 있는 API 키는 항상 Opus를 처리할 수 있습니다.

관측 가능성 및 청구

• 폴백으로 처리된 턴은 assistant 메시지에 fromModel과 toModel을 명명하는 provider_fallback 진단을 기록하고, 메시지의 responseModel은 claude-opus-4-8을 보고합니다.
• Anthropic은 시도별로 청구합니다. 출력 전 거절은 무료이며, 구조는 Claude Opus 4.8 요율(현재 Fable 5 요율의 절반)로 청구됩니다. OpenClaw의 턴별 비용 추정도 이에 맞춰 폴백 처리 턴을 Opus 요율로 산정합니다.
• 스트림 중간 거절은 이미 스트리밍된 Fable 부분도 Anthropic 측에서 추가로 청구합니다. 해당 부분은 API의 시도별 사용량에 보고되지만 OpenClaw의 턴별 추정에는 포함되지 않습니다.

범위

api.anthropic.com에 대해 API 키 인증을 사용하는 anthropic/claude-fable-5에 적용됩니다. OAuth(Claude CLI 구독 재사용), 프록시 기본 URL, Bedrock, Vertex, Foundry 요청은 변경되지 않으며 해당 환경에서는 여전히 거부가 오류로 표시됩니다.

라이브 검증됨: Fable 5에 원시 chain of thought를 재현해 달라는 무해한 프롬프트는 폴백 없이 전송하면 category: "reasoning_extraction"으로 거절되고, 같은 프롬프트를 OpenClaw를 통해 보내면 provider_fallback 진단이 첨부된 정상적인 Opus 처리 답변을 반환합니다.

기저 동작은 Anthropic의 거부 및 폴백 가이드를 참고하세요.

프롬프트 캐싱

OpenClaw는 API 키 인증에 대해 Anthropic의 프롬프트 캐싱 기능을 지원합니다.

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },  },}

{  agents: {    defaults: {      model: { primary: "anthropic/claude-opus-4-6" },      models: {        "anthropic/claude-opus-4-6": {          params: { cacheRetention: "long" },        },      },    },    list: [      { id: "research", default: true },      { id: "alerts", params: { cacheRetention: "none" } },    ],  },}

고급 구성

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

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": {},      },    },  },}

문제 해결

관련 항목