Anthropic

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

• API 키 - 사용량 기반 결제를 사용하는 Anthropic API 직접 액세스(anthropic/* 모델)
• Claude CLI - 동일한 호스트의 기존 Claude Code 로그인을 재사용

사용량 및 비용 추적

OpenClaw은 사용 가능한 Anthropic 자격 증명을 감지하고 이에 맞는 사용량 화면을 선택합니다.

• Claude 구독/설정 자격 증명에는 할당량 기간과 선택적 추가 사용량 예산이 표시됩니다.
• ANTHROPIC_ADMIN_KEY 또는 ANTHROPIC_ADMIN_API_KEY를 사용하면 Control UI의 사용량에 공급자가 보고한 최근 30일간의 조직 비용과 Messages API 사용량이 표시됩니다. 여기에는 일별 지출, 토큰/캐시 합계, 주요 모델 및 비용 범주가 포함됩니다.
• Anthropic 공급자 프로필에 저장된 sk-ant-admin... 자격 증명은 Admin API 키로 자동 감지됩니다.

Admin API 비용 내역은 Anthropic의 사용량 및 비용 API에서 가져옵니다. 이는 OpenClaw이 세션을 기반으로 계산한 추정 비용과 별개인 실제 공급자 청구 금액입니다.

시작하기

openclaw onboard# 선택: Anthropic API 키

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# 선택: 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 세션

번들 Anthropic Plugin은 일반 세션 사이드바에 Claude Code 그룹을 추가합니다. 행은 일반 채팅 창에서 열립니다. Gateway와 연결된 Node 호스트에서 보관되지 않은 Claude Code 세션을 검색합니다.

• Claude CLI 세션은 유효한 프로젝트 인덱스 레코드와, 제한된 메타데이터 접두사가 ~/.claude/projects/ 아래의 비사이드체인 sdk-cli 세션임을 식별하는 현재 JSONL 파일에서 가져옵니다.
• Claude Desktop 세션은 메타데이터가 동일한 Claude Code 세션 ID를 가리킬 때 Desktop 제목, 활동 시간 및 보관 상태를 사용합니다.
• CLI 전용 세션에는 보관 플래그가 없으므로 트랜스크립트가 존재하는 동안 계속 표시됩니다.

추가 OpenClaw 구성은 필요하지 않습니다. Anthropic Plugin은 번들로 제공되며 기본적으로 활성화됩니다. 네이티브 macOS Node는 로컬 ~/.claude/projects/ 디렉터리가 존재할 때 읽기 전용 Claude 세션 명령을 알립니다. 이러한 명령이 처음 나타나면 Node 페어링 업그레이드를 승인하십시오.

사이드바는 각 호스트에서 제한된 최신 페이지로 시작하며 일반적인 30초 주기로 새로 고쳐집니다. 카탈로그 그룹 아래의 세션 더 불러오기를 사용하여 추가 기록이 있는 모든 호스트의 다음 페이지를 추가하십시오. 추가된 행은 계속 표시되며 새로 고칠 때도 동일한 깊이까지 다시 가져옵니다. 카탈로그 클라이언트는 sessions.catalog.list를 사용하며, 행을 열 때는 sessions.catalog.read를 사용합니다.

행을 선택하면 최신 트랜스크립트 페이지를 먼저 읽습니다. 이전 트랜스크립트 항목 불러오기는 불투명 바이트 커서를 따라 전체 기록을 불러오는 대신 JSONL 파일에서 제한된 다른 구간을 읽습니다. 일반 사용자, 어시스턴트, 추론, 도구 호출 및 도구 결과 콘텐츠가 유지됩니다. Node/Gateway 안전 상한보다 큰 개별 항목은 잘린 것으로 명확하게 표시됩니다.

Gateway 로컬 claude-cli 행에서 일반 작성기에 입력하면 sessions.catalog.continue를 호출합니다. OpenClaw은 로컬 카탈로그 레코드를 다시 확인하고, 모델에 고정된 네이티브 세션을 생성하거나 재사용하며, 표시되는 항목을 최대 200개 또는 512 KiB까지 가져온 후 Claude CLI 바인딩을 초기화합니다. 첫 번째 턴은 --fork-session으로 재개됩니다. Claude는 포크에 새 세션 ID를 할당하므로 이후 턴에서는 포크를 사용하며 원본 세션은 변경되지 않습니다. Claude Desktop 및 페어링된 Node의 행은 보기 전용입니다.

Node 명령 및 보안 경계에 관한 내용은 Node: Claude 세션 및 트랜스크립트를 참조하십시오.

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

anthropic/claude-sonnet-5는 기본적으로 high 수준의 적응형 사고를 사용합니다. 사고를 비활성화하려면 /think off를 사용하고, 모델의 더 높은 네이티브 수준을 사용하려면 /think xhigh|max를 사용하십시오. Anthropic이 이 모델에서 해당 요청 기능을 지원하지 않으므로 OpenClaw은 Sonnet 5에 수동 사고 예산, 사용자 지정 샘플링 매개변수, 어시스턴트 프리필 및 Priority Tier를 사용하지 않습니다. 카탈로그에는 2026년 8월 31일까지 Anthropic의 출시 기념 입출력 가격인 $2/$10이 적용되며, 표준 $3/$15 가격은 2026년 9월 1일부터 적용됩니다.

anthropic/claude-fable-5는 항상 적응형 사고를 사용하며 기본 수준은 high입니다. Anthropic은 이 모델의 사고 비활성화를 허용하지 않으므로 /think off와 /think minimal은 대신 low 수준에 매핑됩니다. Anthropic은 사고가 활성화된 모든 요청에서 temperature 재정의를 거부하므로 OpenClaw은 Fable 5 요청에서 사용자 지정 temperature 값도 사용하지 않습니다.

anthropic/claude-mythos-5는 동일한 상시 활성 적응형 사고 계약을 사용하는 제한 액세스 모델입니다. OpenClaw의 기본값은 high이고, /think off와 /think minimal을 low에 매핑하며, 호출자가 선택한 샘플링 매개변수를 사용하지 않습니다. 카탈로그에는 1,000,000토큰 컨텍스트 창, 128,000토큰 출력 한도, 이미지 입력 및 $10/$50 입출력 가격이 게시됩니다.

Claude Opus 4.8은 OpenClaw에서 기본적으로 사고가 비활성화되어 있습니다. /think high|xhigh|max를 사용하여 적응형 사고를 명시적으로 활성화하면 OpenClaw은 Anthropic의 Opus 4.8 수준 값을 전송합니다. Claude 4.6 모델 (Opus 4.6 및 Sonnet 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에서 생성됩니다. 스트리밍 도중 거부되면 부분 텍스트는 폴백 모델이 이어서 생성할 접두사로 유지되지만, 거부된 모델의 추론과 도구 호출은 Anthropic의 재생 규칙에 따라 폐기됩니다(다시 에코하거나 실행해서는 안 됩니다).
4. Claude Opus 4.8도 거부하면 이 기능을 사용하기 전과 정확히 동일하게 턴에서 거부가 오류로 표시됩니다.

폴백은 Anthropic API 수준에서 이루어지므로 claude-opus-4-8을 구성된 모델 목록이나 폴백 체인에 포함할 필요가 없습니다. Fable을 사용할 수 있는 API 키는 언제든지 Opus를 처리할 수 있습니다.

관측 가능성과 청구

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

적용 범위

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

실시간 검증 결과: Fable 5에 원시 사고 과정을 재현하도록 요청하는 무해한 프롬프트를 폴백 없이 전송하면 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-sonnet-5": {},        "anthropic/claude-mythos-5": {},        "anthropic/claude-opus-4-6": {},      },    },  },}

문제 해결

관련 항목