Konfiguracja i ustawienia

Naucz się konfigurować Claude Code do swojego workflow, od zarządzania uprawnieniami i uwierzytelnianiem po ustawianie konfiguracji specyficznych dla projektu. Ten przewodnik obejmuje zarówno preferencje osobiste, jak i ustawienia zespołowe.

Hierarchia konfiguracji

Claude Code używa hierarchicznego systemu konfiguracji, który pozwala na elastyczność przy zachowaniu spójności:

Precedencja ustawień (od najwyższej do najniższej)

Zasady enterprise - Zarządzane przez administratorów IT
Argumenty linii poleceń - Nadpisanie dla konkretnych sesji
Lokalne ustawienia projektu - .claude/settings.local.json
Współdzielone ustawienia projektu - .claude/settings.json
Ustawienia użytkownika - ~/.claude/settings.json

Szybka konfiguracja

Interaktywna konfiguracja
Okno terminala
```
claude /config
```
Lista bieżących ustawień
Okno terminala
```
claude config list
```

Ustaw konkretną wartość

claude config set model claude-sonnet-4
claude config set autoUpdates false --global

Zobacz ustawienie
Okno terminala
```
claude config get model
```

Pliki ustawień

Ustawienia użytkownika

Globalne preferencje, które stosują się do wszystkich projektów:

// ~/.claude/settings.json
{
"model": "claude-opus-4",
"theme": "dark",
"autoUpdates": true,
"env": {
  "EDITOR": "code",
  "NODE_ENV": "development"
},
"permissions": {
  "defaultMode": "acceptEdits",
  "allow": [
    "Edit",
    "Bash(git:*)",
    "Bash(npm run:*)"
  ]
}
}

Ustawienia projektu

Współdzielona konfiguracja zespołu zapisana w kontroli wersji:

// .claude/settings.json
{
"model": "claude-sonnet-4",
"maxTurns": 20,
"allowedTools": [
  "Edit",
  "View",
  "Bash(npm:*)",
  "mcp__github__*"
],
"env": {
  "API_ENDPOINT": "https://staging.api.company.com"
},
"permissions": {
  "additionalDirectories": [
    "../shared-lib",
    "../api-contracts"
  ]
},
"hooks": {
  "PreToolUse": {
    "Edit": "npm run lint-staged"
  }
}
}

Lokalne ustawienia projektu

Osobiste nadpisania nie zapisane w kontroli wersji:

// .claude/settings.local.json
{
"env": {
  "API_KEY": "your-personal-dev-key"
},
"permissions": {
  "defaultMode": "bypassPermissions"
}
}

Zarządzanie uprawnieniami

Tryby uprawnień

Standardowe zachowanie - pyta o pozwolenie przy pierwszym użyciu każdego narzędzia:

claude --permission-mode default

Dobre dla: Nowych projektów, nieznanych baz kodu

Automatycznie akceptuje uprawnienia do edycji plików na sesję:

claude --permission-mode acceptEdits

Dobre dla: Aktywnego programowania, zaufanych projektów

Analiza tylko do odczytu bez modyfikacji:

claude --permission-mode plan

Dobre dla: Przeglądów kodu, analizy architektury

Pomiń wszystkie prośby o pozwolenie (używaj ostrożnie):

claude --dangerously-skip-permissions
# lub
claude --permission-mode bypassPermissions

Dobre dla: Projektów osobistych, skryptów automatyzacji

Zarządzanie dozwolonymi narzędziami

Zarządzanie interaktywne
Okno terminala
```
claude /permissions
```

Zezwól na konkretne narzędzia

{
  "permissions": {
    "allow": [
      "Edit",                    // Wszystkie edycje plików
      "Bash(git:*)",            // Wszystkie polecenia git
      "Bash(npm run test:*)",   // Konkretne skrypty npm
      "Read(~/.zshrc)",         // Odczyt konkretnych plików
      "mcp__github__*"          // Wszystkie narzędzia GitHub MCP
    ]
  }
}

Odmów niebezpiecznych operacji

{
  "permissions": {
    "deny": [
      "Bash(rm -rf:*)",         // Zapobiegaj usuwaniu
      "Bash(curl:*)",           // Blokuj zewnętrzne żądania
      "Edit(/etc/**)"           // Chroń pliki systemowe
    ]
  }
}

Reguły specyficzne dla narzędzi

Wzorce reguł uprawnień

Narzędzie	Wzorzec	Przykład
Bash	`Bash(polecenie:*)`	`Bash(npm run:*)`
Edit	`Edit(ścieżka/wzorzec)`	`Edit(src/**)`
Read	`Read(ścieżka/wzorzec)`	`Read(~/.ssh/*)`
WebFetch	`WebFetch(domena:example.com)`	`WebFetch(domena:api.company.com)`
MCP	`mcp__serwer__narzędzie`	`mcp__github__create_issue`

Zmienne środowiskowe

Konfiguracja przez ustawienia

Ustaw zmienne środowiskowe, które utrzymują się między sesjami:

{
"env": {
  // Ustawienia deweloperskie
  "NODE_ENV": "development",
  "DEBUG": "app:*",

  // Konfiguracja API
  "API_BASE_URL": "https://staging.api.com",
  "TIMEOUT": "30000",

  // Konfiguracja narzędzi
  "EDITOR": "code",
  "PAGER": "less"
}
}

Zmienne środowiskowe runtime

Nadpisz ustawienia dla konkretnych sesji:

# Uwierzytelnianie
export ANTHROPIC_API_KEY="sk-ant-..."
export ANTHROPIC_AUTH_TOKEN="Bearer token..."

# Wybór modelu
export ANTHROPIC_MODEL="claude-opus-4"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-3"

# Konfiguracja proxy
export HTTPS_PROXY="https://proxy.company.com:8080"
export NODE_TLS_REJECT_UNAUTHORIZED=0  # Certyfikaty self-signed

# Dostrojenia zachowania
export BASH_MAX_TIMEOUT_MS=300000  # 5 minut
export DISABLE_PROMPT_CACHING=1
export DISABLE_INTERLEAVED_THINKING=1

Konfiguracja modelu

Wybieranie modeli

{
  "model": "claude-opus-4",
  "smallFastModel": "claude-haiku-3"
}

export ANTHROPIC_MODEL="claude-sonnet-4"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-3"

claude --model opus
claude --model claude-sonnet-4-20250514

Katalogi robocze

Rozszerz dostęp Claude do plików poza katalog uruchomienia:

Podczas uruchamiania
Okno terminala
```
claude --add-dir ../backend ../shared
```
Podczas sesji
Okno terminala
```
/add-dir ../documentation
```

Konfiguracja trwała

{
  "permissions": {
    "additionalDirectories": [
      "../api",
      "../shared-components",
      "~/templates"
    ]
  }
}

Konfiguracja enterprise

Zarządzane ustawienia zasad

Administratorzy IT mogą wymuszać ustawienia organizacyjne:

// /etc/claude-code/managed-settings.json (Linux/WSL)
// /Library/Application Support/ClaudeCode/managed-settings.json (macOS)
// C:\ProgramData\ClaudeCode\managed-settings.json (Windows)

{
"permissions": {
  "deny": [
    "Bash(rm -rf:*)",
    "WebFetch(domain:competitor.com)"
  ],
  "disableBypassPermissionsMode": "disable"
},
"env": {
  "CORPORATE_PROXY": "proxy.company.com:8080",
  "CLAUDE_CODE_ENABLE_TELEMETRY": "0"
},
"forceLoginMethod": "console",
"model": "claude-sonnet-4"
}

Zarządzanie kluczami API

Dla wdrożeń enterprise z rotującymi danymi uwierzytelniającymi:

Utwórz skrypt pomocniczy klucza

#!/bin/bash
# Pobierz z vault
vault kv get -field=api_key secret/claude-code

# Lub z AWS Secrets Manager
aws secretsmanager get-secret-value \
  --secret-id claude-code-api-key \
  --query SecretString --output text

Skonfiguruj Claude Code

{
  "apiKeyHelper": "~/bin/get-api-key.sh"
}

Ustaw interwał odświeżania

export CLAUDE_CODE_API_KEY_HELPER_TTL_MS=3600000  # 1 godzina

Ustawienia zaawansowane

Konfiguracja hooks

Automatyzuj workflow z hooks pre/post narzędzi:

{
"hooks": {
  "PreToolUse": {
    "Edit": "npm run pre-edit-checks",
    "Bash": "echo 'Executing: $COMMAND'"
  },
  "PostToolUse": {
    "Edit": "npm run format",
    "MultiEdit": "git add -A"
  }
}
}

Niestandardowe polecenia slash

Twórz polecenia wielokrotnego użytku w .claude/commands/:

---
name: test-component
description: Uruchom testy dla komponentu React
---

npm test -- --testNamePattern="$ARGUMENTS" --coverage

Konfiguracja serwera MCP

Skonfiguruj serwery Model Context Protocol:

{
"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"
    ]
  }
}
}

Rozwiązywanie problemów z konfiguracją

Częste problemy

Sprawdź kolejność precedencji:

# Zobacz efektywne ustawienia
claude config list

# Sprawdź, który plik jest używany
claude config get model -v

Upewnij się o odpowiednich uprawnieniach plików:

# Napraw ustawienia użytkownika
chmod 600 ~/.claude/settings.json

# Napraw ustawienia projektu
chmod 644 .claude/settings.json

Zwaliduj pliki ustawień:

# Użyj wbudowanego walidatora Claude
claude /doctor

# Lub zwaliduj ręcznie
jq . ~/.claude/settings.json

Najlepsze praktyki

Wskazówki konfiguracyjne

Zacznij od domyślnych - Nadpisuj tylko to, czego potrzebujesz
Używaj ustawień projektu - Dziel wspólne konfiguracje z zespołem
Zachowaj sekrety lokalnie - Używaj .claude/settings.local.json dla kluczy API
Dokumentuj niestandardowe ustawienia - Dodaj komentarze w CLAUDE.md
Regularnie przeglądaj uprawnienia - Okresowo audituj dozwolone narzędzia
Używaj zmiennych środowiskowych - Do tymczasowych nadpisań
Wykorzystuj hooks - Automatyzuj powtarzalne zadania
Testuj konfiguracje - Sprawdź, czy ustawienia działają dla członków zespołu

Następne kroki

Inicjalizuj swój pierwszy projekt Utwórz plik CLAUDE.md i skonfiguruj kontekst projektu

Integracja z IDE Połącz Claude Code z ulubionym edytorem

Referencja konfiguracji

Ustawienie	Typ	Zakres	Opis
`model`	string	Wszystkie	Wybór głównego modelu
`autoUpdates`	boolean	Globalne	Włącz auto-aktualizacje
`theme`	string	Globalne	Motyw UI (dark/light)
`permissions`	object	Wszystkie	Reguły uprawnień
`env`	object	Wszystkie	Zmienne środowiskowe
`hooks`	object	Wszystkie	Hooks wykonania narzędzi
`allowedTools`	array	Wszystkie	Lista dozwolonych narzędzi
`additionalDirectories`	array	Wszystkie	Dodatkowe katalogi robocze
`cleanupPeriodDays`	number	Wszystkie	Przechowywanie historii czatu