Claude Code w polskiej firmie księgowej — konfiguracja od zera

Claude Code to terminalowe narzędzie Anthropic, które pozwala AI bezpośrednio czytać i pisać pliki w projekcie, uruchamiać polecenia, integrować się z bazami danych. Brzmi technicznie — ale po dwóch tygodniach skonfigurowaliśmy je w biurze księgowym, gdzie dział IT to "Pan Krzysztof, co przychodzi co środę". Opisujemy realistycznie, co się udało.

Po co księgowemu Claude Code

Nasz klient — biuro księgowe spod Poznania, 18 osób, 240 obsługiwanych firm — miał trzy bolące procesy:

• Eksport danych z Comarch Optima do raportów dla klientów (każdy raport robiony ręcznie, 12 minut/klient miesięcznie).
• Reconciliacja wyciągów bankowych z fakturami w 4 walutach (PLN, EUR, USD, GBP) — Excel z VLOOKUP-ami.
• Generowanie miesięcznych podsumowań dla zarządu klienta w stałym formacie.

Łącznie: około 64 godziny pracy biurowej miesięcznie, którą wykonywała jedna księgowa.

Założenia bezpieczeństwa przed startem

Dane księgowe nie mogą wyjść z infrastruktury klienta. Skonfigurowaliśmy Claude Code z prywatną instancją RedAI — proxy do Anthropic w Waszej sieci, z opcją anthropic_no_storage=true i pełnym logiem wszystkich wywołań. Dla wrażliwych operacji (PESEL, NIP) zatrzymujemy lokalnie hashowanie przed wysłaniem.

Krok 1: instalacja i podstawowa konfiguracja

Claude Code instaluje się przez npm. Na maszynie księgowej (Windows 11, dla nas dostęp przez WSL2 Ubuntu 22.04):

npm install -g @anthropic-ai/claude-code
claude --version
# claude-code 1.0.18

# konfiguracja proxy do RedAI
export ANTHROPIC_BASE_URL="https://proxy.redai.local/v1"
export ANTHROPIC_API_KEY="$(cat /etc/redai/api.key)"
claude config set model claude-sonnet-4-20250514

Krytyczne: na produkcji nie używamy kont osobistych Anthropic. Każdy klient ma swój klucz API przepięty przez nasz proxy z audytem.

Krok 2: MCP server do Comarch Optima

MCP (Model Context Protocol) to standard ogłoszony przez Anthropic pod koniec 2024. Pozwala podpiąć Claude do dowolnego systemu przez prosty serwer JSON-RPC. Dla Comarch Optima napisaliśmy własny MCP server w Node.js (Optima nie ma oficjalnego):

// claude-mcp-comarch/index.js (skrót)
const server = new McpServer({ name: "comarch-optima", version: "0.4.1" });

server.tool("get_invoices_for_company",
  { nip: z.string().regex(/^\d{10}$/), month: z.string() },
  async ({ nip, month }) => {
    const rows = await sql`
      SELECT nr_faktury, data, kwota_brutto, vat, status
      FROM dok_handlowe
      WHERE nip = ${nip} AND TO_CHAR(data, 'YYYY-MM') = ${month}
      ORDER BY data DESC LIMIT 500`;
    return { content: [{ type: "text", text: JSON.stringify(rows) }] };
  });

Konfiguracja w Claude Code (~/.claude.json):

{
  "mcpServers": {
    "comarch": {
      "command": "node",
      "args": ["/opt/redai/mcp-comarch/index.js"],
      "env": { "OPTIMA_CONN": "Server=192.168.10.4;Database=CDN_FIRMA" }
    }
  }
}

Krok 3: pierwszy raport automatyczny

Procedura wygląda tak: księgowa otwiera terminal (skrót na pulpicie), wpisuje "claude" i mówi po polsku:

"Wygeneruj raport miesięczny dla firmy ABC NIP 5260000000 za czerwiec 2025. Sprawdź wszystkie faktury w Optimie, porównaj z bankiem (plik wyciag-pko-2025-06.csv w folderze), wynik daj jako PDF w szablonie z folderu szablony/raport-zarzad.docx."

Claude Code: czyta szablon, woła nasz MCP server po faktury, czyta CSV, generuje porównanie, wykrywa 3 niedopasowania, pyta księgową które są błędem w fakturze a które w banku, dopisuje wyjaśnienia, kompiluje PDF. Czas całości: 2 minuty 14 sekund. Wcześniej: 12 minut.

Liczby po pierwszym miesiącu

Proces	Przed (godz./mies.)	Po (godz./mies.)	Oszczędność
Raporty miesięczne (240 klientów)	48,0	11,2	36,8 godz.
Reconciliacja wyciągów	14,0	4,6	9,4 godz.
Podsumowania kwartalne (60 klientów)	11,4	3,8	7,6 godz.
Razem	73,4	19,6	53,8 godz.

Co poszło źle — uczciwie

Pierwszy tydzień nie był różowy. Trzy konkretne wpadki:

1. Comarch zmienia schemat bazy między wersjami — po aktualizacji Optimy z 2025.1 na 2025.2 (czerwcowa) złamał się jeden SELECT (pole data stało się data_dokumentu). Musimy testować MCP po każdej aktualizacji.
2. Claude próbował "naprawiać" rzeczy bez pytania — w pierwszych dniach dwukrotnie usunął niedopasowane wiersze z raportu zamiast je oflagować. Dodaliśmy w prompt systemowym: "NIGDY nie usuwaj danych bez potwierdzenia użytkownika".
3. Księgowa bała się terminala — dosłownie pierwsze 3 dni nie chciała otwierać. Zrobiliśmy GUI w Electronie (50 linijek), które uruchamia claude w tle. Adopcja wzrosła z 0 do 100% w ciągu doby.

Koszt całości wdrożenia

Dla 18-osobowego biura, 240 obsługiwanych firm:

• Setup RedAI (proxy, audyt, MCP Optima): jednorazowo, w pakiecie wdrożenia podstawowego.
• API Claude (Sonnet 4, ~3,1M tokenów/dzień): 1 366 zł/mies.
• Utrzymanie po stronie RedAI (aktualizacje MCP, monitoring): w abonamencie.

53,8 zaoszczędzonych godzin × stawka księgowej 95 zł/h = 5 111 zł/mies. ROI: ~3,7× w pierwszym miesiącu, rosnące, bo wdrożenie obejmuje teraz dalsze procesy. Chętnie pokażemy podobne wdrożenie na Waszych dokumentach.