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.

---

Konfiguracja

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ń.

---

Wbudowane narzędzia

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

---

bash

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.

---

edit

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.

---

write

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ą.

Notatka

Narzędzie write jest kontrolowane przez uprawnienie edit, które obejmuje wszystkie modyfikacje plików (edit, write, patch, multiedit).

---

read

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.

---

grep

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.

---

glob

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.

---

list

Wyświetla listę plików i katalogów w podanej ścieżce.

opencode.json

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

To narzędzie wyświetla zawartość katalogu. Akceptuje wzorce glob do filtrowania wyników.

---

LSP (eksperymentalne)

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

Notatka

To narzędzie jest dostępne tylko wtedy, gdy OPENCODE_EXPERIMENTAL_LSP_TOOL=true (lub OPENCODE_EXPERIMENTAL=true).

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.

---

patch

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ł.

Notatka

Narzędzie patch jest kontrolowane przez uprawnienie edit, które obejmuje wszystkie modyfikacje plików (edit, write, patch, multiedit).

---

skill

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

opencode.json

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

---

todowrite

Zarządzaj listami zadań (todo) podczas sesji kodowania.

opencode.json

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

Tworzy i aktualizuje listy zadań w celu śledzenia postępu podczas złożonych operacji. LLM wykorzystuje to do organizowania zadań wieloetapowych.

Notatka

To narzędzie jest domyślnie wyłączone dla subagentów, ale można je włączyć ręcznie. Dowiedz się więcej

---

todoread

Odczytuj istniejące listy zadań (todo).

opencode.json

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

Odczytuje bieżący stan listy rzeczy do zrobienia. Używany przez LLM do śledzenia zadań oczekujących lub ukończonych.

Notatka

To narzędzie jest domyślnie wyłączone dla subagentów, ale można je włączyć ręcznie. Dowiedz się więcej

---

webfetch

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.

---

websearch

Wyszukaj informacje w Internecie.

Notatka

To narzędzie jest dostępne tylko w przypadku korzystania z dostawcy OpenCode lub gdy zmienna środowiskowa OPENCODE_ENABLE_EXA jest ustawiona na dowolną wartość prawdziwą (np. true lub 1).

Aby włączyć przy uruchamianiu OpenCode:

OPENCODE_ENABLE_EXA=1 opencode

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.

Wskazówka

Użyj websearch, gdy chcesz znaleźć informacje (odkrywanie), i webfetch, gdy musisz pobrać treść z określonego adresu URL (pobieranie).

---

question

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.

---

Narzędzia niestandardowe

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

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.

---

Szczegóły techniczne

Wewnętrznie narzędzia takie jak grep, glob i list 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.

---

Ignorowanie plików

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.