Utilizzo di Claude Code¶

Strumenti completi di monitoraggio e analisi dell'utilizzo di Claude Code per tracciare il consumo di token, costi, metriche di prestazioni e ottimizzazione dell'utilizzo.

Panoramica¶

Gli strumenti di Claude Code Usage forniscono funzionalità di monitoraggio in tempo reale, analisi e ottimizzazione per il consumo di token Claude Code e l'utilizzo delle API. Questi strumenti aiutano gli sviluppatori a tracciare i costi, monitorare le prestazioni, analizzare i modelli di utilizzo e ottimizzare i loro workflow di Claude Code attraverso metriche dettagliate, avvisi e funzionalità di reporting.

⚠️ Avviso di Utilizzo: Gli strumenti di monitoraggio dell'utilizzo richiedono l'accesso ai file di sessione di Claude Code e ai log delle API. Assicurarsi di avere le autorizzazioni appropriate e rispettare la conformità della privacy dei dati durante l'implementazione di soluzioni di monitoraggio.

Strumenti Principali¶

Monitor di Utilizzo Claude Code¶

# Install via npm
npm install -g claude-code-usage-monitor

# Install via pip
pip install claude-code-usage-monitor

# Clone from GitHub
git clone https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor.git
cd Claude-Code-Usage-Monitor
npm install
npm start

Strumento CLI ccusage¶

# Install ccusage
npm install -g ccusage

# Basic usage analysis
ccusage analyze

# Analyze specific session
ccusage analyze --session session-id

# Generate report
ccusage report --format json

# Real-time monitoring
ccusage monitor --live

Installazione e Configurazione¶

Configurazione Monitor di Utilizzo¶

# Start usage monitor
claude-usage-monitor --port 3000

# With configuration file
claude-usage-monitor --config config.json

# Docker deployment
docker run -p 3000:3000 -v ~/.claude:/data claude-usage-monitor

Estensione VS Code¶

# Install from marketplace
code --install-extension suzuki0430.ccusage-vscode

# Manual installation
git clone https://github.com/suzuki0430/ccusage-vscode.git
cd ccusage-vscode
npm install
npm run compile
code --install-extension ccusage-vscode-*.vsix

Estensione Raycast¶

# Install Raycast extension
raycast://extensions/nyatinte/ccusage

# Configure API access
raycast://preferences/extensions/ccusage

Comandi di Monitoraggio¶

Monitoraggio in Tempo Reale¶

Comando	Descrizione
`ccusage monitor`	Avvia monitoraggio in tempo reale
`ccusage dashboard`	Dashboard web aperta
`ccusage status`	Verifica stato di utilizzo corrente
`ccusage alerts`	Visualizza avvisi attivi
`ccusage live`	Flusso di utilizzo live
`ccusage watch`	Monitora metriche specifiche
`ccusage tail`	Log di utilizzo di Tail
### Comandi di Analisi
Comando	Descrizione
---------	-------------
`ccusage analyze`	Analizzare i modelli di utilizzo
`ccusage report`	Genera report di utilizzo
`ccusage summary`	Riepilogo dell'utilizzo
`ccusage trends`	Analisi delle tendenze di utilizzo
`ccusage compare`	Confronta periodi di tempo
`ccusage breakdown`	Ripartizione dettagliata
`ccusage optimize`	Suggerimenti di ottimizzazione
## Configurazione

Configurazione Monitor¶

{
  "monitor": {
    "port": 3000,
    "host": "localhost",
    "updateInterval": 1000,
    "retentionDays": 30,
    "enableAlerts": true
  },
  "claude": {
    "sessionPath": "~/.claude/sessions",
    "logPath": "~/.claude/logs",
    "apiEndpoint": "https://api.anthropic.com",
    "trackModels": ["claude-3-sonnet", "claude-3-haiku", "claude-3-opus"]
  },
  "metrics": {
    "trackTokens": true,
    "trackCosts": true,
    "trackPerformance": true,
    "trackErrors": true,
    "granularity": "minute"
  },
  "alerts": {
    "dailyLimit": 10000,
    "costThreshold": 50.00,
    "errorRate": 0.05,
    "responseTime": 5000
  }
}

Tracciamento Costi¶

{
  "costTracking": {
    "enabled": true,
    "currency": "USD",
    "models": {
      "claude-3-opus": {
        "inputCost": 0.000015,
        "outputCost": 0.000075
      },
      "claude-3-sonnet": {
        "inputCost": 0.000003,
        "outputCost": 0.000015
      },
      "claude-3-haiku": {
        "inputCost": 0.00000025,
        "outputCost": 0.00000125
      }
    },
    "budgets": {
      "daily": 25.00,
      "weekly": 150.00,
      "monthly": 500.00
    }
  }
}

Funzionalità Dashboard¶

Dashboard Web¶

# Access dashboard
http://localhost:3000

# Dashboard sections
- Real-time metrics
- Usage graphs
- Cost analysis
- Session history
- Performance metrics
- Alert management
- Export options

Componenti Dashboard¶

Componente	Descrizione
`Token Counter`	Utilizzo di token in tempo reale
`Cost Tracker`	Costi attuali e previsti
`Session Browser`	Sfoglia cronologia sessione
`Performance Graph`	Metriche dei tempi di risposta
`Error Monitor`	Tracciamento del tasso di errore
`Usage Heatmap`	Visualizzazione del pattern di utilizzo
`Alert Panel`	Avvisi e notifiche attivi
### Visualizzazione Metriche
`// Dashboard metrics configuration const dashboardConfig = { widgets: [ { type: "counter", metric: "tokens_today", title: "Today's Tokens", format: "number" }, { type: "gauge", metric: "cost_today", title: "Today's Cost", format: "currency", max: 50 }, { type: "chart", metric: "tokens_hourly", title: "Hourly Usage", timeRange: "24h" }, { type: "table", metric: "top_sessions", title: "Top Sessions", limit: 10 } ], refreshInterval: 5000, theme: "dark" };`

Analisi di Utilizzo¶

Analisi Token¶

# Analyze token usage
ccusage tokens --period today
ccusage tokens --period week
ccusage tokens --period month

# Token breakdown by model
ccusage tokens --by-model

# Token efficiency analysis
ccusage tokens --efficiency

# Token usage trends
ccusage tokens --trends

Analisi Costi¶

# Cost breakdown
ccusage costs --breakdown

# Cost by time period
ccusage costs --period month

# Cost optimization suggestions
ccusage costs --optimize

# Budget tracking
ccusage costs --budget-status

# Cost projections
ccusage costs --forecast

Analisi Prestazioni¶

# Response time analysis
ccusage performance --response-time

# Throughput analysis
ccusage performance --throughput

# Error rate analysis
ccusage performance --errors

# Performance trends
ccusage performance --trends

# Bottleneck identification
ccusage performance --bottlenecks

Reporting¶

Generazione Report¶

# Generate daily report
ccusage report --period today --format pdf

# Weekly summary
ccusage report --period week --format html

# Monthly analysis
ccusage report --period month --format json

# Custom date range
ccusage report --from 2025-07-01 --to 2025-07-15

# Detailed breakdown
ccusage report --detailed --include-sessions

Formati Report¶

Formato	Descrizione
`JSON`	Dati leggibili da macchina
`CSV`	Compatibile con Spreadsheet
`HTML`	Report visualizzabile sul Web
`PDF`	Documento stampabile
`Markdown`	Formato della documentazione
`Excel`	Foglio di calcolo avanzato
### Reporting Automatizzato
`{ "automation": { "reports": [ { "name": "daily_summary", "schedule": "0 9 * * ", "format": "email", "recipients": ["team@company.com"], "template": "daily_template" }, { "name": "weekly_analysis", "schedule": "0 9 * 1", "format": "pdf", "storage": "s3://reports-bucket/weekly/", "template": "weekly_template" } ] } }`

Sistema di Allerta¶

Configurazione Avvisi¶

Would you like me to continue with the remaining numbered sections?json { "alerts": { "rules": [ { "name": "high_token_usage", "condition": "tokens_per_hour > 5000", "severity": "warning", "actions": ["email", "slack"] }, { "name": "budget_exceeded", "condition": "daily_cost > budget.daily * 0.9", "severity": "critical", "actions": ["email", "sms", "webhook"] }, { "name": "high_error_rate", "condition": "error_rate > 0.05", "severity": "warning", "actions": ["slack"] } ], "channels": { "email": { "smtp": "smtp.gmail.com", "from": "alerts@company.com", "to": ["admin@company.com"] }, "slack": { "webhook": "https://hooks.slack.com/...", "channel": "#claude-alerts" }, "webhook": { "url": "https://api.company.com/alerts", "method": "POST" } } } }### Tipi di Avvisi

Avviso	Trigger	Azione
`Token Limit`	Soglia giornaliera di token	Notifica email
`Cost Threshold`	Percentuale di budget	Avviso Slack
`Error Rate`	Percentuale di errore elevata	Chiamata webhook
`Performance`	Tempo di risposta lento	Evidenziazione Dashboard
`Session Limit`	Sessioni massime raggiunte	Pulizia automatica
```bash
# Analyze optimization opportunities
ccusage optimize --analyze

Token efficiency suggestions¶

ccusage optimize --tokens

Cost reduction recommendations¶

ccusage optimize --costs

Performance improvements¶

ccusage optimize --performance

Model selection optimization¶

ccusage optimize --models ### Ottimizzazione dell'Utilizzojson { "optimization": { "strategies": [ { "name": "model_selection", "description": "Choose optimal model for task", "rules": [ { "condition": "task_complexity < 0.3", "recommendation": "claude-3-haiku" }, { "condition": "task_complexity >= 0.7", "recommendation": "claude-3-opus" } ] }, { "name": "context_optimization", "description": "Optimize context window usage", "techniques": [ "context_compression", "selective_history", "smart_truncation" ] } ] } } ### Strategie di Ottimizzazioneyaml

GitHub Actions workflow¶

name: Claude Usage Monitoring on: schedule: - cron: '0 */6 * * *' jobs: monitor: runs-on: ubuntu-latest steps: - name: Check Usage run: | ccusage analyze --format json > usage.json ccusage costs --budget-check - name: Upload Report uses: actions/upload-artifact@v2 with: name: usage-report path: usage.json ## Esempi di Integrazionejavascript // Slack bot for usage monitoring const { App } = require('@slack/bolt');

const app = new App({ token: process.env.SLACK_BOT_TOKEN, signingSecret: process.env.SLACK_SIGNING_SECRET });

app.command('/claude-usage', async ({ command, ack, respond }) => { await ack();

const usage = await getClaudeUsage(); await respond({ text: Claude Usage Today: Tokens: ${usage.tokens} Cost: $${usage.cost} Sessions: ${usage.sessions} }); }); ### Integrazione CI/CDyaml

Prometheus configuration¶

global: scrape_interval: 15s scrape_configs: - job_name: 'claude-usage' static_configs: - targets: ['localhost:3000'] metrics_path: '/metrics' scrape_interval: 30s ### Integrazione Slackbash

Get current usage¶

GET /api/usage/current

Get usage history¶

GET /api/usage/history?period=7d

Get cost breakdown¶

GET /api/costs/breakdown

Get performance metrics¶

GET /api/performance/metrics

Get alerts¶

GET /api/alerts

Export data¶

GET /api/export?format=json&period=month ### Integrazione Prometheusjavascript // Real-time usage updates const ws = new WebSocket('ws://localhost:3000/ws');

ws.onmessage = (event) => { const data = JSON.parse(event.data); switch(data.type) { case 'usage_update': updateUsageDisplay(data.usage); break; case 'alert': showAlert(data.alert); break; case 'cost_update': updateCostDisplay(data.cost); break; } }; ## Riferimento APIbash