Ś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
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

3. Slash commands

Polecenia niestandardowe: Proszę utworzyć .claude/commands/my-command.md (projektowe) lub ~/.claude/commands/my-command.md (osobiste) i wywołać przez /my-command. Polecenia obsługują frontmatter YAML dla opisu, dozwolonych narzędzi, zastąpienia 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

Ogólne elementy sterujące

Szybkie prefiksy

Wprowadzanie 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 można obejść.

6. Settings.json reference

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 prefiksu. Bash(npm run test:*) zezwala 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 szczegółowe omówienie konfiguracji w pełnym przewodniku.

7. Krótka ś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

Powinien być łatwy do szybkiego przejrzenia. Gęsta proza marnuje tokeny kontekstu w każdej sesji. Warto używać wypunktowań, 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 zużywa kontekst.

Wskazówki eksperckie: - Używać prefiksu # w REPL, aby dodawać rzeczy do auto-memory bez edytowania CLAUDE.md: # Always use TypeScript strict mode - CLAUDE.md w podkatalogach jest ładowany, gdy Claude odczytuje pliki w danym katalogu - Reguły współdzielone przez zespół trafiają do .claude/rules/*.md, aby zachować modułową organizację

8. Tryby uprawnień

Auto Mode (v2.1.85+) to zalecany zamiennik dla --dangerously-skip-permissions. Operacje tylko do odczytu i edycje plików są automatycznie zatwierdzane. Najpierw rozstrzygane są niestandardowe reguły zezwalania/odmowy. Wszystko inne 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 danych wrażliwych na zewnątrz.¹

Wyłącznik bezpieczeństwa: 3 kolejne blokady albo 20 łącznie w sesji wstrzymują działanie i przywracają ręczne monity.

# 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ą monity dla operacji tylko do odczytu. W przepływach pracy mocno opartych na PowerShell warto używać v2.1.149+; naprawia ona obejścia uprawnień dla wbudowanego cd, dopasowywanie reguł zezwalania prefiksów/wieloznaczników oraz śledzenie nieaktualnej zmiennej katalogu.

9. Zdarzenia hooks

| InstructionsLoaded | Załadowano CLAUDE.md | Nie | | ConfigChange | Plik konfiguracji zmienia się w trakcie sesji | Tak | | WorktreeCreate | Tworzony jest worktree | Tak | | WorktreeRemove | Usuwany jest worktree | Nie | | PreCompact | Przed kompaktowaniem kontekstu | Nie | | PostCompact | Po kompaktowaniu kontekstu | Nie | | Elicitation | MCP żąda ustrukturyzowanych danych wejściowych | Tak | | ElicitationResult | Użytkownik odpowiada na okno dialogowe MCP | Tak | | StopFailure | Tura kończy się z powodu błędu API | Nie | | PermissionRequest | Pokazywane jest okno uprawnień | Tak | | PermissionDenied | Auto mode odmawia wykonania działania (v2.1.88+) | Nie | | CwdChanged | Zmienia się katalog roboczy (v2.1.83+) | Nie | | FileChanged | Obserwowany plik został zmodyfikowany zewnętrznie (v2.1.83+) | Nie | | TaskCreated | Utworzono nowe zadanie (v2.1.84+) | Nie | | TeammateIdle | Członek zespołu agentów jest bezczynny | Tak | | TaskCompleted | Zadanie oznaczono jako ukończone | Tak |

Pełny protokół hooks (wejście/wyjście JSON, matchers, kody wyjścia) znajduje się w sekcji szczegółowe omówienie hooks 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 matchers:

Kody wyjścia:

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

Wyjście hook / pola wejściowe:

• duration_ms w danych wejściowych hook PostToolUse / PostToolUseFailure (v2.1.119+) — czas wykonania narzędzia z wyłączeniem monitów o uprawnienia i hooks PreToolUse.
• hookSpecificOutput.updatedToolOutput (v2.1.121+) — zastępuje wynik narzędzia dla dowolnego narzędzia (v2.1.118 wprowadziła 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 ustrukturyzowane argv bez cytowania powłoki.
• 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.
• terminalSequence w wyjściu hook JSON (v2.1.141+) — emituje sekwencje sterujące terminala dla powiadomień, tytułów okien i dzwonków.

11. Szybka konfiguracja MCP

Dodanie serwera MCP 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 obecnie 100 milionów pobrań miesięcznie i ponad 3000 zindeksowanych serwerów.³ Informacje o typach transportu, elicitation i konfiguracji Tool Search znajdują się w sekcji MCP w pełnym przewodniku.

alwaysLoad (v2.1.121+): Wyłącza zaufany serwer z odraczania przez Tool Search. Wszystkie jego narzędzia ładują się przy starcie sesji, bez dodatkowego przebiegu ToolSearch:

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

Automatyczna ponowna próba (v2.1.121+): Serwery MCP, które zgłoszą 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 w niestandardowych schematach URI — w aplikacjach desktopowych i przepływach konektorów claude.ai.

11.5. Polecenia CLI pluginów

12. Typy subagents

Claude automatycznie deleguje zadania do subagents. Można też poprosić o nie jawnie:

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

Niestandardowe 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 wydaniach: ekran operacyjny w wersji research-preview dla uruchomionych, zablokowanych i ukończonych sesji Claude Code. claude agents --cwd <path> ogranicza widok do jednego katalogu (v2.1.141+), v2.1.142 dodaje flagi dispatch dla sesji w tle, a v2.1.143 stosuje te flagi spójnie do dashboardu i sesji 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 jako 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 dodaje przypięte sesje w tle, które pozostają aktywne w bezczynności i restartują się w miejscu przy aktualizacjach. Agent View należy używać do monitorowania, nie jako dowodu, że praca przeszła bramki jakości.⁶

Pola frontmatter niestandardowego agenta:

Przykład niestandardowego agenta (.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 chmurowi

Kontrola zachowania

Konfiguracja narzędzi

Sieć i proxy

Pełna lista znajduje się w sekcji Zmienne środowiskowe w pełnym przewodniku.

14. cennik

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

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

Domyślny model 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 przechodzą 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 adaptacyjnego rozumowania (bez stałych budżetów thinking). Nowy poziom wysiłku xhigh jest domyślny dla zadań programistycznych i agentowych w Opus 4.7.

Zmiana 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 koszt trafia do Sonnet. Trudne rozumowanie, architektura, pętle agentowe i analiza bezpieczeństwa trafiają do Opus. Do złożonego refaktoringu należy używać opusplan (Opus planuje, Sonnet wykonuje).

15. kluczowe lokalizacje plików

16. dziennik zmian

17. Źródła

Ta ściągawka jest podręcznym uzupełnieniem pełnego przewodnika po Claude Code CLI. Instrukcje konfiguracji krok po kroku znajdują się w quickstarcie Claude Code. W przypadku projektów iOS i macOS warto sięgnąć do przewodnika iOS Agent Development, wzorców integracji XcodeBuildMCP oraz Apple Ecosystem Series. Ostatnia aktualizacja: 24 maja 2026.