Claude Code Companion: Jak sterować Claude Code z Telegrama?

Claude Code zyskało 30 milionów miesięcznie aktywnych użytkowników do połowy 2025 roku, stając się jednym z najważniejszych narzędzi dla programistów pracujących z AI (Anthropic, 2025). Jednak jego natura terminalowa oznacza, że musisz być przy komputerze, żeby z niego korzystać. A co, gdybyś mógł sterować Claude Code z telefonu, leżąc na kanapie lub jadąc pociągiem?

Właśnie to rozwiązuje Claude Code Companion (CCC) — narzędzie open-source, które łączy Twoje sesje Claude Code z Telegramem.

TL;DR: Claude Code Companion to darmowe narzędzie open-source, które pozwala zdalnie sterować sesjami Claude Code przez Telegrama. Wspiera wielokrotne sesje, wiadomości głosowe z transkrypcją, przesyłanie plików i działa w 100% lokalnie na Twoim komputerze. Idealne dla programistów, którzy chcą być produktywni poza biurkiem.

Czym jest Claude Code Companion?

Claude Code Companion (CCC) to projekt open-source hostowany na GitHubie, który tworzy most między Telegramem a sesjami Claude Code uruchomionymi w tmux. Pozwala wysyłać wiadomości do Claude’a z telefonu i otrzymywać odpowiedzi bezpośrednio w Telegramie.

Projekt zdobył już 46 gwiazdek na GitHubie i jest aktywnie rozwijany (GitHub, 2026). Jego główną zaletą jest to, że działa w 100% lokalnie — Twój kod i rozmowy nigdy nie opuszczają Twojego komputera (chyba że Ty je wyślesz przez Telegram).

Co wyróżnia CCC na tle innych rozwiązań? To nie jest kolejny chatbot AI w chmurze. To prawdziwy most do Twojej lokalnej instancji Claude Code, co oznacza, że Claude ma dostęp do Twojego systemu plików, może uruchamiać komendy i modyfikować kod — wszystko sterowane z telefonu.

Jak to działa architektonicznie?

CCC wykorzystuje prostą ale sprytną architekturę: demon ccc listen odpytuje Telegram o wiadomości, tmux przechowuje sesje Claude Code, a hooki wysyłają odpowiedzi Claude’a z powrotem do Telegrama.

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Telegram   │────▶│     ccc     │────▶│    tmux     │
│   (phone)   │◀────│   listen    │◀────│   windows   │
└─────────────┘     └─────────────┘     └─────────────┘
                           │                   │
                           │                   ▼
                           │            ┌─────────────┐
                           └───────────▶│ Claude Code │
                              hook      └─────────────┘

Gdy wysyłasz wiadomość w temacie Telegrama, CCC przekazuje ją do odpowiedniego okna tmux, gdzie działa Claude Code. Hook zainstalowany w Claude Code przechwytuje odpowiedzi i wysyła je z powrotem do Ciebie.

Terminal z kodem i klawiatura mechaniczna - workflow terminalowy Claude Code Companion — Workflow terminalowy — Claude Code Companion integruje się z Twoim istniejącym środowiskiem

Według dokumentacji Claude Code, produkt osiągnął szacunkową wartość 2,5 miliarda dolarów rocznej sprzedaży na początku 2026 roku (Panto AI, 2026), co pokazuje, jak szybko rośnie zapotrzebowanie na tego typu narzędzia.

Jakie funkcje oferuje CCC?

Wielokrotne sesje — Każda sesja ma swój temat (topic) w Telegramie. Możesz pracować nad kilkoma projektami jednocześnie, przełączając się między nimi bezpośrednio z telefonu.

Wiadomości głosowe — Nagraj wiadomość głosową, a CCC automatycznie ją transkrybuje używając Whisper (lokalnie), OpenAI API lub Groq API (najszybsza opcja). To idealne, gdy chcesz szybko zadać pytanie bez pisania.

Przesyłanie plików — Komenda ccc send pozwala wysłać dowolny plik z komputera na telefon. Dla plików poniżej 50 MB używa bezpośredniego uploadu do Telegrama, a dla większych — streaming relay P2P bez przechowywania na serwerach pośrednich.

Zdjęcia i obrazy — Możesz wysłać zrzut ekranu lub zdjęcie do Claude’a, który je przeanalizuje. Przydatne przy debugowaniu błędów lub omawianiu projektów UI.

Integracja z tmux — Sesje są odporne na awarie sieci. Możesz się rozłączyć, a Claude Code będzie kontynuować pracę. Później możesz podłączyć się do sesji z dowolnego terminala komendą ccc.

Jak zainstalować Claude Code Companion?

Instalacja jest zaskakująco prosta. Potrzebujesz: macOS, Linux lub Windows (WSL), Go 1.21+, tmux i zainstalowany Claude Code.

Najbardziej imponujące w CCC jest to, że cała konfiguracja odbywa się jedną komendą. Nie musisz ręcznie tworzyć bota Telegram, konfigurować webhooków ani edytować plików konfiguracyjnych.

Krok 1: Zainstaluj CCC

go install github.com/kidandcat/ccc/cmd/ccc@latest

Krok 2: Uruchom konfigurację

ccc setup TWOJ_BOT_TOKEN

Gdzie TWOJ_BOT_TOKEN uzyskasz od @BotFather na Telegramie. Ta jedna komenda:

Łączy się z Telegramem
Opcjonalnie konfiguruje grupę z tematami dla wielu sesji
Instaluje hook dla powiadomień Claude’a
Instaluje i uruchamia usługę w tle

Krok 3: Ciesz się zdalnym dostępem

Teraz możesz tworzyć nowe sesje z Telegrama komendą /new nazwa-projektu lub wysyłać szybkie pytania w prywatnym czacie.

Jakie komendy są dostępne w Telegramie?

W grupie:

Komenda	Opis
`/new <nazwa>`	Utwórz nową sesję + temat
`/new ~/sciezka/nazwa`	Utwórz sesję w konkretnej lokalizacji
`/continue`	Restartuj sesję zachowując historię
`/c <komenda>`	Uruchom komendę shell na komputerze
`/update`	Zaktualizuj CCC z GitHuba
`/stats`	Pokaż statystyki systemu (uptime, CPU, RAM)
`/auth`	Ponowna autoryzacja Claude Code

W prywatnym czacie:
Po prostu wyślij wiadomość — CCC uruchomi jednorazowe zapytanie do Claude’a i zwróci odpowiedź.

Czy to bezpieczne?

CCC stawia prywatność na pierwszym miejscu. Wszystko działa lokalnie na Twoim komputerze — jedynym punktem wyjścia danych jest Telegram dla wiadomości, które Ty wysyłasz.

Twój token bota i konfiguracja są przechowywane w ~/.config/ccc/config.json. Sesje są mapowane do tematów Telegrama, więc możesz łatwo zarządzać wieloma projektami.

Ważne: CCC daje Claude’owi dostęp do Twojego systemu plików i możliwości uruchamiania komend. Używaj go tylko na zaufanych maszynach i bądź świadomy, co wysyłasz do Claude’a.

Dla kogo jest Claude Code Companion?

CCC jest idealne dla:

Programistów pracujących zdalnie — kontynuuj pracę z telefonu
Pasjonatów AI — eksperymentuj z Claude’em gdziekolwiek jesteś
Zespołów DevOps — monitoruj i reaguj na incydenty z telefonu
Twórców treści — generuj pomysły i szkice w drodze

Według danych z 2025, 70% firm z listy Fortune 100 używa Claude w swojej pracy (Incremys, 2026), co pokazuje skalę adopcji tego narzędzia w środowisku profesjonalnym.

Często zadawane pytania

Czy CCC działa na Windowsie?

Tak, ale przez WSL2 z Ubuntu. Zarówno Claude Code, jak i CCC działają najlepiej na Linuxie, więc zalecana jest instalacja WSL przed konfiguracją.

Czy mogę używać CCC bez Telegrama?

Nie, CCC jest zaprojektowane jako interfejs Telegramowy. Jeśli potrzebujesz innego interfejsu, musiałbyś zmodyfikować kod źródłowy.

Jak działa transkrypcja wiadomości głosowych?

CCC obsługuje trzy backendy: lokalny Whisper (wolny, ale prywatny), OpenAI API (średni) i Groq API (najszybszy, zalecany). Konfigurujesz to w ~/.config/ccc/config.json.

Czy mogę wysyłać pliki z telefonu do Claude’a?

Tak, po prostu wyślij plik lub zdjęcie w czacie Telegram. CCC przekaże go do Claude’a, który może go przeanalizować.

Co jeśli stracę połączenie internetowe?

Sesje tmux są odporne na rozłączenia. Gdy połączenie wróci, CCC automatycznie wznowi nasłuchiwanie. Twoja praca w Claude’ie będzie kontynuowana.

Podsumowanie

Claude Code Companion to eleganckie rozwiązanie problemu, o którym wielu z nas nie wiedziało, że ma: mobilność w pracy z AI coding assistantami. Zamiast być przykutym do biurka, możesz teraz sterować Claude’em z dowolnego miejsca z zasięgiem internetu.

Projekt jest aktywnie rozwijany, w pełni open-source i darmowy. Jeśli używasz Claude Code na co dzień, CCC to pozycja obowiązkowa w Twoim toolkitcie.

Źródła: GitHub – kidandcat/ccc, Anthropic, Incremys, Panto AI