# Twój pierwszy projekt

W Speedwave zawsze pracujesz w obrębie projektu. Projekt to zarejestrowana przestrzeń robocza z nazwą i katalogiem na hoście. Wokół niej Speedwave porządkuje wszystko: od sieci kontenerów po dane uwierzytelniające, osobno dla każdego projektu.

## Utwórz projekt

Oba interfejsy rejestrują projekt dokładnie tak samo. Skorzystaj z tego, który wolisz.

1. Kliknij pigułkę projektu w prawym górnym rogu paska nagłówka, żeby otworzyć przełącznik projektów.
2. Kliknij **+ add project...** i wskaż katalog, w którym chcesz pracować.

Jeśli wybrany katalog leży w folderze synchronizowanym przez OneDrive, Dropbox lub Google Drive, Speedwave ostrzeże cię przed jego dodaniem. Dopóki nie nadasz uprawnień, macOS może blokować dostęp do folderu synchronizowanego z chmurą. W takiej sytuacji kolejne okno przeprowadzi cię przez otwarcie panelu prywatności Files & Folders i ponowienie próby.

<DesktopFrame screen="switcher" />

Otwórz terminal w katalogu, w którym chcesz pracować, i uruchom:

```bash
speedwave init
```

Polecenie to rejestruje bieżący katalog jako projekt i ustawia go jako aktywny. Jeśli pominiesz nazwę, Speedwave weźmie nazwę katalogu. Chcesz inną? Uruchom `speedwave init my-project`.

Nazwy projektów muszą składać się z małych liter a-z, cyfr 0-9 oraz znaków `_`, `.` i `-`. Nazwa zaczyna się od litery lub cyfry i liczy co najwyżej 63 znaki.

W systemie Windows Speedwave nie przyjmie katalogu głównego dystrybucji WSL jako katalogu projektu, bo to cała dystrybucja, a nie projekt. Wskaż zamiast niego podkatalog, na przykład `\\wsl.localhost\<distro>\projects\<name>`.

## Co Speedwave tworzy wokół projektu

Rejestracja projektu dodaje wpis do tablicy `projects` w twojej konfiguracji użytkownika, w pliku `~/.speedwave/config.json`, wraz z polami `name` i `dir`. Od tej chwili projekt ma własne:

- Sieć kontenerów, dzięki której jego kontenery nie porozumieją się z kontenerami innego projektu.
- [Katalog tokenów, w którym leżą dane uwierzytelniające](/pl/docs/security/credentials/) do każdej usługi, z jaką łączy się projekt.
- Katalog domowy Claude, gdzie trzymane są dane uwierzytelniające Claude Code, sesje oraz stan onboardingu dla tego projektu.

Uruchomienie `speedwave init` ustawia nowy projekt jako aktywny. Samo `speedwave`, bez flagi `--project`, zawsze działa na projekcie aktywnym, a nie na tym, który pasowałby do twojego bieżącego katalogu. Gdy projekt już istnieje, zaloguj się w jego obrębie do Claude. Kroki znajdziesz w [Twojej pierwszej sesji](/pl/docs/get-started/first-session/).

## Gdzie leżą pliki

Wszystko, co Speedwave przechowuje dla projektu, znajduje się w katalogu danych, domyślnie `~/.speedwave/`:

- ~/.speedwave/
  - config.json
  - tokens/
    - my-project/
      - slack/
      - gitlab/
      - llm/
  - claude-home/
    - my-project/
Pliki samego projektu zostają tam, gdzie były, czyli w katalogu na hoście, w którym uruchomiłeś `speedwave init`. Speedwave montuje ten katalog w kontenerze pod ścieżką `/workspace`.

## Usuwanie projektu

Usunięcie projektu kasuje jedynie wymienione wyżej katalogi zarządzane przez Speedwave (tokeny, katalog domowy Claude i pozostałe). Nigdy nie narusza twojego drzewa źródłowego. Nie usuniesz projektu, na którym akurat pracujesz. Przełącz się najpierw na inny, w przeciwnym razie Speedwave odmówi i wyświetli błąd z prośbą o zmianę projektu.

Pełny obraz tego, jak projekty pozostają odizolowane od siebie i jak wybierany jest projekt aktywny, znajdziesz w [projektach i sesjach](/pl/docs/understand/projects-and-sessions/).

[Dokumentacja CLI](/pl/docs/reference/cli-commands/)