index.mdx 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347
  1. ---
  2. title: Wstęp
  3. description: Zacznij pracę z opencode.
  4. ---
  5. import { Tabs, TabItem } from "@astrojs/starlight/components"
  6. import config from "../../../../config.mjs"
  7. export const console = config.console
  8. [**opencode**](/) to agent kodujący AI typu open source. Jest dostępny jako interfejs terminalowy, aplikacja desktopowa i rozszerzenie IDE.
  9. ![opencode TUI z motywem opencode](../../../assets/lander/screenshot.png)
  10. Zacznijmy.
  11. ---
  12. #### Warunki wstępne
  13. Aby uzyskać dostęp do opencode w swoim terminalu, będziesz potrzebować:
  14. 1. Nowoczesny emulator terminala, taki jak:
  15. - [WezTerm](https://wezterm.org), wieloplatformowy
  16. - [Alacritty](https://alacritty.org), wieloplatformowy
  17. - [Ghostty](https://ghostty.org), Linux i macOS
  18. - [Kitty](https://sw.kovidgoyal.net/kitty/), Linux i macOS
  19. 2. Klucze API dla dostawców LLM, z których korzystasz.
  20. ---
  21. ## Instalacja
  22. Najłatwiej zainstalować opencode za pomocą skryptu instalacyjnego.
  23. ```bash
  24. curl -fsSL https://opencode.ai/install | bash
  25. ```
  26. Możesz też użyć poniższych metod instalacji:
  27. - **Przy użyciu Node.js**
  28. <Tabs>
  29. <TabItem label="npm">
  30. ```bash
  31. npm install -g opencode-ai
  32. ```
  33. </TabItem>
  34. <TabItem label="Bun">
  35. ```bash
  36. bun install -g opencode-ai
  37. ```
  38. </TabItem>
  39. <TabItem label="pnpm">
  40. ```bash
  41. pnpm install -g opencode-ai
  42. ```
  43. </TabItem>
  44. <TabItem label="Yarn">
  45. ```bash
  46. yarn global add opencode-ai
  47. ```
  48. </TabItem>
  49. </Tabs>
  50. - **Korzystanie z Homebrew na macOS i Linux**
  51. ```bash
  52. brew install anomalyco/tap/opencode
  53. ```
  54. > W celu uzyskania najbardziej aktualnej wersji zalecamy korzystanie z opencode. Oficjalna formuła `brew install opencode` jest utrzymywana przez zespół Homebrew i jest aktualizowana.
  55. - **Korzystanie z Paru na Arch Linux**
  56. ```bash
  57. sudo pacman -S opencode # Arch Linux (Stable)
  58. paru -S opencode-bin # Arch Linux (Latest from AUR)
  59. ```
  60. #### Windows
  61. :::tip[Zalecane: Uruchamianie w WSL]
  62. Aby najlepiej wykorzystać działanie w systemie Windows, zalecamy włączenie [Podsystemu Windows dla systemu Linux (WSL)](/docs/windows-wsl). Zapewnia to pełną kompatybilność z funkcjami opencode.
  63. :::
  64. - **Używając Chocolatey**
  65. ```bash
  66. choco install opencode
  67. ```
  68. - **Korzystanie z Scoop**
  69. ```bash
  70. scoop install opencode
  71. ```
  72. - **Przy użyciu NPM**
  73. ```bash
  74. npm install -g opencode-ai
  75. ```
  76. - **Używając Mise’a**
  77. ```bash
  78. mise use -g github:anomalyco/opencode
  79. ```
  80. - **Korzystanie z Dockera**
  81. ```bash
  82. docker run -it --rm ghcr.io/anomalyco/opencode
  83. ```
  84. Obecnie pracujemy nad instalacją opencode w systemie Windows za pomocą Bun.
  85. Możesz także pobrać plik binarny z [Releases](https://github.com/anomalyco/opencode/releases).
  86. ---
  87. ## Konfiguracja
  88. Dzięki opencode możesz korzystać z dowolnego dostawcy LLM, konfigurując jego klucze API.
  89. Jeśli będziesz korzystać z wielu dostawców LLM, zalecamy skorzystanie z [OpenCode Zen](/docs/zen).
  90. Aby uzyskać dostęp do wyselekcjonowanej listy modeli, które zostały zatwierdzone i zweryfikowane przez zespół opencode.
  91. 1. Uruchom polecenie `/connect` w TUI, wybierz opencode i przejdź do [opencode.ai/auth](https://opencode.ai/auth).
  92. ```txt
  93. /connect
  94. ```
  95. 2. Zaloguj się, dodaj szczegóły rozliczeniowe i skopiuj klucz API.
  96. 3. Wklej swój klucz API.
  97. ```txt
  98. ┌ API key
  99. │
  100. │
  101. └ enter
  102. ```
  103. Alternatywnie możesz wybrać jednego z dodatkowych dostawców. [Dowiedz się więcej](/docs/providers#directory).
  104. ---
  105. ## Inicjalizacja
  106. Po skonfigurowaniu dostawcy możesz przejść do projektu, nad którym chcesz pracować.
  107. ```bash
  108. cd /path/to/project
  109. ```
  110. Uruchom opencode.
  111. ```bash
  112. opencode
  113. ```
  114. Następnie zainicjuj opencode dla projektu, uruchamiając odpowiednie polecenie.
  115. ```bash frame="none"
  116. /init
  117. ```
  118. Spowoduje to, że opencode przeanalizuje Twój projekt i utworzy plik `AGENTS.md` w katalogu głównym projektu.
  119. :::tip
  120. Powinieneś zacommitować plik `AGENTS.md` swojego projektu w Git.
  121. :::
  122. Pomaga to opencode zrozumieć strukturę projektu i stosowane wzorce kodowania.
  123. ---
  124. ## Użycie
  125. Teraz możesz pracować nad swoim projektem. Możesz zapytać o wszystko!
  126. Jeśli dopiero zaczynasz korzystać z agenta kodującego AI, oto kilka wskazówek, które mogą być pomocne.
  127. ---
  128. ### Zadawaj pytania
  129. Możesz poprosić opencode o wyjaśnienie bazy kodu.
  130. :::tip
  131. Użyj `@` do wyszukiwania rozmytego plików w projekcie.
  132. :::
  133. ```txt frame="none" "@packages/functions/src/api/index.ts"
  134. How is authentication handled in @packages/functions/src/api/index.ts
  135. ```
  136. Jest to pomocne, jeśli istnieje część bazy kodu, nad którą nie pracowałeś.
  137. ---
  138. ### Dodaj funkcje
  139. Możesz poprosić opencode o dodanie nowej funkcji do Twojego projektu. Najpierw zalecamy poproszenie o przygotowanie planu.
  140. 1. **Stwórz Plan**
  141. opencode ma _Plan Mode_, który umożliwia wyłączenie zmian i
  142. zamiast tego zasugeruje, jak zaimplementować tę funkcję.
  143. Przejdź do niego za pomocą klawisza **Tab**. Zobaczysz odpowiedni wskaźnik w prawym dolnym rogu.
  144. ```bash frame="none" title="Switch to Plan mode"
  145. <TAB>
  146. ```
  147. Opiszmy teraz, co chcemy, żeby zrobił.
  148. ```txt frame="none"
  149. When a user deletes a note, we'd like to flag it as deleted in the database.
  150. Then create a screen that shows all the recently deleted notes.
  151. From this screen, the user can undelete a note or permanently delete it.
  152. ```
  153. Wersja opencode jest bardzo inteligentna, aby zrozumieć, czego chcesz. To pomaga
  154. rozmawiaj z nim tak, jakbyś rozmawiał z młodszym programistą w swoim zespole.
  155. :::tip
  156. Podaj opencode kontekst, aby zrozumiał, czego chcesz.
  157. :::
  158. 2. **Udoskonalanie planu**
  159. Gdy będziesz mieć plan, możesz zostawić go lub dodać więcej.
  160. ```txt frame="none"
  161. We'd like to design this new screen using a design I've used before.
  162. [Image #1] Take a look at this image and use it as a reference.
  163. ```
  164. :::tip
  165. Przeciągnij i upuść obrazy do terminala, aby dodać je do monitu.
  166. :::
  167. opencode może zeskanować obrazy, które mu przekażesz i zrozumieć je. Możesz to zrobić, przeciągając i upuszczając obraz do terminala.
  168. 3. **Wprowadź zmiany**
  169. Kiedy już będziesz zadowolony z planu, przełącz się z powrotem do _Act Mode_ naciskając klawisz **Tab**.
  170. ```bash frame="none"
  171. <TAB>
  172. ```
  173. Poproś o wprowadzenie zmian.
  174. ```bash frame="none"
  175. Sounds good! Go ahead and make the changes.
  176. ```
  177. ---
  178. ### Wprowadź zmiany
  179. Aby wprowadzić kolejną zmianę, możesz poprosić opencode lub zrobić to bezpośrednio bez konieczności wcześniejszego przeglądania planu.
  180. ```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
  181. We need to add authentication to the /settings route. Take a look at how this is
  182. handled in the /notes route in @packages/functions/src/notes.ts and implement
  183. the same logic in @packages/functions/src/settings.ts
  184. ```
  185. Musisz upewnić się, że dostarczyłeś odpowiednie pliki, aby opencode mógł wprowadzić zmiany.
  186. ---
  187. ### Cofnij zmiany
  188. Załóżmy, że prosisz opencode o wprowadzenie zmian.
  189. ```txt frame="none" "@packages/functions/src/api/index.ts"
  190. Can you refactor the function in @packages/functions/src/api/index.ts?
  191. ```
  192. Ale zdajesz sobie sprawę, że to nie jest to, czego chciałeś. **Możesz cofnąć** zmiany
  193. za pomocą polecenia `/undo`.
  194. ```bash frame="none"
  195. /undo
  196. ```
  197. opencode cofnie teraz zmiany i wyświetli wiadomość ponownie.
  198. ```txt frame="none" "@packages/functions/src/api/index.ts"
  199. Can you refactor the function in @packages/functions/src/api/index.ts?
  200. ```
  201. Możesz edytować monit i poprosić opencode o ponowną próbę.
  202. :::tip
  203. Możesz użyć `/undo` wiele razy, aby cofnąć wiele zmian.
  204. :::
  205. Możesz też **przywrócić** zmianę za pomocą polecenia `/redo`.
  206. ```bash frame="none"
  207. /redo
  208. ```
  209. ---
  210. ## Udostępnianie
  211. Rozmowy z opencode można [udostępniać swojemu zespołowi](/docs/share).
  212. ```bash frame="none"
  213. /share
  214. ```
  215. Spowoduje to, że link do bieżącej rozmowy zostanie skopiowany do schowka.
  216. :::note
  217. Rozmowy nie są ogólnodostępne.
  218. :::
  219. Oto [przykładowa rozmowa](https://opencode.ai/s/4XP1fce5) z opencode.
  220. ---
  221. ## Dostosuj
  222. To tyle! Jesteś teraz profesjonalistą w korzystaniu z opencode.
  223. Aby dostosować go do potrzeb, zalecamy [wybranie motywu](/docs/themes), [dostosowanie skrótów klawiaturowych](/docs/keybinds), [konfigurowanie programów formatujących kod](/docs/formatters), [tworzenie niestandardowych poleceń](/docs/commands) lub zabawę z [konfiguracją opencode](/docs/config).