💰 Управление стоимостью Claude Code

# Зависимости (огромные, меняются редко)
node_modules/
vendor/
.pnp/

# Сборка и кэш
dist/
build/
.next/
.nuxt/
.output/
public/hot/

# Логи и временные файлы
storage/logs/
storage/framework/cache/
storage/framework/sessions/
bootstrap/cache/
*.log

# Версионный контроль
.git/

# Сгенерированные файлы
package-lock.json
composer.lock
yarn.lock
pnpm-lock.yaml

# Большие медиафайлы
*.mp4 *.mov *.avi *.mkv
*.psd *.ai *.sketch
public/storage/

# Python специфика
__pycache__/
*.pyc
.venv/
venv/
.pytest_cache/
htmlcov/

# IDE файлы
.idea/
.vscode/
*.swp

# Переключить на Haiku для простой задачи
claude --model claude-haiku-4-5

# Или внутри сессии
/model claude-haiku-4-5

# Вернуться на Sonnet
/model claude-sonnet-5

# ❌ Плохо — CC может сканировать всё
"посмотри на структуру проекта и исправь баг"

# ✅ Хорошо — читает только нужное
"в файле app/Http/Controllers/OrderController.php
метод store() (строки 34-89) не сохраняет related items.
Вот модель: app/Models/Order.php.
Вот миграция: database/migrations/2025_01_create_orders.php"

# Проект: MyApp (Laravel 11 + Vue 3 + PostgreSQL)

## Стек
- Backend: PHP 8.3, Laravel 11, Pest для тестов
- Frontend: Vue 3, TypeScript, Vite, Pinia
- DB: PostgreSQL 16, Redis для кэша
- Deploy: Docker + docker-compose

## Правила кода
- PSR-12, строгая типизация (declare(strict_types=1))
- Всегда писать Feature тесты для новых endpoint
- Модели: только $fillable, не $guarded
- Service layer обязателен для бизнес-логики

## НЕ ДЕЛАТЬ
- Не изменять migration файлы — только новые
- Не трогать .env.prod
- Не делать npm install без явной просьбы

# Анализ каждого сервис-класса без интерактивной сессии
Get-ChildItem app/Services -Filter "*.php" | ForEach-Object {
    $result = claude --print "Проверь PSR-12 в файле $($_.FullName)" 2>&1
    Write-Output "$($_.Name): $result"
}

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Illuminate\Support\Facades\Http;

class AnalyzeLogsWithCaching extends Command
{
    protected $signature = 'logs:analyze {--since=1h}';
    protected $description = 'Анализ логов с Prompt Caching (экономия ~90% на системном промпте)';

    // Большой системный промпт — будет закэширован
    private string $systemPrompt = <<<'PROMPT'
Ты — эксперт по анализу логов Laravel-приложений.

## Правила анализа:
1. Группируй однотипные ошибки (не перечисляй каждую)
2. Приоритизируй: Critical > Error > Warning > Notice
3. Для каждой группы укажи:
   - Количество вхождений
   - Первое и последнее время
   - Вероятную причину
   - Рекомендованное действие

## Формат ответа: JSON
{
  "summary": "краткое резюме",
  "critical": [...],
  "errors": [...],
  "warnings": [...],
  "recommendations": [...]
}
PROMPT;

    public function handle(): int
    {
        $since = $this->option('since');
        $logPath = storage_path('logs/laravel.log');

        if (!file_exists($logPath)) {
            $this->error('Файл логов не найден');
            return 1;
        }

        // Читаем только свежие логи
        $logs = $this->getRecentLogs($logPath, $since);

        if (empty($logs)) {
            $this->info('Новых логов нет');
            return 0;
        }

        $this->info("Анализируем " . count($logs) . " записей логов...");

        // Запрос с cache_control для системного промпта
        $response = Http::withHeaders([
            'x-api-key' => config('services.anthropic.key'),
            'anthropic-version' => '2023-06-01',
            'anthropic-beta' => 'prompt-caching-2024-07-31',
        ])->post('https://api.anthropic.com/v1/messages', [
            'model' => 'claude-haiku-4-5', // Haiku — дешевле для batch
            'max_tokens' => 2048,
            'system' => [
                [
                    'type' => 'text',
                    'text' => $this->systemPrompt,
                    // Маркируем для кэширования — сохраняется на 5 минут
                    'cache_control' => ['type' => 'ephemeral'],
                ],
            ],
            'messages' => [
                [
                    'role' => 'user',
                    'content' => "Проанализируй следующие логи (за последние {$since}):\n\n"
                        . implode("\n", array_slice($logs, -500)), // Последние 500 строк
                ],
            ],
        ]);

        if ($response->failed()) {
            $this->error('API ошибка: ' . $response->body());
            return 1;
        }

        $data = $response->json();
        $usage = $data['usage'];

        // Выводим статистику токенов
        $this->table(
            ['Метрика', 'Токены', 'Стоимость'],
            [
                ['Input (обычный)', $usage['input_tokens'], '$' . number_format($usage['input_tokens'] * 0.0000008, 5)],
                ['Cache Read', $usage['cache_read_input_tokens'] ?? 0, '$' . number_format(($usage['cache_read_input_tokens'] ?? 0) * 0.00000008, 5)],
                ['Cache Write', $usage['cache_creation_input_tokens'] ?? 0, '$' . number_format(($usage['cache_creation_input_tokens'] ?? 0) * 0.000001, 5)],
                ['Output', $usage['output_tokens'], '$' . number_format($usage['output_tokens'] * 0.000004, 5)],
            ]
        );

        // Парсим и сохраняем результат
        $result = json_decode($data['content'][0]['text'], true);
        $this->displayAnalysis($result);

        return 0;
    }

    private function getRecentLogs(string $path, string $since): array
    {
        $content = file_get_contents($path);
        $lines = explode("\n", $content);

        // Фильтруем по времени
        $cutoff = now()->sub(\DateInterval::createFromDateString($since));

        return array_filter($lines, function (string $line) use ($cutoff) {
            if (preg_match('/^\[(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\]/', $line, $m)) {
                return \Carbon\Carbon::parse($m[1])->isAfter($cutoff);
            }
            return false;
        });
    }

    private function displayAnalysis(array $result): void
    {
        $this->newLine();
        $this->line("📊 {$result['summary']}");

        foreach ($result['critical'] ?? [] as $issue) {
            $this->error("🚨 КРИТИЧНО [{$issue['count']}x]: {$issue['cause']}");
            $this->line("   → {$issue['action']}");
        }

        foreach ($result['errors'] ?? [] as $issue) {
            $this->warn("⚠️ ОШИБКА [{$issue['count']}x]: {$issue['cause']}");
        }

        if (!empty($result['recommendations'])) {
            $this->newLine();
            $this->info('💡 Рекомендации:');
            foreach ($result['recommendations'] as $rec) {
                $this->line("  • {$rec}");
            }
        }
    }
}

<?php

// Получение данных использования за период
$response = Http::withHeaders([
    'x-api-key' => config('services.anthropic.key'),
    'anthropic-version' => '2023-06-01',
])->get('https://api.anthropic.com/v1/usage', [
    'start_date' => now()->startOfMonth()->format('Y-m-d'),
    'end_date' => now()->format('Y-m-d'),
    'granularity' => 'day',
]);

$usage = $response->json();

foreach ($usage['data'] as $day) {
    $inputCost  = $day['input_tokens'] * 3 / 1_000_000;
    $outputCost = $day['output_tokens'] * 15 / 1_000_000;
    $cacheCost  = ($day['cache_read_tokens'] ?? 0) * 0.30 / 1_000_000;

    echo sprintf(
        "%s | Input: $%.4f | Output: $%.4f | Cache: $%.4f | Total: $%.4f\n",
        $day['date'],
        $inputCost,
        $outputCost,
        $cacheCost,
        $inputCost + $outputCost + $cacheCost
    );
}

// Записывает стоимость каждой CC-сессии в лог
const fs = require('fs');
const path = require('path');

const input = JSON.parse(process.stdin.read() || '{}');

// CC передаёт usage в Stop-хуке
const usage = input?.usage ?? input?.stop_usage ?? {};
const inputTokens  = usage.input_tokens ?? 0;
const outputTokens = usage.output_tokens ?? 0;
const cacheRead    = usage.cache_read_input_tokens ?? 0;
const cacheWrite   = usage.cache_creation_input_tokens ?? 0;

// Sonnet цены
const PRICES = {
  input:       3.00 / 1_000_000,
  output:     15.00 / 1_000_000,
  cacheRead:   0.30 / 1_000_000,
  cacheWrite:  3.75 / 1_000_000,
};

const totalCost =
  inputTokens  * PRICES.input +
  outputTokens * PRICES.output +
  cacheRead    * PRICES.cacheRead +
  cacheWrite   * PRICES.cacheWrite;

const logEntry = {
  timestamp: new Date().toISOString(),
  tokens: { inputTokens, outputTokens, cacheRead, cacheWrite },
  cost: totalCost.toFixed(6),
  costFormatted: `$${totalCost.toFixed(4)}`,
};

// Добавляем в файл лога
const logPath = path.join(process.env.USERPROFILE || process.env.HOME, '.claude', 'cost-log.jsonl');
fs.appendFileSync(logPath, JSON.stringify(logEntry) + '\n');

// Выводим в stderr (видно в CC)
process.stderr.write(`\n💰 Сессия завершена: ${logEntry.costFormatted} (${inputTokens + outputTokens} токенов)\n`);

process.exit(0);