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

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 세션

번들 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 페어링 업그레이드를 승인하십시오.

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

터미널 제어권 전환은 서비스/데몬 PATH보다 소유 호스트 사용자의 로그인 셸 PATH에서 claude을 먼저 확인합니다. 이를 통해 앱에서 시작한 세션이 운영자가 일반 터미널에서 사용하는 Claude CLI와 일치하게 유지됩니다.

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

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

헤드리스 Node 호스트에서도 아래의 Node 로컬 설정을 활성화하고 Node 호스트를 다시 시작하면 Claude CLI 행을 이어서 사용할 수 있습니다.

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

Node는 설정이 활성화되어 있고 로컬 claude 실행 파일을 확인할 수 있을 때만 agent.cli.claude.run.v1을 알립니다. OpenClaw은 해당 Node의 카탈로그 레코드를 다시 확인하고, 동일한 제한된 기록을 가져오며, 채택된 세션을 해당 Node 및 카탈로그에서 보고한 작업 디렉터리에 바인딩합니다. 각 턴은 해당 Node의 Claude 파일과 로그인을 사용하여 Node의 실제 claude -p 프로세스를 실행합니다. Node의 실행 승인 정책은 계속 적용되며 Gateway는 이 옵트인을 강제할 수 없습니다.

Node 이어서 실행 v1은 일회성만 지원합니다. Gateway 루프백 MCP 구성 및 Gateway Skills Plugin 인수를 생략하고, Gateway 트랜스크립트에서 다시 초기화하지 않으며, 첨부 파일과 이미지를 거부합니다. Claude Desktop 행은 계속 보기 전용입니다. 네이티브 macOS 앱 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": {},      },    },  },}

문제 해결

관련 항목