Podstawowa konfiguracja

Elastyczność Claude Code wynika z jego rozbudowanych opcji konfiguracyjnych. Ten przewodnik obejmuje podstawowe ustawienia potrzebne do optymalizacji workflow programistycznego, od zarządzania uprawnieniami po strategie wyboru modelu.

Hierarchia konfiguracji

1. Zasady enterprise - /Library/Application Support/ClaudeCode/managed-settings.json (macOS)
2. Argumenty linii poleceń - Flagi przekazywane przy uruchamianiu Claude Code
3. Lokalne ustawienia projektu - .claude/settings.local.json (nie w kontroli kodu źródłowego)
4. Współdzielone ustawienia projektu - .claude/settings.json (zapisane w kontroli kodu źródłowego)
5. Ustawienia użytkownika - ~/.claude/settings.json (stosuje się do wszystkich projektów)

Ustawienia są stosowane w kolejności precedencji, przy czym zasady enterprise nadpisują wszystkie inne.

Szybka konfiguracja

Interaktywne

# Uruchom menu konfiguracji
/config

# Zobacz bieżące ustawienia
claude config list

# Ustaw konkretną opcję
claude config set model claude-sonnet-4

Konfiguracja JSON

.claude/settings.json

{
  "model": "claude-sonnet-4.5",
  "permissions": {
    "defaultMode": "acceptEdits",
    "allow": [
      "Edit",
      "Bash(npm test:*)",
      "Bash(git:*)"
    ]
  },
  "hooks": {
    "PostToolUse": {
      "Edit": "npm run lint --fix $CLAUDE_FILE_PATHS"
    }
  }
}

Tryby uprawnień

Claude Code oferuje kilka trybów uprawnień, aby zrównoważyć bezpieczeństwo z produktywnością:

Dostępne tryby

Tryb	Opis	Przypadek użycia
default	Pyta o pozwolenie na każde nowe użycie narzędzia	Ogólne programowanie
acceptEdits	Auto-akceptuje edycje plików na sesję	Aktywne sesje kodowania
plan	Tryb analizy tylko do odczytu	Przegląd kodu, planowanie architektury
bypassPermissions	Pomiń wszystkie prośby o pozwolenie	Tylko zaufane środowiska

Tryb Yolo (omiń uprawnienia)

Uwaga

Używaj tylko w zaufanych środowiskach, takich jak lokalne programowanie lub izolowane kontenery.

# Uruchom z pominiętymi uprawnieniami
claude --dangerously-skip-permissions

# Równoważne z ustawieniem w konfiguracji
claude --permission-mode bypassPermissions

Ten tryb eliminuje przerwania z próśb o pozwolenie, znacznie poprawiając szybkość workflow dla doświadczonych użytkowników.

Strategia wyboru modelu

Claude Code domyślnie używa inteligentnego przełączania modeli, ale możesz zoptymalizować dla swojego przypadku użycia:

Możliwości modeli

Model	Najlepszy do	Koszt	Szybkość
Claude Opus 4	Złożone rozumowanie, architektura	5x	Wolniejszy
Claude Sonnet 4.5	Ogólne kodowanie, implementacja	1x	Szybki
Claude Opus 4	Debugowanie złożonych problemów	Różnie	Średni
Gemini 2.5 Pro	Scenariusze dużego kontekstu	2x	Szybki

Dynamiczny wybór modelu

# Przełączaj modele w trakcie sesji
/model opus     # Do złożonego planowania
/model sonnet   # Do implementacji

# Ustaw domyślny model
claude config set model claude-sonnet-4

# Nadpisz na sesję
claude --model claude-opus-4

Konfiguracja zoptymalizowana kosztowo

{
  "model": "claude-sonnet-4.5",
  "permissions": {
    "defaultMode": "acceptEdits"
  },
  "env": {
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "DISABLE_COST_WARNINGS": "0"
  }
}

Konfiguracja na poziomie projektu

Utwórz .claude/settings.json dla ustawień współdzielonych przez zespół:

{
  "permissions": {
    "allow": [
      "Edit(src/**)",
      "Bash(npm run:*)",
      "Bash(git diff:*)",
      "mcp__github__*"
    ],
    "deny": [
      "Edit(*.env)",
      "Bash(rm -rf:*)"
    ],
    "additionalDirectories": ["../shared-lib"]
  },
  "env": {
    "NODE_ENV": "development"
  },
  "hooks": {
    "PostToolUse": {
      "Edit": "prettier --write $CLAUDE_FILE_PATHS"
    }
  }
}

Ustawienia integracji z IDE

VS Code

.vscode/settings.json

{
  "claude-code.autoLaunch": true,
  "claude-code.defaultMode": "acceptEdits",
  "claude-code.theme": "dark"
}

JetBrains

.idea/claude-code.xml

<component name="ClaudeCodeSettings">
  <option name="autoLaunch" value="true" />
  <option name="defaultMode" value="acceptEdits" />
</component>

Konfiguracja terminala

Zoptymalizuj terminal dla Claude Code:

1. Uruchom /terminal-setup, aby skonfigurować przypisania klawiszy
2. Włącz Shift+Enter dla wejścia wielowierszowego
3. Skonfiguruj preferencje powiadomień:

   claude config set -g preferredNotifChannel iterm2_with_bell

Konfiguracja pamięci (CLAUDE.md)

Skonfiguruj trwałą pamięć między sesjami:

CLAUDE.md

## Polecenia budowania
- npm run build: Budowanie produkcyjne
- npm run dev: Serwer deweloperski
- npm test: Uruchom pakiet testów
- npm run typecheck: Walidacja TypeScript

## Styl kodu
- Używaj komponentów funkcyjnych z TypeScript
- Preferuj kompozycję nad dziedziczeniem
- Zawsze obsługuj przypadki błędów jawnie

## Architektura
- Frontend: Next.js z App Router
- API: tRPC z walidacją Zod
- Baza danych: PostgreSQL z Drizzle ORM

Importy plików pamięci

# Ustawienia specyficzne dla projektu
@docs/conventions.md
@~/.claude/personal-preferences.md

# Preferencje członków zespołu (nie w git)
@~/.claude/team-configs.md

Konfiguracja serwera MCP

Włącz potężne integracje przez MCP:

.claude/mcp.json

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

Włącz serwery MCP:

# Konfiguracja interaktywna
claude mcp add

# Zezwól na konkretne serwery
claude config set enabledMcpjsonServers '["github", "postgres"]'

Zaawansowana konfiguracja hooks

Automatyzuj workflow z hooks:

{
  "hooks": {
    "PreToolUse": {
      "Edit": {
        "type": "command",
        "command": "echo 'Editing: $CLAUDE_FILE_PATHS'"
      }
    },
    "PostToolUse": {
      "Edit": {
        "type": "command",
        "command": "npm run lint --fix $CLAUDE_FILE_PATHS"
      },
      "Bash": {
        "type": "command",
        "command": "[[ \"$CLAUDE_TOOL_INPUT\" =~ test ]] && echo 'Tests complete!'"
      }
    }
  }
}

Zmienne środowiskowe

Kluczowe zmienne środowiskowe do precyzyjnego dostrajania:

# Konfiguracja modelu
export ANTHROPIC_MODEL='claude-opus-4'
export ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku'

# Dostrajanie wydajności
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=8192
export MAX_THINKING_TOKENS=50000

# Optymalizacja kosztów
export DISABLE_NON_ESSENTIAL_MODEL_CALLS=1

# Bezpieczeństwo
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

Niestandardowe polecenia slash

Twórz workflow wielokrotnego użytku:

.claude/commands/optimize.md

Analizuj ten kod pod kątem wąskich gardeł wydajnościowych:
- Profiluj czas wykonania
- Zidentyfikuj zapytania N+1
- Sprawdź niepotrzebne re-renderowanie
- Zasugeruj optymalizacje

Cel: $ARGUMENTS

Użycie:

/optimize src/components/Dashboard.tsx

Konfiguracja bezpieczeństwa

Ustawienia bezpieczeństwa enterprise

/etc/claude-code/managed-settings.json

{
  "permissions": {
    "disableBypassPermissionsMode": "disable",
    "deny": [
      "Bash(curl:*)",
      "Bash(wget:*)",
      "WebFetch"
    ]
  },
  "forceLoginMethod": "console"
}

Optymalizacja wydajności

Użycie tokenów

• Używaj /clear często
• Włącz auto-compact
• Skup zapytania na konkretnych modułach

Wybór modelu

• Sonnet 4.5 do rutynowych zadań
• Opus 4 do złożonego rozumowania
• Monitoruj poleceniem /cost

Szybka referencja

Podstawowe polecenia

/config          # Menu konfiguracji
/permissions     # Zarządzaj dozwolonymi narzędziami
/model          # Przełączaj modele
/clear          # Wyczyść kontekst
/cost           # Sprawdź użycie tokenów

Wspólne konfiguracje

Szybkie programowanie:

claude --dangerously-skip-permissions --model sonnet

Bezpieczny tryb przeglądu:

claude --permission-mode plan --model opus

Konfiguracja świadoma kosztów:

{
  "model": "claude-sonnet-4.5",
  "env": {
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1"
  }
}

Następne kroki

• Skonfiguruj inicjalizację projektu z CLAUDE.md
• Skonfiguruj serwery MCP dla rozszerzonych możliwości
• Naucz się o trybach głębokiego rozumowania do złożonych zadań