Zum Inhalt

Claude Code Nutzung

generieren

Umfassender Claude Code Verwendungsüberwachungs- und Analysetools zur Verfolgung von Tokenverbrauch, Kosten, Performance Metriken und Nutzungsoptimierung.

Überblick

Claude-Code Nutzungstools bieten Echtzeit-Überwachungs-, Analyse- und Optimierungsfunktionen für Claude Code Token Verbrauch und API-Nutzung. Diese Tools helfen Entwicklern, Kosten zu verfolgen, Leistung zu überwachen, Nutzungsmuster zu analysieren und ihre Claude Code Workflows durch detaillierte Metriken, Warnungen und Reporting-Funktionen zu optimieren.

ZEIT ** Nutzungshinweis**: Usage Monitoring-Tools benötigen Zugriff auf Claude Code Session-Dateien und API-Logs. Stellen Sie bei der Umsetzung von Überwachungslösungen die richtigen Berechtigungen und die Einhaltung der Datenschutzerklärung sicher.

Kernwerkzeuge

Claude Code Usage Monitor

```bash

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 ```_

Ccusing CLI Werkzeugmaschinen

```bash

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 ```_

Installation und Inbetriebnahme

Verwendung Monitor Setup

```bash

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 ```_

VS Code Erweiterung

```bash

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 ```_

Raycast Erweiterung

```bash

Install Raycast extension

raycast://extensions/nyatinte/ccusage

Configure API access

raycast://preferences/extensions/ccusage ```_

Überwachungsbefehle

Echtzeitüberwachung

| | Command | Description | | | --- | --- | | | ccusage monitor | Start real-time monitoring | | | | ccusage dashboard | Open web dashboard | | | | ccusage status | Check current usage status | | | | ccusage alerts | View active alerts | | | | ccusage live | Live usage stream | | | | ccusage watch | Watch specific metrics | | | | ccusage tail | Tail usage logs | |

Analysekommandos

| | Command | Description | | | --- | --- | | | ccusage analyze | Analyze usage patterns | | | | ccusage report | Generate usage report | | | | ccusage summary | Usage summary | | | | ccusage trends | Usage trend analysis | | | | ccusage compare | Compare time periods | | | | ccusage breakdown | Detailed breakdown | | | | ccusage optimize | Optimization suggestions | |

Konfiguration

Monitorkonfiguration

json { "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 } }_

Kostenverfolgung

json { "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 } } }_

Dashboard Features

Web Dashboard

```bash

Access dashboard

http://localhost:3000

Dashboard sections

  • Real-time metrics
  • Usage graphs
  • Cost analysis
  • Session history
  • Performance metrics
  • Alert management
  • Export options ```_

Dashboard Komponenten

| | Component | Description | | | --- | --- | | | Token Counter | Real-time token usage | | | | Cost Tracker | Current and projected costs | | | | Session Browser | Browse session history | | | | Performance Graph | Response time metrics | | | | Error Monitor | Error rate tracking | | | | Usage Heatmap | Usage pattern visualization | | | | Alert Panel | Active alerts and notifications | |

Metrics Display

javascript // 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" };_

Nutzungsanalyse

Tokenanalyse

```bash

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 ```_

Kostenanalyse

```bash

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 ```_

Leistungsanalyse

```bash

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 ```_

Berichterstattung

Bericht Generation

```bash

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 ```_

Berichtsformate

| | Format | Description | | | --- | --- | | | JSON | Machine-readable data | | | | CSV | Spreadsheet compatible | | | | HTML | Web-viewable report | | | | PDF | Printable document | | | | Markdown | Documentation format | | | | Excel | Advanced spreadsheet | |

Automatisierte Meldung

json { "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" } ] } }_

Alarmanlage

Alarmkonfiguration

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" } } } }_

Alarmarten

| | Alert | Trigger | Action | | | --- | --- | --- | | | Token Limit | Daily token threshold | Email notification | | | | Cost Threshold | Budget percentage | Slack alert | | | | Error Rate | High error percentage | Webhook call | | | | Performance | Slow response time | Dashboard highlight | | | | Session Limit | Max sessions reached | Auto-cleanup | |

Optimierungsfunktionen

Nutzungsoptimierung

```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 ```_

Optimierungsstrategien

json { "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" ] } ] } }_

Integrationsbeispiele

CI/CD Integration

```yaml

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 ```_

Slack Integration

```javascript // 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} }); }); ```_

Prometheus Integration

```yaml

Prometheus configuration

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

API Sachgebiet

REST API Endpunkte

```bash

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.=month ```_

WebSocket API

```javascript // 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; } }; ```_

Fehlerbehebung

Gemeinsame Themen

```bash

Monitor not starting

  • Check port availability
  • Verify session file permissions
  • Check configuration file syntax
  • Review log files

Missing data

  • Verify Claude Code session path
  • Check file permissions
  • Ensure proper API access
  • Review data retention settings

Performance issues

  • Reduce monitoring frequency
  • Optimize database queries
  • Clear old data
  • Check system resources ```_

Debug Befehle

```bash

Enable debug mode

DEBUG=ccusage:* ccusage monitor

Verbose logging

ccusage --verbose analyze

Test configuration

ccusage config --test

Validate data sources

ccusage validate --sources ```_

Ressourcen