Referencja narzędzi

Claude Code ma wbudowany zestaw narzędzi, które pomagają mu rozumieć i modyfikować bazę kodu. Nazwy narzędzi są dokładnymi ciągami znaków używanymi w regułach uprawnień, listach narzędzi subagentów i matcherach hooków. Aby kontrolować, których narzędzi Claude może używać i kiedy ma najpierw zapytać, skonfiguruj reguły uprawnień w ustawieniach, hookach lub liście narzędzi subagenta.

Najczęściej nie musisz samodzielnie podawać nazw narzędzi podczas rozmowy z Claude, bo to Claude decyduje, kiedy ich użyć. Nazwy narzędzi możesz jednak wskazywać w ustawieniach, interfejsie /permissions, flagach CLI, konfiguracji Agent SDK, nagłówku skillu lub warunku hooka. Te miejsca korzystają z tego samego formatu reguły ToolName(specifier), a specyfikator zależy od narzędzia.

Przykładowo, reguła dla Read może dopasowywać ścieżkę, a reguła dla Bash — wzorzec polecenia. W trybie Manual kolumna wymagań uprawnień określa, czy narzędzie pyta o zgodę dla ścieżek wewnątrz katalogu roboczego. Narzędzia dostępu do plików oznaczone jako niewymagające zgody nadal pytają o ścieżki poza katalogiem roboczym i dodatkowe katalogi.

W trybie auto większość próśb o uprawnienia rozstrzyga klasyfikator, a nie użytkownik. Reguła zezwalająca na Edit(...) dla danej ścieżki przyznaje też dostęp do jej odczytu, więc nie trzeba dodawać pasującej reguły Read(...). Z kolei reguła odmawiająca Read(...) blokuje na tej samej ścieżce również Edit i Write, także przy tworzeniu nowego pliku.

Read(~/secrets/**)

Edit(/src/**)

Bash(npm run *)