Claude Code na Mac, instalacja krok po kroku 2026

Spis treści

• Wymagania
• Instalacja przez npm
• Alternatywa: Homebrew
• Konfiguracja API key
• Pierwszy test
• Typowe problemy
• FAQ

Mac to fundamentalnie Unix, więc instalacja Claude Code zajmuje 5 minut. Działa natywnie na Apple Silicon (M1, M2, M3, M4) i Intel. Poniżej krok po kroku z npm + alternatywa Homebrew + typowe problemy.

Wymagania

• macOS 12 Monterey lub nowszy (rekomendowane Sonoma 14 / Sequoia 15)
• Node.js 18+ (rekomendowane 22 LTS)
• npm (idzie z Node)
• Terminal (Terminal.app, iTerm2, Warp, Ghostty)
• API key z console.anthropic.com (lub Claude Pro subscription)

Instalacja przez npm (rekomendowane)

Krok 1: Zainstaluj Node.js

Najprostsza droga: nodejs.org, pobierz LTS installer (.pkg). Alternatywa: nvm (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.zshrc
nvm install 22
nvm use 22
node --version

Krok 2: Zainstaluj Claude Code

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

Jeśli permission denied, NIE używaj sudo. Zamiast tego skonfiguruj npm na własny katalog:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

Alternatywa: Homebrew

Jeśli używasz Homebrew (większość Mac devów), community formula może być dostępna. Sprawdź:

brew search claude-code
brew install claude-code  # jeśli dostępne

Note: oficjalna formula może nie istnieć, npm zawsze działa.

Konfiguracja API key

Dwie opcje uwierzytelnienia:

Opcja A: API key (pay-per-use)

1. Idź na console.anthropic.com, zaloguj się / utwórz konto
2. Wpłać minimum $5 credits w Settings → Billing
3. Wygeneruj API key w Settings → API Keys
4. Dodaj do ~/.zshrc:

export ANTHROPIC_API_KEY=sk-ant-xxx
source ~/.zshrc

Opcja B: Claude Pro subscription

Jeśli masz Claude Pro / Max ($20/$200/mc), zaloguj się przez OAuth:

claude /login

Otworzy się przeglądarka, autoryzuj. Claude Code użyje limitów subskrypcji zamiast pay-per-use.

Pierwszy test

mkdir test-claude && cd test-claude
git init
claude

Sesja Claude Code uruchomi się. Wpisz prosty task:

> Stwórz hello.py który wypisze "Cześć z Mac!"
> Dodaj README.md z opisem
> Zrób git commit z message "feat: hello script"

Claude planuje, edytuje pliki, uruchamia git, commitujе. Jeśli wszystko działa, masz working setup.

Typowe problemy

• command not found: claude. Sprawdź PATH: echo $PATH. Dodaj $(npm config get prefix)/bin jeśli brak
• SSL certificate error. Update Node i certyfikaty: brew install ca-certificates
• Permission denied podczas edycji. Sprawdź .claude/settings.json, dodaj path do allow
• Slow performance na Intel Mac. Apple Silicon znacznie szybszy, ale Intel też działa

Najczęściej zadawane pytania

Powiązane artykuły

Claude Code•9 min

Claude Code cena 2026, ile kosztuje i czy jest darmowy

Claude Code cena w PLN i USD, plany Pro i Max, API pay-as-you-go, darmowe kredyty i alternatywy. Najtańsza legalna ścieżka. Stan maj 2026.

Czytaj

Claude Code•9 min

Claude Max plan po polsku, ceny i limity 2026

Plan Claude Max po polsku: ceny Max 5x i 20x, ile zapytań daje, Claude Pro vs Max, Max vs API. Limity sesji i tygodniowe. Stan maj 2026, dla kogo warto.

Czytaj

Claude Code•15 min

Claude Code Skills po polsku, tutorial Agent Skills 2026

Pierwszy polski tutorial Agent Skills w Claude Code. SKILL.md, frontmatter, progressive disclosure, jak tworzyć skille krok po kroku, vs subagents i MCP.

Czytaj