Ściągawka Claude Code: polecenia, konfiguracja i skróty

Każda flaga CLI, polecenie slash, skrót klawiszowy, klucz konfiguracyjny, zdarzenie hook i zmienna środowiskowa w jednym miejscu. Szczegółowe wyjaśnienia znajdują się w pełnym przewodniku Claude Code. Informacje o pierwszej konfiguracji znajdują się w przewodniku szybkiego startu.

1. Instalacja

Dostępne są 3 metody instalacji, wymienione w kolejności preferencji.

# Native binary (recommended)
curl -fsSL https://claude.ai/install.sh | bash

# Homebrew (macOS)
brew install --cask claude-code

# NPM (deprecated — migrate with `claude install`)
npm install -g @anthropic-ai/claude-code

Instalacja określonej wersji:

curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Weryfikacja instalacji:

claude doctor
claude --version

Uwierzytelnianie:

claude auth login       # Log in or switch accounts
claude auth status      # Check current auth state
claude auth logout      # Clear stored credentials

2. Flagi CLI

Podpolecenie dodane w wersji v2.1.212: claude auto-mode reset resetuje stan trybu automatycznego z poziomu terminala; opcja --yes pozwala pominąć monit o potwierdzenie.⁷

3. Polecenia Slash

Polecenia niestandardowe: Należy utworzyć .claude/commands/my-command.md (dla projektu) lub ~/.claude/commands/my-command.md (osobiste), a następnie wywołać poleceniem /my-command. Polecenia obsługują frontmatter YAML, w którym można określić opis, dozwolone narzędzia i zastępczy model, a także interpolację argumentów za pomocą $ARGUMENTS albo argumentów pozycyjnych $1, $2.

---
description: Fix a GitHub issue
allowed-tools: Read, Edit, Bash(git:*)
model: opus
argument-hint: [issue-number]
---

Fix GitHub issue #$ARGUMENTS following our coding standards.

Użycie: /fix-issue 123

4. Skróty klawiaturowe

Sterowanie ogólne

Szybkie prefiksy

Wprowadzanie wielowierszowe

Skróty klawiaturowe można dostosować za pomocą /keybindings (są przechowywane w ~/.claude/keybindings.json).

5. Pliki konfiguracyjne

Hierarchia pierwszeństwa (od najwyższego do najniższego)

Obowiązuje pierwsze dopasowanie. Ustawień korporacyjnych nie można obejść.

6. Dokumentacja settings.json

Kluczowe ustawienia wraz z typami i przykładami. Należy je umieścić w dowolnym pliku ustawień z opisanej wyżej hierarchii.

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": ["Read", "Glob", "Grep", "Bash(npm run:*)", "Bash(git:*)", "Edit(src/**)"],
    "deny": ["Read(.env*)", "Bash(rm -rf:*)", "Bash(sudo:*)"],
    "ask": ["WebFetch", "Bash(docker:*)"],
    "defaultMode": "acceptEdits",
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {},
  "sandbox": {
    "enabled": false,
    "autoAllowBashIfSandboxed": true
  },
  "includeCoAuthoredBy": true,
  "cleanupPeriodDays": 30,
  "respectGitignore": true,
  "showTurnDuration": true,
  "language": "en",
  "autoMemoryDirectory": ".claude/memory",
  "plansDirectory": ".claude/plans"
}

Składnia reguł uprawnień: Tool(pattern:*) zapewnia dopasowywanie prefiksów. Bash(npm run test:*) zezwala na npm run test, npm run test:unit itd. Wzorce plików korzystają ze składni glob: Edit(src/**). Od wersji v2.1.214 jednosegmentowa reguła zezwalająca dir/** dopasowuje wyłącznie <cwd>/dir — nie obejmuje już każdego dir/ w dowolnym miejscu drzewa; aby dopasowywać na dowolnej głębokości, należy użyć Edit(**/src/**). Reguły deny/ask zachowują dopasowywanie na dowolnej głębokości, a warunki if: w hooks podlegają temu samemu ograniczeniu do cwd.

Nowe klucze (v2.1.118+):

Pełny schemat ustawień opisano w sekcji Szczegółowa konfiguracja kompletnego przewodnika.

7. Skrócona dokumentacja CLAUDE.md

CLAUDE.md to plik instrukcji projektu. Claude odczytuje go na początku każdej sesji.

Lokalizacje:

Co warto uwzględnić:

# Project Name

## Stack
- Backend: FastAPI, Python 3.11+
- Frontend: HTMX + Alpine.js + Bootstrap 5

## Commands
- Dev: `uvicorn app.main:app --reload --port 8000`
- Test: `python -m pytest -v`
- Lint: `ruff check .`

## Conventions
- Conventional commits: feat:, fix:, docs:, refactor:
- Never force push to main
- Always activate venv before Python commands

## Key Files
- app/main.py — FastAPI app and routes
- app/models.py — SQLAlchemy models

Treść powinna być łatwa do szybkiego przejrzenia. Zwarta, rozbudowana proza niepotrzebnie zużywa tokeny kontekstu podczas każdej sesji. Warto stosować listy punktowane, tabele i krótkie bloki kodu. Należy unikać długich akapitów — Claude odczytuje CLAUDE.md na początku każdej sesji, więc każde słowo zajmuje miejsce w kontekście.

Wskazówki dla zaawansowanych: - Prefiks # w REPL pozwala dodawać informacje do automatycznej pamięci bez edytowania CLAUDE.md: # Always use TypeScript strict mode - CLAUDE.md znajdujący się w podkatalogu jest wczytywany, gdy Claude odczytuje pliki z tego katalogu - Reguły współdzielone przez zespół należy umieszczać w .claude/rules/*.md, aby zachować modułową organizację

8. Tryby uprawnień

Tryb Auto (v2.1.85+) jest zalecanym zamiennikiem --dangerously-skip-permissions. Operacje tylko do odczytu oraz edycje plików są zatwierdzane automatycznie. Najpierw rozstrzygane są niestandardowe reguły zezwalające i blokujące. Wszystkie pozostałe operacje trafiają do klasyfikatora bezpieczeństwa. Domyślnie automatycznie blokowane są: curl | bash, wymuszone wypychanie zmian do głównej gałęzi, wdrożenia produkcyjne, masowe usuwanie zasobów chmurowych, zmiany IAM oraz wysyłanie poufnych danych na zewnątrz.¹

Wyłącznik bezpieczeństwa: 3 kolejne blokady lub łącznie 20 blokad w jednej sesji powoduje wstrzymanie trybu i powrót do ręcznych monitów.

# Enable at startup (--enable-auto-mode was removed in v2.1.111)
claude --permission-mode auto

# Cycle during session
Shift+Tab    # Manual (aka default) -> acceptEdits -> auto -> plan

Automatyczne zatwierdzanie w PowerShell (v2.1.119+): Polecenia narzędzia PowerShell są automatycznie zatwierdzane w trybie uprawnień tak samo jak polecenia Bash. Reguły zezwalające, takie jak PowerShell(Get-*:*), pomijają monity w przypadku operacji tylko do odczytu. W procesach intensywnie korzystających z PowerShell warto używać wersji v2.1.149 lub nowszej; naprawiono w niej omijanie uprawnień przez wbudowane cd, dopasowywanie reguł zezwalających za pomocą prefiksów i symboli wieloznacznych oraz śledzenie nieaktualnych zmiennych katalogów.

9. Zdarzenia hooks

| InstructionsLoaded | Gdy zostaje wczytany CLAUDE.md | Nie | | ConfigChange | Gdy plik konfiguracji zmienia się w trakcie sesji | Tak | | DirectoryAdded | Gdy /add-dir lub register_repo_root w SDK dodaje katalog roboczy w trakcie sesji (v2.1.219+) | Nie | | WorktreeCreate | Gdy tworzony jest worktree | Tak | | WorktreeRemove | Gdy usuwany jest worktree | Nie | | PreCompact | Przed kompresją kontekstu | Nie | | PostCompact | Po kompresji kontekstu | Nie | | Elicitation | Gdy MCP żąda uporządkowanych danych wejściowych | Tak | | ElicitationResult | Gdy użytkownik odpowiada w oknie dialogowym MCP | Tak | | StopFailure | Gdy tura kończy się z powodu błędu API | Nie | | PermissionRequest | Gdy zostaje wyświetlone okno uprawnień | Tak | | PermissionDenied | Gdy tryb auto odrzuca operację (v2.1.88+) | Nie | | CwdChanged | Gdy zmienia się katalog roboczy (v2.1.83+) | Nie | | FileChanged | Gdy obserwowany plik zostaje zmodyfikowany zewnętrznie (v2.1.83+) | Nie | | TaskCreated | Gdy zostaje utworzone nowe zadanie (v2.1.84+) | Nie | | TeammateIdle | Gdy członek zespołu agents przechodzi w stan bezczynności | Tak | | TaskCompleted | Gdy zadanie zostaje oznaczone jako ukończone | Tak |

Pełny protokół hooks (wejściowy i wyjściowy JSON, matchers oraz kody zakończenia) opisano w sekcji Szczegółowe omówienie hooks kompletnego przewodnika.

10. Konfiguracja hooks

Hooks znajdują się w settings.json lub w osobnym pliku hooks.json. Minimalny przykład:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "npx prettier --write \"$FILE_PATH\""
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": ".claude/hooks/validate-bash.sh"
          }
        ]
      }
    ]
  }
}

Składnia matcher:

Kody zakończenia:

Asynchroniczne hooks działają w tle bez blokowania: do obiektu hook należy dodać "async": true.²

Pola wyjściowe i wejściowe hook:

• duration_ms w danych wejściowych hook PostToolUse / PostToolUseFailure (v2.1.119+) — czas wykonywania narzędzia bez czasu poświęconego na monity o uprawnienia i hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — zastępowanie danych wyjściowych dowolnego narzędzia (w wersji v2.1.118 funkcję tę wprowadzono wyłącznie dla MCP; wersja v2.1.121 rozszerza ją na wszystkie narzędzia).
• hookSpecificOutput.sessionTitle (v2.1.96+) — ustawianie tytułu sesji za pomocą hook UserPromptSubmit.
• args: string[] w hooks poleceń (v2.1.139+) — przekazywanie uporządkowanych argumentów argv bez cytowania powłoki.
• continueOnBlock w hooks PostToolUse (v2.1.139+) — przekazywanie przyczyny blokady z powrotem do Claude i kontynuowanie tury.
• subagent_type w danych wejściowych hook agenta (v2.1.140+) — identyfikowanie typu uruchomionego agenta.
• terminalSequence w wyjściowym JSON hook (v2.1.141+) — emitowanie terminalowych sekwencji sterujących na potrzeby powiadomień, tytułów okien i sygnałów dźwiękowych.

11. Szybka konfiguracja MCP

Dodawanie serwera MCP za pomocą jednego polecenia:

# Remote HTTP server (recommended)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# Remote with auth header
claude mcp add --transport http api https://api.example.com/mcp \
  --header "Authorization: Bearer $TOKEN"

# Local stdio server
claude mcp add --transport stdio postgres \
  --env "DATABASE_URL=postgresql://user:pass@localhost/db" \
  -- npx -y @anthropic-ai/mcp-server-postgres

Kontrola zakresu:

claude mcp add --scope project ...   # Team-shared (.mcp.json)
claude mcp add --scope user ...      # Personal (~/.claude.json)

Przykładowy plik .mcp.json projektu:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "database": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/db"
      }
    }
  }
}

MCP osiąga obecnie 100 milionów pobrań miesięcznie i obejmuje ponad 3 000 zindeksowanych serwerów.³ Więcej informacji o rodzajach transportu, pozyskiwaniu danych wejściowych i konfiguracji wyszukiwania narzędzi zawiera sekcja poświęcona MCP w pełnym przewodniku.

alwaysLoad (v2.1.121+): Umożliwia wyłączenie zaufanego serwera z mechanizmu odraczania przez Tool Search. Wszystkie jego narzędzia są ładowane podczas uruchamiania sesji, bez dodatkowego wywołania ToolSearch:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "alwaysLoad": true
    }
  }
}

Automatyczne ponawianie (v2.1.121+): W przypadku błędu podczas uruchamiania serwery MCP podejmują do 3 ponownych prób, zanim zostaną oznaczone jako rozłączone.

SDK mcp_authenticate redirectUri (v2.1.121+): Wymagane do ukończenia OAuth w niestandardowych schematach URI — w aplikacjach komputerowych i przepływach konektorów claude.ai.

11.5. Polecenia CLI dla plugins

12. Typy subagents

Claude automatycznie deleguje zadania do subagents. Można także zażądać ich użycia wprost:

> Use the explore agent to find all auth-related files
> Have a subagent analyze the database schema

Niestandardowe subagents definiuje się jako pliki markdown z metadanymi YAML frontmatter w .claude/agents/ (projektowe) lub ~/.claude/agents/ (osobiste). Równolegle może działać do 10 subagents.⁴

claude agents otwiera w aktualnych wydaniach Agent View: eksperymentalny ekran operacyjny prezentujący uruchomione, zablokowane i ukończone sesje Claude Code. Polecenie claude agents --cwd <path> ogranicza widok do jednego folderu (v2.1.141+), v2.1.142 dodaje flagi uruchamiania sesji w tle, a v2.1.143 stosuje je spójnie w panelu i sesjach w tle: --add-dir, --settings, --mcp-config, --plugin-dir, --permission-mode, --model, --effort oraz --dangerously-skip-permissions. v2.1.144 dodaje obsługę /resume dla sesji w tle i oznacza je etykietą bg; v2.1.145 dodaje claude agents --json, liczniki kart oczekujących na dane wejściowe oraz poprawki panelu odpowiedzi w Agent View; v2.1.147 wprowadza przypięte sesje w tle, które pozostają aktywne w stanie bezczynności i są ponownie uruchamiane w tym samym miejscu w celu zastosowania aktualizacji. Agent View służy do monitorowania, a nie jako dowód pomyślnego przejścia kontroli jakości.⁶

Pola frontmatter niestandardowego agenta:

Przykładowy niestandardowy agent (.claude/agents/security-reviewer.md):

---
name: security-reviewer
description: Expert security code reviewer. Use PROACTIVELY after code changes to auth or data handling.
tools: Read, Grep, Glob, Bash
model: opus
permissionMode: plan
---

You are a senior security engineer. Analyze for OWASP Top 10 vulnerabilities,
secrets, hardcoded credentials, and SQL injection. Report findings with severity
levels and remediation steps.

13. Zmienne środowiskowe

Uwierzytelnianie i API

Konfiguracja modelu

Dostawcy usług chmurowych

Sterowanie zachowaniem

Konfiguracja narzędzi

Sieć i serwer proxy

Pełna lista znajduje się w sekcji Zmienne środowiskowe kompletnego przewodnika.

14. Zestawienie kosztów

Ceny za 1 milion tokenów (stan na lipiec 2026 r.).⁵

Typowa sesja zużywa 50K–200K tokenów wejściowych i 10K–50K tokenów wyjściowych. Sesja z Haiku: $0.10–$0.45. Sesja z Opus: $0.50–$2.25.

Domyślny model w Claude Code (od wersji v2.1.197, 30 czerwca 2026): Sonnet 5 dla wszystkich nowych sesji — natywny kontekst 1M i ceny promocyjne $2/$10 do 31 sierpnia — natomiast Opus jest dostępny po jednym poleceniu /model opus (od wersji v2.1.219 ten alias wskazuje Opus 5). Administratorzy mogą ustawić wartość domyślną dla całej organizacji, wyświetlaną jako „Org default” w /model (v2.1.196+); w Bedrock/Vertex/Foundry konkretny model można przypiąć za pomocą ANTHROPIC_DEFAULT_OPUS_MODEL / ANTHROPIC_DEFAULT_SONNET_MODEL.

Sonnet 5, Opus 5, Opus 4.8 i Fable 5 korzystają wyłącznie z adaptacyjnego rozumowania (bez stałych budżetów rozumowania). Dla wszystkich domyślną wartością effort jest high, a /effort xhigh służy do najtrudniejszych zadań programistycznych i agentowych. Zmiany niezgodne wstecznie w Opus 5 względem Opus 4.8: rozumowanie jest domyślnie włączone dla żądań bez pola thinking, a thinking: {type: "disabled"} przy poziomie wysiłku xhigh lub max zwraca błąd 400.

Tryb szybki (/fast) od wersji v2.1.219 działa wyłącznie z Opus 5 i Opus 4.8 — $10 / $50 za MTok (2× stawka bazowa) w zamian za nawet 2,5-krotnie większą liczbę tokenów wyjściowych na sekundę. Opus 4.7 został usunięty: claude-opus-4-7 + speed: "fast" zwraca teraz błąd zamiast przełączać się na standardową szybkość. Wersja testowa do celów badawczych, wyłącznie Claude API (bez Bedrock/Vertex/Foundry); zmiana szybkości unieważnia pamięć podręczną promptu.

Przełączanie modeli podczas sesji:

/model opus       # Switch to Opus 5 (v2.1.219+)
/model sonnet     # Switch to Sonnet 5 (the default)
/model haiku      # Switch to Haiku 4.5
/model fable      # Switch to Fable 5 (tier above Opus)
/effort xhigh     # Recommended for the hardest coding/agentic work

Reguła wyboru: Do prostej eksploracji warto używać Haiku. Do codziennego programowania z naciskiem na koszty — Sonnet. Do trudnego rozumowania, architektury, pętli agentowych i analizy bezpieczeństwa — Opus. Przy złożonej refaktoryzacji należy używać opusplan (Opus planuje, Sonnet wykonuje).

15. Lokalizacje najważniejszych plików

16. Dziennik zmian

17. Materiały źródłowe

Ta ściągawka jest podręcznym uzupełnieniem pełnego przewodnika po Claude Code CLI. Instrukcje konfiguracji krok po kroku znajdują się w przewodniku szybkiego startu z Claude Code. Informacje dotyczące projektów iOS i macOS można znaleźć w przewodniku po tworzeniu agentów dla iOS, wzorcach integracji XcodeBuildMCP oraz serii poświęconej ekosystemowi Apple. Ostatnia aktualizacja: 17 lipca 2026.