Uma interface de linha de comando para monitorar o uso e os gastos da API Anthropic Admin diretamente do seu terminal.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install claude-usage-cli
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o claude-usage-cli usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Claude Usage CLI?
O claude-usage-cli é um utilitário poderoso dentro do ecossistema Openclaw Skills projetado para desenvolvedores e equipes que precisam de visibilidade granular em seus gastos com a API Anthropic. Ao fazer a interface diretamente com a API Anthropic Admin, ele fornece dados em tempo real sobre consumo de tokens e custos, permitindo que os usuários permaneçam dentro do orçamento e otimizem o uso do modelo. Esta ferramenta foi construída para lidar com dados sensíveis de forma responsável, utilizando armazenamento seguro em nível de sistema para autenticação.
A skill foca especificamente em ambientes macOS, aproveitando o Keychain do sistema para garantir que suas chaves de API Admin sensíveis permaneçam seguras e criptografadas. Embora esta ferramenta específica tenha sido substituída pelo claude-cost-cli, ela continua sendo um exemplo robusto de como o Openclaw Skills pode simplificar o gerenciamento de custos de infraestrutura de IA por meio de relatórios automatizados e tratamento seguro de credenciais.
Casos de uso do Claude Usage CLI
- Monitore o uso diário ou mensal de tokens da API Anthropic em diferentes modelos, como o Claude 3.5 Sonnet.
- Gere relatórios de detalhamento de custos para identificar espaços de trabalho de alto gasto ou chaves de API específicas.
- Exporte dados de uso para JSON para integração em painéis de cobrança personalizados ou sistemas de relatórios internos.
- Gerencie credenciais de API Admin de forma segura no macOS sem depender de arquivos de configuração em texto simples.
Como o Claude Usage CLI funciona
- O usuário instala o pacote globalmente via npm e inicializa a configuração com uma chave de API Anthropic Admin.
- A chave da API é armazenada com segurança no Keychain do macOS sob o identificador de serviço claude-usage-cli.
- Quando um usuário executa um comando de uso ou custo, a ferramenta recupera a chave e envia uma solicitação HTTPS autenticada para os endpoints da API Anthropic Admin.
- A resposta bruta da API é processada para calcular totais, agrupar dados por dimensões e converter contagens de tokens em valores em USD.
- A ferramenta exibe os dados processados no terminal como uma tabela ASCII organizada ou um objeto JSON estruturado para processamento posterior.
Configuração do Claude Usage CLI
Para começar com esta skill, certifique-se de ter o Node.js 18+ e o macOS. Instale o pacote globalmente usando o npm:
npm install -g claude-usage-cli
Uma vez instalado, configure sua chave de API Admin (prefixada com sk-ant-admin) usando o prompt interativo seguro:
claude-usage config set-key
Esquema de Dados e Taxonomia de Claude Usage CLI
A skill organiza os dados em duas estruturas de relatório primárias como parte do fluxo de trabalho de gerenciamento de dados do Openclaw Skills:
| Tipo de Relatório | Campos Principais |
|---|---|
| Uso | Data, Modelo, Tokens de Entrada, Tokens em Cache, Tokens de Saída, Pesquisas na Web |
| Custo | Data, Descrição, Modelo, Valor (USD), Tipo de Token, Nível |
Os usuários também podem filtrar e agrupar dados usando uma variedade de dimensões de metadados, incluindo workspace_id, api_key_id e service_tier.
Recursos avançados do Claude Usage CLI
- Agrupamento multidimensional (por exemplo, agrupar por espaço de trabalho e modelo simultaneamente).
- Opções granulares de intervalo de tempo, incluindo incrementos diários (1d), horários (1h) e minuto a minuto (1m).
- Suporte para flags de período curto como 7d, 30d e 90d para relatórios rápidos.
- Modo de saída JSON completo para facilitar scripts automatizados e interoperabilidade multi-agente.
- Integração segura com o macOS Keychain para evitar a exposição da chave de API no histórico do shell ou arquivos de configuração.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
claude-cost-cli
Uma ferramenta de linha de comando segura para macOS para auditar o uso da API Admin da Anthropic e os custos de tokens com integração ao Keychain.
CalDAV CLI
Uma interface de linha de comando abrangente para gerenciar múltiplas contas de calendário CalDAV com integração segura ao chaveiro do SO e suporte para saída JSON.
Sparkle VPN Control
Um conjunto de ferramentas simplificado para controlar o Sparkle VPN e o núcleo Mihomo diretamente da linha de comando, sem interação com interface gráfica.
Gerenciador de Tarefas de Desenvolvimento e Versionamento
Uma skill padronizada de gerenciamento de tarefas de desenvolvimento que impõe versionamento semântico estrito e arquivamento obrigatório de projetos para evitar a perda de código.
Grok Image CLI
Uma ferramenta de linha de comando segura para gerar e editar imagens de alta qualidade usando os modelos da API xAI Grok.
Telegram MTProto CLI (tg-cli)
Uma interface de linha de comando segura e de somente leitura para o Telegram que utiliza o protocolo MTProto para buscar mensagens, mídia e dados de chat sem as limitações da API de Bot.
METADATA
Apresentou*
