Anthropic

• API 키 - 사용량 기반 요금제로 Anthropic API에 직접 액세스합니다(anthropic/* 모델).
• Claude CLI - 동일한 호스트에서 기존 Claude Code 로그인을 재사용합니다.

​

사용량 및 비용 추적

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

​

시작하기

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

openclaw models auth login --provider anthropic --method setup-token

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

​

여러 컴퓨터의 Claude 세션

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

{
  nodeHost: {
    agentRuns: {
      claude: { enabled: true },
    },
  },
}

​

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

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

​

안전 거부 폴백(Claude Fable 5)

​

이 기능이 존재하는 이유

​

작동 방식

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도 거부하면 해당 턴은 이 기능이 도입되기 전과 정확히 동일하게 거부를 오류로 표시합니다.

​

관찰 가능성 및 청구

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

​

범위

​

프롬프트 캐싱

{
  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": {},
      },
    },
  },
}

​

문제 해결

​

관련 항목