Przejdź do treści
Dokumentacja V1
Konfiguracja

Narzędzia

Narzędzia umożliwiają LLM wykonywanie działań w bazie kodu. OpenCode posiada zestaw wbudowanych narzędzi, ale możesz go rozszerzyć o narzędzia niestandardowe lub serwery MCP.

Domyślnie wszystkie narzędzia są włączone i nie wymagają zatwierdzenia przed uruchomieniem. Możesz kontrolować zachowanie narzędzi poprzez uprawnienia.


Użyj pola permission do kontrolowania zachowania narzędzia. Dla każdego narzędzia możesz zezwolić (allow), odmówić (deny) lub wymagać zatwierdzenia (ask).

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny",
    "bash": "ask",
    "webfetch": "allow"
  }
}

Możesz także używać symboli wieloznacznych do kontrolowania wielu narzędzi jednocześnie. Na przykład, aby wymagać zatwierdzenia dla wszystkich narzędzi z serwera MCP:

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "mymcp_*": "ask"
  }
}

Dowiedz się więcej o konfigurowaniu uprawnień.


Oto wszystkie wbudowane narzędzia dostępne w OpenCode.


Wykonuj polecenia powłoki (shell) w środowisku projektu.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "bash": "allow"
  }
}

To narzędzie umożliwia LLM uruchamianie poleceń terminalowych, takich jak npm install, git status lub dowolne inne polecenie powłoki.


Modyfikuj istniejące pliki poprzez precyzyjne zastępowanie tekstu.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

To narzędzie umożliwia precyzyjną edycję plików poprzez zastąpienie dokładnych dopasowań tekstu. Jest to główny sposób, w jaki LLM modyfikuje kod.


Twórz nowe pliki lub nadpisuj istniejące.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

Użyj tego, aby umożliwić LLM tworzenie nowych plików. Zastąpi istniejące pliki, jeśli już istnieją.


Odczytaj zawartość pliku z bazy kodu.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "read": "allow"
  }
}

Narzędzie to odczytuje pliki i zwraca ich zawartość. Obsługuje czytanie określonych zakresów linii w przypadku dużych plików.


Przeszukuj zawartość plików za pomocą wyrażeń regularnych.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "grep": "allow"
  }
}

Szybkie wyszukiwanie treści w całej bazie kodu. Obsługuje pełną składnię wyrażeń regularnych i filtrowanie wzorców plików.


Znajduj pliki na podstawie wzorców.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "glob": "allow"
  }
}

Szukaj plików przy użyciu wzorców glob, takich jak **/*.js lub src/**/*.ts. Zwraca pasujące ścieżki plików posortowane według czasu modyfikacji.


Interakcja ze skonfigurowanymi serwerami LSP w celu uzyskania funkcji analizy kodu, takich jak definicje, referencje, podpowiedzi (hover) i hierarchia wywołań.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "lsp": "allow"
  }
}

Obsługiwane operacje obejmują goToDefinition, findReferences, hover, documentSymbol, workspaceSymbol, goToImplementation, prepareCallHierarchy, incomingCalls i outgoingCalls.

Aby skonfigurować, które serwery LSP są dostępne dla Twojego projektu, zobacz Serwery LSP.


Stosuj łatki (patches) do plików.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "allow"
  }
}

To narzędzie stosuje pliki różnicowe (diffs) do bazy kodu. Przydatne do stosowania zmian z różnych źródeł.


Załaduj umiejętność (plik SKILL.md) i zwróć jej treść w rozmowie.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "skill": "allow"
  }
}

Pobieraj treści z sieci.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "webfetch": "allow"
  }
}

Umożliwia LLM pobieranie i odczytywanie stron internetowych. Przydatne do wyszukiwania dokumentacji lub zasobów online.


Wyszukaj informacje w Internecie.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "websearch": "allow"
  }
}

Przeszukuje Internet za pomocą Exa AI, aby znaleźć odpowiednie informacje. Przydatne do badania tematów, znajdowania bieżących wydarzeń lub zbierania informacji wykraczających poza zbiór danych treningowych.

Nie jest wymagany żaden klucz API — narzędzie łączy się bezpośrednio z usługą MCP hostowaną przez Exa AI bez uwierzytelniania.


Zadawaj pytania użytkownikowi podczas wykonywania.

opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "question": "allow"
  }
}

To narzędzie umożliwia LLM zadawanie pytań użytkownikowi podczas wykonywania zadania. Jest to przydatne do:

  • Zbierania preferencji i wymagań użytkownika
  • Doprecyzowania niejednoznacznych instrukcji
  • Podejmowania decyzji dotyczących implementacji
  • Proponowania możliwych kierunków działania

Każde pytanie zawiera nagłówek, tekst pytania i listę opcji. Użytkownicy mogą wybierać spośród dostępnych opcji lub wpisać niestandardową odpowiedź. Jeśli pytań jest wiele, użytkownicy mogą nawigować między nimi przed przesłaniem wszystkich odpowiedzi.


Niestandardowe narzędzia pozwalają zdefiniować własne funkcje, które LLM może wywołać. Są one zdefiniowane w pliku konfiguracyjnym i mogą wykonywać dowolny kod.

Więcej informacji o tworzeniu narzędzi niestandardowych.


Serwery MCP (Model Context Protocol) umożliwiają integrację zewnętrznych narzędzi i usług. Obejmuje to dostęp do baz danych, integracje API i usługi stron trzecich.

Dowiedz się więcej o konfigurowaniu serwerów MCP.


Wewnętrznie narzędzia takie jak grep i glob używają ripgrep. Domyślnie ripgrep respektuje wzorce .gitignore, co oznacza, że pliki i katalogi wymienione w Twoim .gitignore zostaną wykluczone z wyszukiwań i list.


Aby uwzględnić pliki, które normalnie byłyby ignorowane, utwórz plik .ignore w katalogu głównym projektu. Ten plik może jawnie zezwalać na określone ścieżki.

.ignore
!node_modules/
!dist/
!build/

Na przykład ten plik .ignore pozwala ripgrepowi przeszukiwać katalogi node_modules/, dist/ i build/, nawet jeśli są one wymienione w .gitignore.