Praca w kontenerze deweloperskim
Plik .devcontainer/devcontainer.json pozwala dodać Claude Code do kontenera deweloperskiego przez blok features albo utworzyć konfigurację od podstaw. To podejście działa z narzędziami obsługującymi specyfikację Dev Containers, między innymi VS Code, GitHub Codespaces i JetBrains IDEs. W VS Code i Codespaces feature dodaje też rozszerzenie Claude Code, natomiast inne edytory pomijają tę część.
Claude Code trafia do kontenera przez feature umieszczony w bloku features konfiguracji. Końcówka wersji, taka jak :1.0, przypina skrypt instalacyjny feature, a nie wersję Claude Code. Feature instaluje najnowszą wersję Claude Code, a CLI domyślnie aktualizuje się automatycznie wewnątrz kontenera.
Po zapisaniu konfiguracji przebuduj kontener; w VS Code uruchom z palety poleceń Dev Containers: Rebuild Container. Po zakończeniu przebudowy otwórz terminal w kontenerze, uruchom claude i przejdź przez proces uwierzytelniania. Jeśli logowanie w przeglądarce zakończy się bez przekazania callbacku do kontenera, wklej wyświetlony kod w terminalu.
Gdy obraz bazowy nie zawiera Node.js, feature próbuje zainstalować go samodzielnie. Jeśli instalacja zakończy się błędem Failed to install Node.js and npm, dodaj feature Node.js przed feature Claude Code i przebuduj kontener. Przy dostawcach chmurowych przekazuj poświadczenia przez zmienne środowiskowe kontenera, sekret Codespaces lub tożsamość obciążenia, zamiast montować pliki poświadczeń z hosta.
.devcontainer/devcontainer.json, aby dodać feature Claude Code do kontenera.{
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
"features": {
"ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {}
}
}"features": {
"ghcr.io/devcontainers/features/node:1": {},
"ghcr.io/anthropics/devcontainer-features/claude-code:1.0": {}
}Zastosowanie w praktyce
Użyj feature, gdy chcesz dodać Claude Code do istniejącego środowiska Dev Containers zamiast budować konfigurację kontenera od zera. Możesz zastosować tę konfigurację w VS Code, GitHub Codespaces lub JetBrains IDEs, o ile narzędzie obsługuje specyfikację Dev Containers. Jeśli projekt używa Dockerfile, zastąp przykładową linię image obrazem bazowym projektu albo usuń ją z istniejącej konfiguracji. Jako punkt odniesienia możesz skopiować katalog .devcontainer/ z przykładowego kontenera i dostosować Dockerfile do swojego toolchainu.
:1.0, pins the feature's install script, not the Claude Code release.”