wip(docs): i18n (#12681)
This commit is contained in:
Adam
@@ -0,0 +1,343 @@
|
||||
---
|
||||
title: Introduzione
|
||||
description: Inizia con OpenCode.
|
||||
---
|
||||
|
||||
import { Tabs, TabItem } from "@astrojs/starlight/components"
|
||||
import config from "../../../../config.mjs"
|
||||
export const console = config.console
|
||||
|
||||
[**OpenCode**](/) e un agente di programmazione AI open source. E disponibile come interfaccia da terminale, app desktop o estensione per IDE.
|
||||
|
||||
|
||||
|
||||
Iniziamo.
|
||||
|
||||
---
|
||||
|
||||
#### Prerequisiti
|
||||
|
||||
Per usare OpenCode nel terminale, ti serve:
|
||||
|
||||
1. Un emulatore di terminale moderno, come:
|
||||
- [WezTerm](https://wezterm.org), cross-platform
|
||||
- [Alacritty](https://alacritty.org), cross-platform
|
||||
- [Ghostty](https://ghostty.org), Linux and macOS
|
||||
- [Kitty](https://sw.kovidgoyal.net/kitty/), Linux and macOS
|
||||
|
||||
2. Le chiavi API dei provider LLM che vuoi usare.
|
||||
|
||||
---
|
||||
|
||||
## Installa
|
||||
|
||||
Il modo piu semplice per installare OpenCode e usare lo script di installazione.
|
||||
|
||||
```bash
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
```
|
||||
|
||||
Puoi anche installarlo con i seguenti comandi:
|
||||
|
||||
- **Con Node.js**
|
||||
|
||||
<Tabs>
|
||||
|
||||
<TabItem label="npm">
|
||||
```bash
|
||||
npm install -g opencode-ai
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
|
||||
<TabItem label="Bun">
|
||||
```bash
|
||||
bun install -g opencode-ai
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
|
||||
<TabItem label="pnpm">
|
||||
```bash
|
||||
pnpm install -g opencode-ai
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
|
||||
<TabItem label="Yarn">
|
||||
```bash
|
||||
yarn global add opencode-ai
|
||||
```
|
||||
|
||||
</TabItem>
|
||||
|
||||
</Tabs>
|
||||
|
||||
- **Con Homebrew su macOS e Linux**
|
||||
|
||||
```bash
|
||||
brew install anomalyco/tap/opencode
|
||||
```
|
||||
|
||||
> Ti consigliamo di usare il tap di OpenCode per avere le release piu aggiornate. La formula ufficiale `brew install opencode` e mantenuta dal team Homebrew e viene aggiornata meno spesso.
|
||||
|
||||
- **Con Paru su Arch Linux**
|
||||
|
||||
```bash
|
||||
paru -S opencode-bin
|
||||
```
|
||||
|
||||
#### Windows
|
||||
|
||||
:::tip[Consigliato: usa WSL]
|
||||
Per la migliore esperienza su Windows, ti consigliamo di usare [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). Offre prestazioni migliori e piena compatibilita con le funzionalita di OpenCode.
|
||||
:::
|
||||
|
||||
- **Con Chocolatey**
|
||||
|
||||
```bash
|
||||
choco install opencode
|
||||
```
|
||||
|
||||
- **Con Scoop**
|
||||
|
||||
```bash
|
||||
scoop install opencode
|
||||
```
|
||||
|
||||
- **Con NPM**
|
||||
|
||||
```bash
|
||||
npm install -g opencode-ai
|
||||
```
|
||||
|
||||
- **Con Mise**
|
||||
|
||||
```bash
|
||||
mise use -g github:anomalyco/opencode
|
||||
```
|
||||
|
||||
- **Con Docker**
|
||||
|
||||
```bash
|
||||
docker run -it --rm ghcr.io/anomalyco/opencode
|
||||
```
|
||||
|
||||
Il supporto per installare OpenCode su Windows usando Bun e attualmente in lavorazione.
|
||||
|
||||
Puoi anche scaricare il binario dalle [Releases](https://github.com/anomalyco/opencode/releases).
|
||||
|
||||
---
|
||||
|
||||
## Configura
|
||||
|
||||
Con OpenCode puoi usare qualsiasi provider LLM configurando le relative chiavi API.
|
||||
|
||||
Se e la prima volta che usi provider LLM, ti consigliamo [OpenCode Zen](/docs/zen).
|
||||
E una lista curata di modelli testati e verificati dal team di OpenCode.
|
||||
|
||||
1. Esegui il comando `/connect` nella TUI, seleziona opencode e vai su [opencode.ai/auth](https://opencode.ai/auth).
|
||||
|
||||
```txt
|
||||
/connect
|
||||
```
|
||||
|
||||
2. Accedi, aggiungi i dettagli di fatturazione e copia la tua chiave API.
|
||||
|
||||
3. Incolla la tua chiave API.
|
||||
|
||||
```txt
|
||||
┌ API key
|
||||
│
|
||||
│
|
||||
└ enter
|
||||
```
|
||||
|
||||
In alternativa, puoi selezionare uno degli altri provider. [Scopri di piu](/docs/providers#directory).
|
||||
|
||||
---
|
||||
|
||||
## Inizializza
|
||||
|
||||
Ora che hai configurato un provider, puoi spostarti in un progetto su cui vuoi lavorare.
|
||||
|
||||
```bash
|
||||
cd /path/to/project
|
||||
```
|
||||
|
||||
E avviare OpenCode.
|
||||
|
||||
```bash
|
||||
opencode
|
||||
```
|
||||
|
||||
Poi inizializza OpenCode per il progetto eseguendo il comando seguente.
|
||||
|
||||
```bash frame="none"
|
||||
/init
|
||||
```
|
||||
|
||||
Questo fara analizzare il progetto a OpenCode e creera un file `AGENTS.md` nella root del progetto.
|
||||
|
||||
:::tip
|
||||
Dovresti committare il file `AGENTS.md` del progetto su Git.
|
||||
:::
|
||||
|
||||
Questo aiuta OpenCode a capire la struttura del progetto e gli stili di codice usati.
|
||||
|
||||
---
|
||||
|
||||
## Usage
|
||||
|
||||
Ora sei pronto a usare OpenCode sul tuo progetto. Sentiti libero di chiedergli qualsiasi cosa!
|
||||
|
||||
Se e la prima volta che usi un agente di programmazione AI, ecco alcuni esempi che possono aiutare.
|
||||
|
||||
---
|
||||
|
||||
### Fai domande
|
||||
|
||||
Puoi chiedere a OpenCode di spiegarti la codebase.
|
||||
|
||||
:::tip
|
||||
Usa il tasto `@` per fare una ricerca fuzzy dei file nel progetto.
|
||||
:::
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
How is authentication handled in @packages/functions/src/api/index.ts
|
||||
```
|
||||
|
||||
Questo e utile se c'e una parte della codebase su cui non hai lavorato.
|
||||
|
||||
---
|
||||
|
||||
### Aggiungi funzionalita
|
||||
|
||||
Puoi chiedere a OpenCode di aggiungere nuove funzionalita al progetto. Pero ti consigliamo prima di chiedergli di creare un piano.
|
||||
|
||||
1. **Create a plan**
|
||||
|
||||
OpenCode ha una _Plan mode_ che disabilita la possibilita di fare modifiche e si limita a suggerire _come_ implementera la funzionalita.
|
||||
|
||||
Passaci con il tasto **Tab**. Vedrai un indicatore nell'angolo in basso a destra.
|
||||
|
||||
```bash frame="none" title="Switch to Plan mode"
|
||||
<TAB>
|
||||
```
|
||||
|
||||
Ora descriviamo cosa vogliamo che faccia.
|
||||
|
||||
```txt frame="none"
|
||||
When a user deletes a note, we'd like to flag it as deleted in the database.
|
||||
Then create a screen that shows all the recently deleted notes.
|
||||
From this screen, the user can undelete a note or permanently delete it.
|
||||
```
|
||||
|
||||
Devi dare a OpenCode abbastanza dettagli per capire cosa vuoi. Aiuta parlargli come se stessi parlando a uno sviluppatore junior del tuo team.
|
||||
|
||||
:::tip
|
||||
Dai a OpenCode molto contesto ed esempi per aiutarlo a capire cosa vuoi.
|
||||
:::
|
||||
|
||||
2. **Iterate on the plan**
|
||||
|
||||
Una volta che ti da un piano, puoi dargli feedback o aggiungere piu dettagli.
|
||||
|
||||
```txt frame="none"
|
||||
We'd like to design this new screen using a design I've used before.
|
||||
[Image #1] Take a look at this image and use it as a reference.
|
||||
```
|
||||
|
||||
:::tip
|
||||
Trascina e rilascia le immagini nel terminale per aggiungerle al prompt.
|
||||
:::
|
||||
|
||||
OpenCode puo analizzare le immagini che gli dai e aggiungerle al prompt. Puoi farlo trascinando e rilasciando un'immagine nel terminale.
|
||||
|
||||
3. **Build the feature**
|
||||
|
||||
Quando ti senti a tuo agio con il piano, torna in _Build mode_ premendo di nuovo il tasto **Tab**.
|
||||
|
||||
```bash frame="none"
|
||||
<TAB>
|
||||
```
|
||||
|
||||
E chiedigli di fare le modifiche.
|
||||
|
||||
```bash frame="none"
|
||||
Sounds good! Go ahead and make the changes.
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Apporta modifiche
|
||||
|
||||
Per modifiche piu semplici, puoi chiedere a OpenCode di implementarle direttamente senza dover prima rivedere un piano.
|
||||
|
||||
```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
|
||||
We need to add authentication to the /settings route. Take a look at how this is
|
||||
handled in the /notes route in @packages/functions/src/notes.ts and implement
|
||||
the same logic in @packages/functions/src/settings.ts
|
||||
```
|
||||
|
||||
Assicurati di fornire abbastanza dettagli, cosi OpenCode fa le modifiche giuste.
|
||||
|
||||
---
|
||||
|
||||
### Annulla modifiche
|
||||
|
||||
Mettiamo che tu chieda a OpenCode di fare alcune modifiche.
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
Can you refactor the function in @packages/functions/src/api/index.ts?
|
||||
```
|
||||
|
||||
Ma ti accorgi che non e quello che volevi. Puoi **annullare** le modifiche usando il comando `/undo`.
|
||||
|
||||
```bash frame="none"
|
||||
/undo
|
||||
```
|
||||
|
||||
OpenCode ora ripristina le modifiche e mostra di nuovo il tuo messaggio originale.
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
Can you refactor the function in @packages/functions/src/api/index.ts?
|
||||
```
|
||||
|
||||
Da qui puoi modificare il prompt e chiedere a OpenCode di riprovare.
|
||||
|
||||
:::tip
|
||||
Puoi eseguire `/undo` piu volte per annullare piu modifiche.
|
||||
:::
|
||||
|
||||
Oppure puoi **rifare** le modifiche usando il comando `/redo`.
|
||||
|
||||
```bash frame="none"
|
||||
/redo
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Condividi
|
||||
|
||||
Le conversazioni che fai con OpenCode possono essere [condivise con il tuo team](/docs/share).
|
||||
|
||||
```bash frame="none"
|
||||
/share
|
||||
```
|
||||
|
||||
Questo creera un link alla conversazione corrente e lo copiera negli appunti.
|
||||
|
||||
:::note
|
||||
Le conversazioni non vengono condivise per impostazione predefinita.
|
||||
:::
|
||||
|
||||
Ecco un'[esempio di conversazione](https://opencode.ai/s/4XP1fce5) con OpenCode.
|
||||
|
||||
---
|
||||
|
||||
## Personalizza
|
||||
|
||||
E tutto qui! Ora sei un pro nell'usare OpenCode.
|
||||
|
||||
Per renderlo davvero tuo, ti consigliamo di [scegliere un tema](/docs/themes), [personalizzare i tasti rapidi](/docs/keybinds), [configurare i formatter](/docs/formatters), [creare comandi personalizzati](/docs/commands) o sperimentare con la [configurazione di OpenCode](/docs/config).
|
||||
Reference in New Issue
Block a user