Konfiguracja i ustawienia: Wskazówki 1-15

Rozpoczęcie pracy z Claude Code wymaga przemyślanej konfiguracji, aby zmaksymalizować jego możliwości. Te 15 wskazówek pomoże ci skonfigurować Claude Code dla optymalnej wydajności, niezależnie od tego, czy pracujesz solo czy jako część zespołu.

Instalacja i integracja z IDE

Wskazówka 1: Zainstaluj rozszerzenie VS Code

Rozszerzenie Claude Code działa z VS Code, Cursor i Windsurf. Chociaż jest to zasadniczo tylko launcher, zapewnia kluczowe korzyści:

Szybkie uruchamianie z IDE za pomocą skrótów klawiszowych
Wiele instancji w równoległych panelach dla różnych części bazy kodu
Bezproblemowe referencje plików między twoim edytorem a Claude Code
Zintegrowane przeglądanie różnic do przeglądania zmian

# Zainstaluj z marketplace VS Code
code --install-extension anthropic.claude-code

# Działa automatycznie z Cursor
# Rozszerzenie dostępne w marketplace Cursor

# Szukaj "Claude Code" w:
# Settings → Plugins → Marketplace

Wskazówka 2: Użyj optymalnej metody instalacji

Zainstaluj Claude Code globalnie używając npm dla najlepszego doświadczenia we wszystkich projektach:

npm install -g @anthropic-ai/claude-code

Alternatywne metody instalacji:

brew install claude-code

# Pobierz z releases GitHub
curl -L https://github.com/anthropics/claude-code/releases/latest/download/claude-code-linux-x64 -o claude-code
chmod +x claude-code
sudo mv claude-code /usr/local/bin/

docker run -it anthropic/claude-code

Wskazówka 3: Pomiń monity o uprawnienia dla efektywności

Jedna z najbardziej wpływowych zmian konfiguracyjnych to ominięcie ciągłych próśb o uprawnienia:

claude --dangerously-skip-permissions

To eliminuje przerwania dla:

Uprawnień do edycji plików
Podstawowego wykonywania komend
Operacji Git
Komend menedżera pakietów

Uwagi bezpieczeństwa

To jest podobne do trybu “yolo” w Cursor. Chociaż teoretycznie mogłoby pozwolić na destrukcyjne komendy, doświadczeni użytkownicy nie raportują problemów w użyciu produkcyjnym. Użyj swojego osądu w oparciu o wymagania bezpieczeństwa.

Wskazówka 4: Zainstaluj GitHub CLI dla rozszerzonej integracji

GitHub CLI (gh) umożliwia potężne integracje Claude Code:

# macOS
brew install gh

# Linux/WSL
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo gpg --dearmor -o /usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update && sudo apt install gh

# Windows
winget install GitHub.cli

Po instalacji, uwierzytelnij:

gh auth login

To umożliwia:

Automatyczne tworzenie i przeglądanie PR
Zarządzanie problemami z Claude Code
Operacje na repozytoriach
Integrację z GitHub Actions

Wskazówka 5: Skonfiguruj integrację z IDE poprawnie

Skonfiguruj odpowiednią integrację z IDE dla płynnego przepływu pracy:

Skonfiguruj skróty klawiszowe

// VS Code settings.json
{
  "keybindings": [
    {
      "key": "cmd+shift+c",
      "command": "claude-code.open",
      "when": "editorTextFocus"
    }
  ]
}

Ustaw powiązania plików

{
  "files.associations": {
    "CLAUDE.md": "markdown",
    "*.claude": "markdown"
  }
}

Skonfiguruj integrację terminala

# Dodaj do ~/.zshrc lub ~/.bashrc
alias cc="claude"
alias ccc="claude --dangerously-skip-permissions"

Konfiguracja terminala i środowiska

Wskazówka 6: Skonfiguruj terminal dla optymalnego doświadczenia

Uruchom komendę konfiguracji terminala, aby skonfigurować odpowiednie powiązania klawiszy:

claude
# Następnie uruchom:
/terminal-setup

To umożliwia:

Shift+Enter dla nowych linii w promptach
Uzupełnianie Tab dla komend
Nawigację historii klawiszami strzałek
Odpowiednie sekwencje escape do zatrzymywania operacji

Wskazówka 7: Włącz tryb architekta dla dużych projektów

Dla dużej refaktoryzacji i złożonej pracy architektonicznej, Claude Code automatycznie optymalizuje swoje podejście w oparciu o złożoność twojego żądania. Po prostu opisz swoje potrzeby architektoniczne, a Claude dostosuje swoją strategię odpowiednio.

Zaawansowane rozpoznawanie wzorców
Ulepszona wydajność na plikach z 10,000+ linii

Kiedy używać trybu architekta

Refaktoryzacja całych modułów lub podsystemów
Analiza złożonych grafów zależności
Praca z legacyjnymi bazami kodu
Implementacja wzorców architektonicznych w wielu plikach

Wskazówka 8: Skonfiguruj preferencje modeli

Zrozum strategię wyboru modelu dla optymalnych rezultatów:

{
  "model": "auto", // Domyślnie: używa Opus do 50% kwoty
  "modelPreferences": {
    "complex": "claude-opus-4",
    "routine": "claude-sonnet-4",
    "simple": "claude-haiku"
  }
}

Wytyczne wyboru modelu:

Opus 4: Złożona architektura, projektowanie systemów, trudne debugowanie
Sonnet 4: Rutynowy rozwój, standardowe funkcje, refaktoryzacja
Haiku: Proste zadania, formatowanie, podstawowa generacja kodu

Wskazówka 9: Skonfiguruj wiele katalogów roboczych

Dla projektów obejmujących wiele repozytoriów:

# Uruchom Claude Code z wieloma katalogami
claude --add-dir ../backend --add-dir ../frontend --add-dir ../shared

# Lub dodaj podczas sesji
/add-dir ../backend
/add-dir ../frontend

Permanentna konfiguracja:

claude config add addDirs "../backend"
claude config add addDirs "../frontend"
claude config add addDirs "../shared"

Konfiguracja projektu

Wskazówka 10: Optymalizuj środowisko shell

Upewnij się, że Claude Code dziedziczy twoje środowisko deweloperskie:

export PATH="$HOME/.local/bin:$PATH"
export NODE_OPTIONS="--max-old-space-size=8192"
source ~/.nvm/nvm.sh

# Niestandardowe aliasy, które Claude powinien znać
alias build="npm run build:all"
alias test="npm run test:coverage"
alias deploy="./scripts/deploy.sh"

Dokumentuj niestandardowe narzędzia w CLAUDE.md:

# Niestandardowe narzędzia i komendy

- `build`: Uruchamia pełny pipeline budowy ze sprawdzaniem typów
- `test`: Uruchamia testy z raportowaniem pokrycia
- `deploy`: Wdraża na staging (wymaga połączenia VPN)

Wskazówka 11: Skonfiguruj odpowiednie uprawnienia plików

Skonfiguruj swój projekt z odpowiednimi uprawnieniami:

# Napraw częste problemy z uprawnieniami
find . -type f -name "*.sh" -exec chmod +x {} \;
chmod -R u+rw .claude/

# Stwórz katalog .claude z odpowiednimi uprawnieniami
mkdir -p .claude/{commands,hooks,settings}
chmod 755 .claude

Wskazówka 12: Zainstaluj serwery MCP dla rozszerzonej funkcjonalności

Serwery Model Context Protocol (MCP) rozszerzają możliwości Claude Code:

// .mcp.json (poziom projektu)
{
  "servers": {
    "git": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-git"]
    },
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    }
  }
}

Podstawowe serwery MCP do rozwoju:

git-mcp-server: Rozszerzone operacje git
github-mcp-server: Zarządzanie PR i problemami
postgres-mcp-server: Bezpośredni dostęp do bazy danych
filesystem-mcp-server: Zaawansowane operacje na plikach
puppeteer-mcp-server: Automatyzacja przeglądarki

Wskazówka 13: Użyj trybu debugowania do rozwiązywania problemów MCP

Gdy serwery MCP nie działają poprawnie:

claude --mcp-debug

To zapewnia:

Szczegółowe logi połączeń
Komunikaty błędów z serwerów MCP
Walidację konfiguracji
Metryki wydajności

Częste kroki rozwiązywania problemów:

Zweryfikuj instalację serwera MCP
Okno terminala
```
npm list -g @modelcontextprotocol/server-*
```
Sprawdź zmienne środowiskowe
Okno terminala
```
echo $GITHUB_TOKEN
echo $DATABASE_URL
```

Testuj serwer MCP bezpośrednio

npx @modelcontextprotocol/server-git --test

Wskazówka 14: Skonfiguruj konfiguracje specyficzne dla projektu

Stwórz kompleksową konfigurację projektu:

{
  "allowedTools": [
    "Edit",
    "View",
    "Bash(git:*)",
    "Bash(npm:*)",
    "Bash(yarn:*)",
    "Bash(pnpm:*)",
    "mcp__git__*",
    "mcp__github__*"
  ],
  "hooks": [
    {
      "matcher": "Edit",
      "hooks": [
        {
          "type": "command",
          "command": "prettier --write \"$CLAUDE_FILE_PATHS\""
        }
      ]
    }
  ],
  "security": {
    "allowNetworkAccess": true,
    "allowedHosts": ["api.github.com", "api.openai.com"],
    "sensitiveFiles": ["*.env", "*.key", "secrets/*"]
  }
}

Udostępnij zespołowi poprzez commitowanie do kontroli wersji:

git add .claude/settings.json
git commit -m "Dodaj konfigurację projektu Claude Code"

Wskazówka 15: Skonfiguruj dozwolone narzędzia strategicznie

Równoważ bezpieczeństwo z produktywnością poprzez dostosowanie uprawnień narzędzi:

{
  "allowedTools": [
    "Edit",
    "View",
    "Create",
    "Delete",
    "Bash(*)",
    "mcp__*"
  ]
}

{
  "allowedTools": [
    "Edit",
    "View",
    "Bash(git:*)",
    "Bash(npm:test)",
    "mcp__github__*"
  ]
}

{
  "allowedTools": [
    "View",
    "Bash(git:log)",
    "Bash(git:status)"
  ]
}

Użyj komendy /permissions do modyfikacji podczas sesji:

/permissions
# Wybierz narzędzia do zezwolenia/odmowy interaktywnie

Następne kroki

Po odpowiedniej konfiguracji Claude Code, jesteś gotowy zoptymalizować kontekst swojego projektu. Przejdź do Optymalizacja CLAUDE.md, aby nauczyć się jak tworzyć efektywną trwałą pamięć dla swoich projektów.