Ś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

Trzy metody instalacji, 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 konkretnej wersji:

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

Weryfikacja instalacji:

claude doctor

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

3. Polecenia slash

Polecenia niestandardowe: Proszę utworzyć .claude/commands/my-command.md (projektowe) albo ~/.claude/commands/my-command.md (osobiste) i wywołać je za pomocą /my-command. Polecenia obsługują frontmatter YAML dla opisu, dozwolonych narzędzi, nadpisania modelu oraz interpolacji argumentów przez $ARGUMENTS albo pozycje $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

Dane wejściowe wielowierszowe

Skróty klawiszowe można dostosować przez /keybindings (przechowywane w ~/.claude/keybindings.json).

5. Pliki konfiguracyjne

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

Pierwsze dopasowanie wygrywa. Ustawień Enterprise nie da się obejść.

6. Referencja Settings.json

Kluczowe ustawienia z typami i przykładami. Należy umieścić je w dowolnym pliku ustawień z powyższej 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 dopasowanie prefiksowe. Bash(npm run test:*) pozwala na npm run test, npm run test:unit itd. Wzorce plików używają składni glob: Edit(src/**).

Nowe klucze (v2.1.118+):

Pełny schemat ustawień znajduje się w sekcji Configuration Deep Dive w pełnym przewodniku.

7. Szybka ściągawka CLAUDE.md

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

Gdzie się znajduje:

Co 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

Plik powinien być łatwy do przeskanowania. Gęsta proza marnuje tokeny kontekstu w każdej sesji. Warto używać punktów, tabel i krótkich bloków kodu. Należy unikać długich akapitów — Claude odczytuje CLAUDE.md na początku każdej sesji, więc każde słowo kosztuje kontekst.

Wskazówki dla zaawansowanych: - Proszę użyć prefiksu # w REPL, aby dodać elementy do automatycznej pamięci bez edytowania CLAUDE.md: # Always use TypeScript strict mode - CLAUDE.md w podfolderach jest ładowany, gdy Claude odczytuje pliki w danym folderze - Reguły współdzielone przez zespół warto umieszczać w .claude/rules/*.md, aby zachować modułową organizację

8. Tryby uprawnień

Auto Mode (v2.1.85+) to zalecany zamiennik --dangerously-skip-permissions. Operacje tylko do odczytu i edycje plików są zatwierdzane automatycznie. Najpierw rozstrzygane są niestandardowe reguły zezwalania/odmawiania. Wszystko pozostałe trafia do klasyfikatora bezpieczeństwa. Domyślnie automatycznie blokowane są: curl | bash, force-push do main, wdrożenia produkcyjne, masowe usunięcia w chmurze, zmiany IAM, wysyłanie wrażliwych danych na zewnątrz.¹

Wyłącznik bezpieczeństwa: 3 kolejne blokady lub 20 łącznie w jednej sesji wstrzymuje działanie i wraca do ręcznych pytań.

# Enable at startup
claude --enable-auto-mode

# Cycle during session
Shift+Tab    # default -> acceptEdits -> auto -> plan

Automatyczne zatwierdzanie PowerShell (v2.1.119+): Polecenia narzędzia PowerShell są automatycznie zatwierdzane w trybie uprawnień tak samo jak polecenia Bash. Reguły zezwalania, takie jak PowerShell(Get-*:*), pomijają pytania przy operacjach tylko do odczytu.

9. Zdarzenia hooks

| InstructionsLoaded | CLAUDE.md załadowany | Nie | | ConfigChange | Plik konfiguracyjny zmienia się w trakcie sesji | Tak | | WorktreeCreate | Tworzony jest worktree | Tak | | WorktreeRemove | Usuwany jest worktree | Nie | | PreCompact | Przed kompakcją kontekstu | Nie | | PostCompact | Po kompakcji kontekstu | Nie | | Elicitation | MCP prosi o dane strukturalne | Tak | | ElicitationResult | Użytkownik odpowiada w oknie dialogowym MCP | Tak | | StopFailure | Tura kończy się z powodu błędu API | Nie | | PermissionRequest | Pokazywane jest okno dialogowe uprawnień | Tak | | PermissionDenied | Auto mode odmawia wykonania akcji (v2.1.88+) | Nie | | CwdChanged | Zmienia się katalog roboczy (v2.1.83+) | Nie | | FileChanged | Obserwowany plik zmodyfikowano zewnętrznie (v2.1.83+) | Nie | | TaskCreated | Utworzono nowe zadanie (v2.1.84+) | Nie | | TeammateIdle | Członek zespołu agentów przechodzi w bezczynność | Tak | | TaskCompleted | Zadanie oznaczono jako ukończone | Tak |

Pełny protokół hooks (wejściowy/wyjściowy JSON, matchery, kody wyjścia) opisano w sekcji Hooks Deep Dive w pełnym przewodniku.

10. Konfiguracja hooks

Hooks znajdują się w settings.json albo w dedykowanym 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ów:

Kody wyjścia:

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

Pola wyjściowe / wejściowe hook:

• duration_ms w danych wejściowych hook PostToolUse / PostToolUseFailure (v2.1.119+) — czas wykonania narzędzia bez uwzględniania pytań o uprawnienia i hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — zastępuje wynik narzędzia dla dowolnego narzędzia (v2.1.118 wprowadziło to tylko dla MCP; v2.1.121 rozszerza obsługę na wszystkie narzędzia).
• hookSpecificOutput.sessionTitle (v2.1.96+) — ustawia tytuł sesji z hook UserPromptSubmit.
• args: string[] w command hooks (v2.1.139+) — przekazuje strukturalne argv bez quote’owania w shellu.
• continueOnBlock w hooks PostToolUse (v2.1.139+) — przekazuje powód blokady z powrotem do Claude i kontynuuje turę.
• subagent_type w danych wejściowych agent hook (v2.1.140+) — identyfikuje uruchomiony typ agenta.

11. Szybka konfiguracja MCP

Serwer MCP można dodać jednym poleceniem:

# 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ład projektu .mcp.json:

{
  "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 ma teraz 100 milionów pobrań miesięcznie i ponad 3 000 indeksowanych serwerów.³ Typy transportu, elicitation i konfigurację wyszukiwania narzędzi opisano w sekcji MCP w pełnym przewodniku.

alwaysLoad (v2.1.121+): Pozwala wyłączyć odraczanie Tool Search dla zaufanego serwera. Wszystkie jego narzędzia ładują się na początku sesji, bez dodatkowego przejścia ToolSearch:

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

Automatyczne ponawianie (v2.1.121+): Serwery MCP, które zwrócą błąd podczas uruchamiania, są ponawiane do 3 razy, zanim zostaną oznaczone jako rozłączone.

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

11.5. Polecenia Plugin CLI

12. Typy subagents

Claude automatycznie deleguje zadania do subagents. Można też zażądać ich jawnie:

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

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

claude agents otwiera Agent View w bieżących wersjach: ekran operacyjny w wersji research-preview dla uruchomionych, zablokowanych i zakończonych sesji Claude Code. Należy używać go do monitorowania, nie jako dowodu, że praca przeszła bramki jakości.⁶

Pola frontmatter Custom agent:

Przykładowy custom 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 cloud

Kontrola zachowania

Konfiguracja narzędzi

Sieć i proxy

Pełna lista znajduje się w sekcji Environment Variables w pełnym przewodniku.

14. Odniesienie do kosztów

Ceny za 1 milion tokenów (stan na kwiecień 2026).⁵

Typowa sesja zużywa 50K-200K tokenów inputu i 10K-50K tokenów outputu. Sesja Haiku: $0.10-$0.45. Sesja Opus: $0.50-$2.25.

Model domyślny według planu (Claude Code stan na 16 kwietnia 2026):

• Max, Team Premium → Opus 4.7
• Pro, Team Standard, Enterprise, Anthropic API → Sonnet 4.6 (Enterprise + API przełączą się na Opus 4.7 23 kwietnia 2026)
• Bedrock, Vertex, Foundry → Sonnet 4.5 (nowszy można przypiąć przez ANTHROPIC_DEFAULT_OPUS_MODEL)

Opus 4.7 wymaga Claude Code v2.1.111 lub nowszej. Używa wyłącznie adaptive reasoning (bez stałych budżetów thinking). Nowy poziom effort xhigh jest domyślny dla obciążeń coding/agentic w Opus 4.7.

Przełączanie modeli podczas sesji:

/model opus       # Switch to Opus (resolves to 4.7 on API, 4.6 on Bedrock/Vertex/Foundry)
/model sonnet     # Switch to Sonnet 4.6
/model haiku      # Switch to Haiku 4.5
/effort xhigh     # Opus 4.7 only — recommended for coding/agentic

Reguła decyzyjna: Prosta eksploracja trafia do Haiku. Codzienne kodowanie wrażliwe na koszty trafia do Sonnet. Trudne rozumowanie, architektura, pętle agentic i analiza bezpieczeństwa trafiają do Opus. Do złożonego refaktoryzowania należy używać opusplan (Opus planuje, Sonnet wykonuje).

15. Kluczowe lokalizacje plików

16. Dziennik zmian

17. Źródła

Ten cheat sheet jest szybkim podręcznym uzupełnieniem pełnego przewodnika Claude Code CLI. Instrukcje konfiguracji krok po kroku znajdują się w quickstarcie Claude Code. W przypadku projektów iOS i macOS warto zajrzeć do przewodnika iOS Agent Development, wzorców integracji XcodeBuildMCP oraz serii Apple Ecosystem. Ostatnia aktualizacja: 13 maja 2026.