fix(docs): translations
This commit is contained in:
@@ -1,9 +1,9 @@
|
||||
---
|
||||
title: Migrando para 1.0
|
||||
description: O que há de novo no OpenCode 1.0.
|
||||
description: O que há de novo no opencode 1.0.
|
||||
---
|
||||
|
||||
OpenCode 1.0 é uma reescrita completa do TUI.
|
||||
opencode 1.0 é uma reescrita completa do TUI.
|
||||
|
||||
Mudamos do TUI baseado em go+bubbletea, que tinha problemas de desempenho e capacidade, para um framework interno (OpenTUI) escrito em zig+solidjs.
|
||||
|
||||
@@ -13,7 +13,7 @@ O novo TUI funciona como o antigo, pois se conecta ao mesmo servidor opencode.
|
||||
|
||||
## Atualizando
|
||||
|
||||
Você não deve ser atualizado automaticamente para 1.0 se estiver usando uma versão anterior. No entanto, algumas versões mais antigas do OpenCode sempre pegam a mais recente.
|
||||
Você não deve ser atualizado automaticamente para 1.0 se estiver usando uma versão anterior. No entanto, algumas versões mais antigas do opencode sempre pegam a mais recente.
|
||||
|
||||
Para atualizar manualmente, execute
|
||||
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
title: Suporte ACP
|
||||
description: Use OpenCode em qualquer editor compatível com ACP.
|
||||
description: Use opencode em qualquer editor compatível com ACP.
|
||||
---
|
||||
|
||||
OpenCode suporta o [Agent Client Protocol](https://agentclientprotocol.com) ou (ACP), permitindo que você o utilize diretamente em editores e IDEs compatíveis.
|
||||
opencode suporta o [Agent Client Protocol](https://agentclientprotocol.com) ou (ACP), permitindo que você o utilize diretamente em editores e IDEs compatíveis.
|
||||
|
||||
:::tip
|
||||
Para uma lista de editores e ferramentas que suportam ACP, confira o [relatório de progresso do ACP](https://zed.dev/blog/acp-progress-report#available-now).
|
||||
@@ -15,9 +15,9 @@ ACP é um protocolo aberto que padroniza a comunicação entre editores de códi
|
||||
|
||||
## Configurar
|
||||
|
||||
Para usar OpenCode via ACP, configure seu editor para executar o comando `opencode acp`.
|
||||
Para usar opencode via ACP, configure seu editor para executar o comando `opencode acp`.
|
||||
|
||||
O comando inicia o OpenCode como um subprocesso compatível com ACP que se comunica com seu editor via JSON-RPC através do stdio.
|
||||
O comando inicia o opencode como um subprocesso compatível com ACP que se comunica com seu editor via JSON-RPC através do stdio.
|
||||
|
||||
Abaixo estão exemplos para editores populares que suportam ACP.
|
||||
|
||||
@@ -30,7 +30,7 @@ Adicione à sua configuração do [Zed](https://zed.dev) (`~/.config/zed/setting
|
||||
```json title="~/.config/zed/settings.json"
|
||||
{
|
||||
"agent_servers": {
|
||||
"OpenCode": {
|
||||
"opencode": {
|
||||
"command": "opencode",
|
||||
"args": ["acp"]
|
||||
}
|
||||
@@ -51,7 +51,7 @@ Você também pode vincular um atalho de teclado editando seu `keymap.json`:
|
||||
{
|
||||
"agent": {
|
||||
"custom": {
|
||||
"name": "OpenCode",
|
||||
"name": "opencode",
|
||||
"command": {
|
||||
"command": "opencode",
|
||||
"args": ["acp"]
|
||||
@@ -74,7 +74,7 @@ Adicione ao seu acp.json do [JetBrains IDE](https://www.jetbrains.com/) de acord
|
||||
```json title="acp.json"
|
||||
{
|
||||
"agent_servers": {
|
||||
"OpenCode": {
|
||||
"opencode": {
|
||||
"command": "/absolute/path/bin/opencode",
|
||||
"args": ["acp"]
|
||||
}
|
||||
@@ -82,7 +82,7 @@ Adicione ao seu acp.json do [JetBrains IDE](https://www.jetbrains.com/) de acord
|
||||
}
|
||||
```
|
||||
|
||||
Para abri-lo, use o novo agente 'OpenCode' no seletor de agentes do AI Chat.
|
||||
Para abri-lo, use o novo agente 'opencode' no seletor de agentes do AI Chat.
|
||||
|
||||
---
|
||||
|
||||
@@ -121,7 +121,7 @@ Se você precisar passar variáveis de ambiente:
|
||||
|
||||
### CodeCompanion.nvim
|
||||
|
||||
Para usar OpenCode como um agente ACP no [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), adicione o seguinte à sua configuração do Neovim:
|
||||
Para usar opencode como um agente ACP no [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), adicione o seguinte à sua configuração do Neovim:
|
||||
|
||||
```lua
|
||||
require("codecompanion").setup({
|
||||
@@ -136,13 +136,13 @@ require("codecompanion").setup({
|
||||
})
|
||||
```
|
||||
|
||||
Esta configuração configura o CodeCompanion para usar OpenCode como o agente ACP para chat.
|
||||
Esta configuração configura o CodeCompanion para usar opencode como o agente ACP para chat.
|
||||
|
||||
Se você precisar passar variáveis de ambiente (como `OPENCODE_API_KEY`), consulte [Configurando Adaptadores: Variáveis de Ambiente](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) na documentação do CodeCompanion.nvim para detalhes completos.
|
||||
|
||||
## Suporte
|
||||
|
||||
OpenCode funciona da mesma forma via ACP como funciona no terminal. Todos os recursos são suportados:
|
||||
opencode funciona da mesma forma via ACP como funciona no terminal. Todos os recursos são suportados:
|
||||
|
||||
:::note
|
||||
Alguns comandos de barra integrados, como `/undo` e `/redo`, atualmente não são suportados.
|
||||
@@ -150,7 +150,7 @@ Alguns comandos de barra integrados, como `/undo` e `/redo`, atualmente não sã
|
||||
|
||||
- Ferramentas integradas (operações de arquivo, comandos de terminal, etc.)
|
||||
- Ferramentas personalizadas e comandos de barra
|
||||
- Servidores MCP configurados na sua configuração do OpenCode
|
||||
- Servidores MCP configurados na sua configuração do opencode
|
||||
- Regras específicas do projeto do `AGENTS.md`
|
||||
- Formatadores e linters personalizados
|
||||
- Sistema de agentes e permissões
|
||||
|
||||
@@ -15,7 +15,7 @@ Você pode alternar entre agentes durante uma sessão ou invocá-los com a menç
|
||||
|
||||
## Tipos
|
||||
|
||||
Existem dois tipos de agentes no OpenCode; agentes primários e subagentes.
|
||||
Existem dois tipos de agentes no opencode; agentes primários e subagentes.
|
||||
|
||||
---
|
||||
|
||||
@@ -27,7 +27,7 @@ Agentes primários são os principais assistentes com os quais você interage di
|
||||
Você pode usar a tecla **Tab** para alternar entre agentes primários durante uma sessão.
|
||||
:::
|
||||
|
||||
OpenCode vem com dois agentes primários integrados, **Build** e **Plan**. Vamos
|
||||
opencode vem com dois agentes primários integrados, **Build** e **Plan**. Vamos
|
||||
ver isso abaixo.
|
||||
|
||||
---
|
||||
@@ -36,13 +36,13 @@ ver isso abaixo.
|
||||
|
||||
Subagentes são assistentes especializados que agentes primários podem invocar para tarefas específicas. Você também pode invocá-los manualmente mencionando-os com **@** em suas mensagens.
|
||||
|
||||
OpenCode vem com dois subagentes integrados, **General** e **Explore**. Vamos ver isso abaixo.
|
||||
opencode vem com dois subagentes integrados, **General** e **Explore**. Vamos ver isso abaixo.
|
||||
|
||||
---
|
||||
|
||||
## Integrado
|
||||
|
||||
OpenCode vem com dois agentes primários integrados e dois subagentes integrados.
|
||||
opencode vem com dois agentes primários integrados e dois subagentes integrados.
|
||||
|
||||
---
|
||||
|
||||
@@ -277,7 +277,7 @@ Os valores de temperatura geralmente variam de 0.0 a 1.0:
|
||||
}
|
||||
```
|
||||
|
||||
Se nenhuma temperatura for especificada, o OpenCode usa padrões específicos do modelo; tipicamente 0 para a maioria dos modelos, 0.55 para modelos Qwen.
|
||||
Se nenhuma temperatura for especificada, o opencode usa padrões específicos do modelo; tipicamente 0 para a maioria dos modelos, 0.55 para modelos Qwen.
|
||||
|
||||
---
|
||||
|
||||
@@ -337,7 +337,7 @@ Especifique um arquivo de prompt do sistema personalizado para este agente com a
|
||||
}
|
||||
```
|
||||
|
||||
Este caminho é relativo ao local onde o arquivo de configuração está localizado. Portanto, isso funciona tanto para a configuração global do OpenCode quanto para a configuração específica do projeto.
|
||||
Este caminho é relativo ao local onde o arquivo de configuração está localizado. Portanto, isso funciona tanto para a configuração global do opencode quanto para a configuração específica do projeto.
|
||||
|
||||
---
|
||||
|
||||
@@ -359,7 +359,7 @@ Se você não especificar um modelo, os agentes primários usam o [modelo config
|
||||
}
|
||||
```
|
||||
|
||||
O ID do modelo em sua configuração do OpenCode usa o formato `provider/model-id`. Por exemplo, se você estiver usando [OpenCode Zen](/docs/zen), você usaria `opencode/gpt-5.1-codex` para GPT 5.1 Codex.
|
||||
O ID do modelo em sua configuração do opencode usa o formato `provider/model-id`. Por exemplo, se você estiver usando [OpenCode Zen](/docs/zen), você usaria `opencode/gpt-5.1-codex` para GPT 5.1 Codex.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,17 +1,17 @@
|
||||
---
|
||||
title: CLI
|
||||
description: Opções e comandos da CLI do OpenCode.
|
||||
description: Opções e comandos da CLI do opencode.
|
||||
---
|
||||
|
||||
import { Tabs, TabItem } from "@astrojs/starlight/components"
|
||||
|
||||
A CLI do OpenCode, por padrão, inicia o [TUI](/docs/tui) quando executada sem argumentos.
|
||||
A CLI do opencode, por padrão, inicia o [TUI](/docs/tui) quando executada sem argumentos.
|
||||
|
||||
```bash
|
||||
opencode
|
||||
```
|
||||
|
||||
Mas também aceita comandos conforme documentado nesta página. Isso permite que você interaja com o OpenCode programaticamente.
|
||||
Mas também aceita comandos conforme documentado nesta página. Isso permite que você interaja com o opencode programaticamente.
|
||||
|
||||
```bash
|
||||
opencode run "Explique como closures funcionam em JavaScript"
|
||||
@@ -21,7 +21,7 @@ opencode run "Explique como closures funcionam em JavaScript"
|
||||
|
||||
### tui
|
||||
|
||||
Inicie a interface de usuário do terminal do OpenCode.
|
||||
Inicie a interface de usuário do terminal do opencode.
|
||||
|
||||
```bash
|
||||
opencode [projeto]
|
||||
@@ -44,13 +44,13 @@ opencode [projeto]
|
||||
|
||||
## Comandos
|
||||
|
||||
A CLI do OpenCode também possui os seguintes comandos.
|
||||
A CLI do opencode também possui os seguintes comandos.
|
||||
|
||||
---
|
||||
|
||||
### agent
|
||||
|
||||
Gerencie agentes para o OpenCode.
|
||||
Gerencie agentes para o opencode.
|
||||
|
||||
```bash
|
||||
opencode agent [comando]
|
||||
@@ -60,13 +60,13 @@ opencode agent [comando]
|
||||
|
||||
### attach
|
||||
|
||||
Anexe um terminal a um servidor backend do OpenCode já em execução, iniciado via comandos `serve` ou `web`.
|
||||
Anexe um terminal a um servidor backend do opencode já em execução, iniciado via comandos `serve` ou `web`.
|
||||
|
||||
```bash
|
||||
opencode attach [url]
|
||||
```
|
||||
|
||||
Isso permite usar o TUI com um backend OpenCode remoto. Por exemplo:
|
||||
Isso permite usar o TUI com um backend opencode remoto. Por exemplo:
|
||||
|
||||
```bash
|
||||
# Inicie o servidor backend para acesso web/móvel
|
||||
@@ -119,13 +119,13 @@ opencode auth [comando]
|
||||
|
||||
#### login
|
||||
|
||||
O OpenCode é alimentado pela lista de provedores em [Models.dev](https://models.dev), então você pode usar `opencode auth login` para configurar chaves de API para qualquer provedor que você gostaria de usar. Isso é armazenado em `~/.local/share/opencode/auth.json`.
|
||||
O opencode é alimentado pela lista de provedores em [Models.dev](https://models.dev), então você pode usar `opencode auth login` para configurar chaves de API para qualquer provedor que você gostaria de usar. Isso é armazenado em `~/.local/share/opencode/auth.json`.
|
||||
|
||||
```bash
|
||||
opencode auth login
|
||||
```
|
||||
|
||||
Quando o OpenCode é iniciado, ele carrega os provedores do arquivo de credenciais. E se houver chaves definidas em seus ambientes ou em um arquivo `.env` em seu projeto.
|
||||
Quando o opencode é iniciado, ele carrega os provedores do arquivo de credenciais. E se houver chaves definidas em seus ambientes ou em um arquivo `.env` em seu projeto.
|
||||
|
||||
---
|
||||
|
||||
@@ -301,7 +301,7 @@ opencode models anthropic
|
||||
| `--refresh` | Atualiza o cache de modelos a partir do models.dev |
|
||||
| `--verbose` | Use uma saída de modelo mais detalhada (inclui metadados como custos) |
|
||||
|
||||
Use a flag `--refresh` para atualizar a lista de modelos em cache. Isso é útil quando novos modelos foram adicionados a um provedor e você deseja vê-los no OpenCode.
|
||||
Use a flag `--refresh` para atualizar a lista de modelos em cache. Isso é útil quando novos modelos foram adicionados a um provedor e você deseja vê-los no opencode.
|
||||
|
||||
```bash
|
||||
opencode models --refresh
|
||||
@@ -354,7 +354,7 @@ opencode run --attach http://localhost:4096 "Explique async/await em JavaScript"
|
||||
|
||||
### serve
|
||||
|
||||
Inicie um servidor OpenCode sem cabeça para acesso à API. Confira a [documentação do servidor](/docs/server) para a interface HTTP completa.
|
||||
Inicie um servidor opencode sem cabeça para acesso à API. Confira a [documentação do servidor](/docs/server) para a interface HTTP completa.
|
||||
|
||||
```bash
|
||||
opencode serve
|
||||
@@ -375,7 +375,7 @@ Isso inicia um servidor HTTP que fornece acesso à funcionalidade do opencode se
|
||||
|
||||
### session
|
||||
|
||||
Gerencie sessões do OpenCode.
|
||||
Gerencie sessões do opencode.
|
||||
|
||||
```bash
|
||||
opencode session [comando]
|
||||
@@ -385,7 +385,7 @@ opencode session [comando]
|
||||
|
||||
#### list
|
||||
|
||||
Liste todas as sessões do OpenCode.
|
||||
Liste todas as sessões do opencode.
|
||||
|
||||
```bash
|
||||
opencode session list
|
||||
@@ -402,7 +402,7 @@ opencode session list
|
||||
|
||||
### stats
|
||||
|
||||
Mostre o uso de tokens e estatísticas de custo para suas sessões do OpenCode.
|
||||
Mostre o uso de tokens e estatísticas de custo para suas sessões do opencode.
|
||||
|
||||
```bash
|
||||
opencode stats
|
||||
@@ -433,13 +433,13 @@ Se você não fornecer um ID de sessão, será solicitado que você selecione en
|
||||
|
||||
### import
|
||||
|
||||
Importe dados da sessão de um arquivo JSON ou URL de compartilhamento do OpenCode.
|
||||
Importe dados da sessão de um arquivo JSON ou URL de compartilhamento do opencode.
|
||||
|
||||
```bash
|
||||
opencode import <arquivo>
|
||||
```
|
||||
|
||||
Você pode importar de um arquivo local ou de uma URL de compartilhamento do OpenCode.
|
||||
Você pode importar de um arquivo local ou de uma URL de compartilhamento do opencode.
|
||||
|
||||
```bash
|
||||
opencode import session.json
|
||||
@@ -450,13 +450,13 @@ opencode import https://opncd.ai/s/abc123
|
||||
|
||||
### web
|
||||
|
||||
Inicie um servidor OpenCode sem cabeça com uma interface web.
|
||||
Inicie um servidor opencode sem cabeça com uma interface web.
|
||||
|
||||
```bash
|
||||
opencode web
|
||||
```
|
||||
|
||||
Isso inicia um servidor HTTP e abre um navegador para acessar o OpenCode através de uma interface web. Defina `OPENCODE_SERVER_PASSWORD` para habilitar a autenticação básica HTTP (o nome de usuário padrão é `opencode`).
|
||||
Isso inicia um servidor HTTP e abre um navegador para acessar o opencode através de uma interface web. Defina `OPENCODE_SERVER_PASSWORD` para habilitar a autenticação básica HTTP (o nome de usuário padrão é `opencode`).
|
||||
|
||||
#### Flags
|
||||
|
||||
@@ -491,7 +491,7 @@ Este comando inicia um servidor ACP que se comunica via stdin/stdout usando nd-J
|
||||
|
||||
### uninstall
|
||||
|
||||
Desinstale o OpenCode e remova todos os arquivos relacionados.
|
||||
Desinstale o opencode e remova todos os arquivos relacionados.
|
||||
|
||||
```bash
|
||||
opencode uninstall
|
||||
@@ -551,7 +551,7 @@ A CLI do opencode aceita as seguintes flags globais.
|
||||
|
||||
## Variáveis de ambiente
|
||||
|
||||
O OpenCode pode ser configurado usando variáveis de ambiente.
|
||||
O opencode pode ser configurado usando variáveis de ambiente.
|
||||
|
||||
| Variável | Tipo | Descrição |
|
||||
| ------------------------------------- | ------- | --------------------------------------------------------------------- |
|
||||
|
||||
@@ -6,7 +6,7 @@ description: Crie comandos personalizados para tarefas repetitivas.
|
||||
Comandos personalizados permitem que você especifique um prompt que deseja executar quando esse comando for executado no TUI.
|
||||
|
||||
```bash frame="none"
|
||||
/meu-comando
|
||||
/my-command
|
||||
```
|
||||
|
||||
Comandos personalizados são adicionais aos comandos integrados como `/init`, `/undo`, `/redo`, `/share`, `/help`. [Saiba mais](/docs/tui#commands).
|
||||
@@ -42,13 +42,13 @@ Use o comando digitando `/` seguido pelo nome do comando.
|
||||
|
||||
## Configurar
|
||||
|
||||
Você pode adicionar comandos personalizados através da configuração do OpenCode ou criando arquivos markdown no diretório `commands/`.
|
||||
Você pode adicionar comandos personalizados através da configuração do opencode ou criando arquivos markdown no diretório `commands/`.
|
||||
|
||||
---
|
||||
|
||||
### JSON
|
||||
|
||||
Use a opção `command` na sua [configuração](/docs/config) do OpenCode:
|
||||
Use a opção `command` na sua [configuração](/docs/config) do opencode:
|
||||
|
||||
```json title="opencode.jsonc" {4-12}
|
||||
{
|
||||
@@ -123,10 +123,10 @@ Inclua tipagem adequada e estrutura básica.
|
||||
Execute o comando com argumentos:
|
||||
|
||||
```bash frame="none"
|
||||
/component Botão
|
||||
/component Button
|
||||
```
|
||||
|
||||
E `$ARGUMENTS` será substituído por `Botão`.
|
||||
E `$ARGUMENTS` será substituído por `Button`.
|
||||
|
||||
Você também pode acessar argumentos individuais usando parâmetros posicionais:
|
||||
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: Config
|
||||
description: Usando a configuração JSON do OpenCode.
|
||||
description: Usando a configuração JSON do opencode.
|
||||
---
|
||||
|
||||
Você pode configurar o OpenCode usando um arquivo de configuração JSON.
|
||||
Você pode configurar o opencode usando um arquivo de configuração JSON.
|
||||
|
||||
---
|
||||
|
||||
## Formato
|
||||
|
||||
O OpenCode suporta os formatos **JSON** e **JSONC** (JSON com Comentários).
|
||||
O opencode suporta os formatos **JSON** e **JSONC** (JSON com Comentários).
|
||||
|
||||
```jsonc title="opencode.jsonc"
|
||||
{
|
||||
@@ -95,7 +95,7 @@ Você pode habilitar servidores específicos em sua configuração local:
|
||||
|
||||
### Global
|
||||
|
||||
Coloque sua configuração global do OpenCode em `~/.config/opencode/opencode.json`. Use a configuração global para preferências de usuário, como temas, provedores ou atalhos de teclado.
|
||||
Coloque sua configuração global do opencode em `~/.config/opencode/opencode.json`. Use a configuração global para preferências de usuário, como temas, provedores ou atalhos de teclado.
|
||||
|
||||
A configuração global substitui os padrões organizacionais remotos.
|
||||
|
||||
@@ -109,7 +109,7 @@ Adicione `opencode.json` na raiz do seu projeto. A configuração do projeto tem
|
||||
Coloque a configuração específica do projeto na raiz do seu projeto.
|
||||
:::
|
||||
|
||||
Quando o OpenCode é iniciado, ele procura um arquivo de configuração no diretório atual ou sobe até o diretório Git mais próximo.
|
||||
Quando o opencode é iniciado, ele procura um arquivo de configuração no diretório atual ou sobe até o diretório Git mais próximo.
|
||||
|
||||
Isso também é seguro para ser verificado no Git e usa o mesmo esquema que o global.
|
||||
|
||||
@@ -197,7 +197,7 @@ Opções disponíveis:
|
||||
|
||||
- `port` - Porta para escutar.
|
||||
- `hostname` - Nome do host para escutar. Quando `mdns` está habilitado e nenhum nome de host está definido, o padrão é `0.0.0.0`.
|
||||
- `mdns` - Habilitar descoberta de serviço mDNS. Isso permite que outros dispositivos na rede descubram seu servidor OpenCode.
|
||||
- `mdns` - Habilitar descoberta de serviço mDNS. Isso permite que outros dispositivos na rede descubram seu servidor opencode.
|
||||
- `mdnsDomain` - Nome de domínio personalizado para o serviço mDNS. O padrão é `opencode.local`. Útil para executar várias instâncias na mesma rede.
|
||||
- `cors` - Origens adicionais a serem permitidas para CORS ao usar o servidor HTTP de um cliente baseado em navegador. Os valores devem ser origens completas (esquema + host + porta opcional), por exemplo, `https://app.example.com`.
|
||||
|
||||
@@ -225,7 +225,7 @@ Você pode gerenciar as ferramentas que um LLM pode usar através da opção `to
|
||||
|
||||
### Modelos
|
||||
|
||||
Você pode configurar os provedores e modelos que deseja usar em sua configuração do OpenCode através das opções `provider`, `model` e `small_model`.
|
||||
Você pode configurar os provedores e modelos que deseja usar em sua configuração do opencode através das opções `provider`, `model` e `small_model`.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -236,7 +236,7 @@ Você pode configurar os provedores e modelos que deseja usar em sua configuraç
|
||||
}
|
||||
```
|
||||
|
||||
A opção `small_model` configura um modelo separado para tarefas leves, como geração de títulos. Por padrão, o OpenCode tenta usar um modelo mais barato se um estiver disponível do seu provedor, caso contrário, ele recua para seu modelo principal.
|
||||
A opção `small_model` configura um modelo separado para tarefas leves, como geração de títulos. Por padrão, o opencode tenta usar um modelo mais barato se um estiver disponível do seu provedor, caso contrário, ele recua para seu modelo principal.
|
||||
|
||||
As opções do provedor podem incluir `timeout` e `setCacheKey`:
|
||||
|
||||
@@ -298,7 +298,7 @@ Tokens Bearer (`AWS_BEARER_TOKEN_BEDROCK` ou `/connect`) têm precedência sobre
|
||||
|
||||
### Temas
|
||||
|
||||
Você pode configurar o tema que deseja usar em sua configuração do OpenCode através da opção `theme`.
|
||||
Você pode configurar o tema que deseja usar em sua configuração do opencode através da opção `theme`.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -348,7 +348,7 @@ Você pode definir o agente padrão usando a opção `default_agent`. Isso deter
|
||||
}
|
||||
```
|
||||
|
||||
O agente padrão deve ser um agente primário (não um subagente). Isso pode ser um agente embutido como `"build"` ou `"plan"`, ou um [agente personalizado](/docs/agents) que você definiu. Se o agente especificado não existir ou for um subagente, o OpenCode recuará para `"build"` com um aviso.
|
||||
O agente padrão deve ser um agente primário (não um subagente). Isso pode ser um agente embutido como `"build"` ou `"plan"`, ou um [agente personalizado](/docs/agents) que você definiu. Se o agente especificado não existir ou for um subagente, o opencode recuará para `"build"` com um aviso.
|
||||
|
||||
Essa configuração se aplica a todas as interfaces: TUI, CLI (`opencode run`), aplicativo desktop e GitHub Action.
|
||||
|
||||
@@ -418,7 +418,7 @@ Você pode personalizar seus atalhos de teclado através da opção `keybinds`.
|
||||
|
||||
### Atualização automática
|
||||
|
||||
O OpenCode fará o download automaticamente de quaisquer novas atualizações quando for iniciado. Você pode desabilitar isso com a opção `autoupdate`.
|
||||
O opencode fará o download automaticamente de quaisquer novas atualizações quando for iniciado. Você pode desabilitar isso com a opção `autoupdate`.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -531,7 +531,7 @@ Você pode configurar servidores MCP que deseja usar através da opção `mcp`.
|
||||
|
||||
### Plugins
|
||||
|
||||
[Plugins](/docs/plugins) estendem o OpenCode com ferramentas, hooks e integrações personalizadas.
|
||||
[Plugins](/docs/plugins) estendem o opencode com ferramentas, hooks e integrações personalizadas.
|
||||
|
||||
Coloque arquivos de plugin em `.opencode/plugins/` ou `~/.config/opencode/plugins/`. Você também pode carregar plugins do npm através da opção `plugin`.
|
||||
|
||||
@@ -595,7 +595,7 @@ Você pode especificar uma lista de permissão de provedores através da opção
|
||||
}
|
||||
```
|
||||
|
||||
Isso é útil quando você deseja restringir o OpenCode para usar apenas provedores específicos, em vez de desabilitá-los um a um.
|
||||
Isso é útil quando você deseja restringir o opencode para usar apenas provedores específicos, em vez de desabilitá-los um a um.
|
||||
|
||||
:::note
|
||||
A opção `disabled_providers` tem prioridade sobre `enabled_providers`.
|
||||
|
||||
@@ -36,7 +36,7 @@ export default tool({
|
||||
},
|
||||
async execute(args) {
|
||||
// Sua lógica de banco de dados aqui
|
||||
return `Consulta executada: ${args.query}`
|
||||
return `Executed query: ${args.query}`
|
||||
},
|
||||
})
|
||||
```
|
||||
@@ -121,7 +121,7 @@ export default tool({
|
||||
async execute(args, context) {
|
||||
// Acessar informações do contexto
|
||||
const { agent, sessionID, messageID, directory, worktree } = context
|
||||
return `Agente: ${agent}, Sessão: ${sessionID}, Mensagem: ${messageID}, Diretório: ${directory}, Worktree: ${worktree}`
|
||||
return `Agent: ${agent}, Session: ${sessionID}, Message: ${messageID}, Directory: ${directory}, Worktree: ${worktree}`
|
||||
},
|
||||
})
|
||||
```
|
||||
|
||||
@@ -1,12 +1,12 @@
|
||||
---
|
||||
title: Ecossistema
|
||||
description: Projetos e integrações construídos com OpenCode.
|
||||
description: Projetos e integrações construídos com opencode.
|
||||
---
|
||||
|
||||
Uma coleção de projetos da comunidade construídos sobre o OpenCode.
|
||||
Uma coleção de projetos da comunidade construídos sobre o opencode.
|
||||
|
||||
:::note
|
||||
Quer adicionar seu projeto relacionado ao OpenCode a esta lista? Envie um PR.
|
||||
Quer adicionar seu projeto relacionado ao opencode a esta lista? Envie um PR.
|
||||
:::
|
||||
|
||||
Você também pode conferir [awesome-opencode](https://github.com/awesome-opencode/awesome-opencode) e [opencode.cafe](https://opencode.cafe), uma comunidade que agrega o ecossistema e a comunidade.
|
||||
@@ -17,7 +17,7 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
|
||||
|
||||
| Nome | Descrição |
|
||||
| --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | Execute automaticamente sessões do OpenCode em sandboxes isoladas do Daytona com sincronização git e pré-visualizações ao vivo |
|
||||
| [opencode-daytona](https://github.com/jamesmurdza/daytona/blob/main/guides/typescript/opencode/README.md) | Execute automaticamente sessões do opencode em sandboxes isoladas do Daytona com sincronização git e pré-visualizações ao vivo |
|
||||
| [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) | Injete automaticamente cabeçalhos de sessão Helicone para agrupamento de requisições |
|
||||
| [opencode-type-inject](https://github.com/nick-vi/opencode-type-inject) | Auto-injetar tipos TypeScript/Svelte em leituras de arquivos com ferramentas de busca |
|
||||
| [opencode-openai-codex-auth](https://github.com/numman-ali/opencode-openai-codex-auth) | Use sua assinatura ChatGPT Plus/Pro em vez de créditos de API |
|
||||
@@ -29,14 +29,14 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
|
||||
| [opencode-websearch-cited](https://github.com/ghoulr/opencode-websearch-cited.git) | Adicione suporte nativo de pesquisa na web para provedores suportados com estilo fundamentado no Google |
|
||||
| [opencode-pty](https://github.com/shekohex/opencode-pty.git) | Permite que agentes de IA executem processos em segundo plano em um PTY, enviando entrada interativa para eles. |
|
||||
| [opencode-shell-strategy](https://github.com/JRedeker/opencode-shell-strategy) | Instruções para comandos de shell não interativos - evita travamentos de operações dependentes de TTY |
|
||||
| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | Acompanhe o uso do OpenCode com Wakatime |
|
||||
| [opencode-wakatime](https://github.com/angristan/opencode-wakatime) | Acompanhe o uso do opencode com Wakatime |
|
||||
| [opencode-md-table-formatter](https://github.com/franlol/opencode-md-table-formatter/tree/main) | Limpe tabelas markdown produzidas por LLMs |
|
||||
| [opencode-morph-fast-apply](https://github.com/JRedeker/opencode-morph-fast-apply) | Edição de código 10x mais rápida com a API Morph Fast Apply e marcadores de edição preguiçosos |
|
||||
| [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode) | Agentes em segundo plano, ferramentas LSP/AST/MCP pré-construídas, agentes curados, compatível com Claude Code |
|
||||
| [opencode-notificator](https://github.com/panta82/opencode-notificator) | Notificações de desktop e alertas sonoros para sessões do OpenCode |
|
||||
| [opencode-notificator](https://github.com/panta82/opencode-notificator) | Notificações de desktop e alertas sonoros para sessões do opencode |
|
||||
| [opencode-notifier](https://github.com/mohak34/opencode-notifier) | Notificações de desktop e alertas sonoros para eventos de permissão, conclusão e erro |
|
||||
| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Nomeação automática de sessões Zellij com suporte de IA com base no contexto do OpenCode |
|
||||
| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | Permite que agentes do OpenCode carreguem prompts sob demanda com descoberta e injeção de habilidades |
|
||||
| [opencode-zellij-namer](https://github.com/24601/opencode-zellij-namer) | Nomeação automática de sessões Zellij com suporte de IA com base no contexto do opencode |
|
||||
| [opencode-skillful](https://github.com/zenobi-us/opencode-skillful) | Permite que agentes do opencode carreguem prompts sob demanda com descoberta e injeção de habilidades |
|
||||
| [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory) | Memória persistente entre sessões usando Supermemory |
|
||||
| [@plannotator/opencode](https://github.com/backnotprop/plannotator/tree/main/apps/opencode-plugin) | Revisão de plano interativa com anotação visual e compartilhamento privado/offline |
|
||||
| [@openspoon/subtask2](https://github.com/spoons-and-mirrors/subtask2) | Estenda opencode /commands em um poderoso sistema de orquestração com controle de fluxo granular |
|
||||
@@ -44,9 +44,9 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
|
||||
| [micode](https://github.com/vtemian/micode) | Fluxo de trabalho Estruturado Brainstorm → Planejar → Implementar com continuidade de sessão |
|
||||
| [octto](https://github.com/vtemian/octto) | UI interativa do navegador para brainstorming de IA com formulários de múltiplas perguntas |
|
||||
| [opencode-background-agents](https://github.com/kdcokenny/opencode-background-agents) | Agentes em segundo plano estilo Claude Code com delegação assíncrona e persistência de contexto |
|
||||
| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | Notificações nativas do OS para OpenCode – saiba quando as tarefas são concluídas |
|
||||
| [opencode-notify](https://github.com/kdcokenny/opencode-notify) | Notificações nativas do OS para opencode – saiba quando as tarefas são concluídas |
|
||||
| [opencode-workspace](https://github.com/kdcokenny/opencode-workspace) | Conjunto de orquestração multi-agente – 16 componentes, uma instalação |
|
||||
| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | Worktrees git sem atrito para OpenCode |
|
||||
| [opencode-worktree](https://github.com/kdcokenny/opencode-worktree) | Worktrees git sem atrito para opencode |
|
||||
|
||||
---
|
||||
|
||||
@@ -54,17 +54,17 @@ Você também pode conferir [awesome-opencode](https://github.com/awesome-openco
|
||||
|
||||
| Nome | Descrição |
|
||||
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------- |
|
||||
| [kimaki](https://github.com/remorses/kimaki) | Bot do Discord para controlar sessões do OpenCode, construído sobre o SDK |
|
||||
| [kimaki](https://github.com/remorses/kimaki) | Bot do Discord para controlar sessões do opencode, construído sobre o SDK |
|
||||
| [opencode.nvim](https://github.com/NickvanDyke/opencode.nvim) | Plugin Neovim para prompts cientes do editor, construído sobre a API |
|
||||
| [portal](https://github.com/hosenur/portal) | UI web mobile-first para OpenCode sobre Tailscale/VPN |
|
||||
| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | Template para construir plugins do OpenCode |
|
||||
| [portal](https://github.com/hosenur/portal) | UI web mobile-first para opencode sobre Tailscale/VPN |
|
||||
| [opencode plugin template](https://github.com/zenobi-us/opencode-plugin-template/) | Template para construir plugins do opencode |
|
||||
| [opencode.nvim](https://github.com/sudo-tee/opencode.nvim) | Frontend Neovim para opencode - um agente de codificação AI baseado em terminal |
|
||||
| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Provedor Vercel AI SDK para usar OpenCode via @opencode-ai/sdk |
|
||||
| [OpenChamber](https://github.com/btriapitsyn/openchamber) | Aplicativo Web / Desktop e Extensão do VS Code para OpenCode |
|
||||
| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian) | Plugin Obsidian que incorpora OpenCode na UI do Obsidian |
|
||||
| [OpenWork](https://github.com/different-ai/openwork) | Uma alternativa de código aberto ao Claude Cowork, alimentada pelo OpenCode |
|
||||
| [ocx](https://github.com/kdcokenny/ocx) | Gerenciador de extensões OpenCode com perfis portáteis e isolados. |
|
||||
| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | Aplicativo Desktop, Web, Mobile e Cliente Remoto para OpenCode |
|
||||
| [ai-sdk-provider-opencode-sdk](https://github.com/ben-vargas/ai-sdk-provider-opencode-sdk) | Provedor Vercel AI SDK para usar opencode via @opencode-ai/sdk |
|
||||
| [OpenChamber](https://github.com/btriapitsyn/openchamber) | Aplicativo Web / Desktop e Extensão do VS Code para opencode |
|
||||
| [OpenCode-Obsidian](https://github.com/mtymek/opencode-obsidian) | Plugin Obsidian que incorpora opencode na UI do Obsidian |
|
||||
| [OpenWork](https://github.com/different-ai/openwork) | Uma alternativa de código aberto ao Claude Cowork, alimentada pelo opencode |
|
||||
| [ocx](https://github.com/kdcokenny/ocx) | Gerenciador de extensões opencode com perfis portáteis e isolados. |
|
||||
| [CodeNomad](https://github.com/NeuralNomadsAI/CodeNomad) | Aplicativo Desktop, Web, Mobile e Cliente Remoto para opencode |
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,18 +1,18 @@
|
||||
---
|
||||
title: Empresa
|
||||
description: Usando OpenCode com segurança em sua organização.
|
||||
description: Usando opencode com segurança em sua organização.
|
||||
---
|
||||
|
||||
import config from "../../../../config.mjs"
|
||||
export const email = `mailto:${config.email}`
|
||||
|
||||
OpenCode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno.
|
||||
opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno.
|
||||
|
||||
:::note
|
||||
OpenCode não armazena nenhum de seus códigos ou dados de contexto.
|
||||
opencode não armazena nenhum de seus códigos ou dados de contexto.
|
||||
:::
|
||||
|
||||
Para começar com OpenCode Enterprise:
|
||||
Para começar com opencode Enterprise:
|
||||
|
||||
1. Faça um teste internamente com sua equipe.
|
||||
2. **<a href={email}>Entre em contato conosco</a>** para discutir opções de preços e implementação.
|
||||
@@ -21,15 +21,15 @@ Para começar com OpenCode Enterprise:
|
||||
|
||||
## Teste
|
||||
|
||||
OpenCode é de código aberto e não armazena nenhum de seus códigos ou dados de contexto, então seus desenvolvedores podem simplesmente [começar](/docs/) e realizar um teste.
|
||||
opencode é de código aberto e não armazena nenhum de seus códigos ou dados de contexto, então seus desenvolvedores podem simplesmente [começar](/docs/) e realizar um teste.
|
||||
|
||||
---
|
||||
|
||||
### Manipulação de dados
|
||||
|
||||
**OpenCode não armazena seu código ou dados de contexto.** Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA.
|
||||
**opencode não armazena seu código ou dados de contexto.** Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA.
|
||||
|
||||
Isso significa que, enquanto você estiver usando um provedor em quem confia, ou um gateway de IA interno, você pode usar o OpenCode com segurança.
|
||||
Isso significa que, enquanto você estiver usando um provedor em quem confia, ou um gateway de IA interno, você pode usar o opencode com segurança.
|
||||
|
||||
A única ressalva aqui é o recurso opcional `/share`.
|
||||
|
||||
@@ -56,25 +56,25 @@ Recomendamos que você desative isso para seu teste.
|
||||
|
||||
### Propriedade do código
|
||||
|
||||
**Você possui todo o código produzido pelo OpenCode.** Não há restrições de licenciamento ou reivindicações de propriedade.
|
||||
**Você possui todo o código produzido pelo opencode.** Não há restrições de licenciamento ou reivindicações de propriedade.
|
||||
|
||||
---
|
||||
|
||||
## Preços
|
||||
|
||||
Usamos um modelo por assento para o OpenCode Enterprise. Se você tiver seu próprio gateway LLM, não cobramos pelos tokens usados. Para mais detalhes sobre preços e opções de implementação, **<a href={email}>entre em contato conosco</a>**.
|
||||
Usamos um modelo por assento para o opencode Enterprise. Se você tiver seu próprio gateway LLM, não cobramos pelos tokens usados. Para mais detalhes sobre preços e opções de implementação, **<a href={email}>entre em contato conosco</a>**.
|
||||
|
||||
---
|
||||
|
||||
## Implantação
|
||||
|
||||
Uma vez que você tenha concluído seu teste e esteja pronto para usar o OpenCode em sua organização, você pode **<a href={email}>entrar em contato conosco</a>** para discutir preços e opções de implementação.
|
||||
Uma vez que você tenha concluído seu teste e esteja pronto para usar o opencode em sua organização, você pode **<a href={email}>entrar em contato conosco</a>** para discutir preços e opções de implementação.
|
||||
|
||||
---
|
||||
|
||||
### Configuração Central
|
||||
|
||||
Podemos configurar o OpenCode para usar uma única configuração central para toda a sua organização.
|
||||
Podemos configurar o opencode para usar uma única configuração central para toda a sua organização.
|
||||
|
||||
Essa configuração centralizada pode se integrar ao seu provedor de SSO e garante que todos os usuários acessem apenas seu gateway de IA interno.
|
||||
|
||||
@@ -82,15 +82,15 @@ Essa configuração centralizada pode se integrar ao seu provedor de SSO e garan
|
||||
|
||||
### Integração SSO
|
||||
|
||||
Através da configuração central, o OpenCode pode se integrar ao provedor de SSO de sua organização para autenticação.
|
||||
Através da configuração central, o opencode pode se integrar ao provedor de SSO de sua organização para autenticação.
|
||||
|
||||
Isso permite que o OpenCode obtenha credenciais para seu gateway de IA interno através do seu sistema de gerenciamento de identidade existente.
|
||||
Isso permite que o opencode obtenha credenciais para seu gateway de IA interno através do seu sistema de gerenciamento de identidade existente.
|
||||
|
||||
---
|
||||
|
||||
### Gateway de IA Interno
|
||||
|
||||
Com a configuração central, o OpenCode também pode ser configurado para usar apenas seu gateway de IA interno.
|
||||
Com a configuração central, o opencode também pode ser configurado para usar apenas seu gateway de IA interno.
|
||||
|
||||
Você também pode desativar todos os outros provedores de IA, garantindo que todas as solicitações passem pela infraestrutura aprovada de sua organização.
|
||||
|
||||
@@ -107,16 +107,16 @@ Isso está atualmente em nosso roadmap. Se você estiver interessado, **<a href=
|
||||
## FAQ
|
||||
|
||||
<details>
|
||||
<summary>O que é OpenCode Enterprise?</summary>
|
||||
<summary>O que é opencode Enterprise?</summary>
|
||||
|
||||
OpenCode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno.
|
||||
opencode Enterprise é para organizações que desejam garantir que seu código e dados nunca deixem sua infraestrutura. Isso pode ser feito usando uma configuração centralizada que se integra ao seu SSO e gateway de IA interno.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Como posso começar com OpenCode Enterprise?</summary>
|
||||
<summary>Como posso começar com opencode Enterprise?</summary>
|
||||
|
||||
Basta começar com um teste interno com sua equipe. O OpenCode, por padrão, não armazena seu código ou dados de contexto, facilitando o início.
|
||||
Basta começar com um teste interno com sua equipe. O opencode, por padrão, não armazena seu código ou dados de contexto, facilitando o início.
|
||||
|
||||
Depois, **<a href={email}>entre em contato conosco</a>** para discutir opções de preços e implementação.
|
||||
|
||||
@@ -130,16 +130,16 @@ Oferecemos preços empresariais por assento. Se você tiver seu próprio gateway
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Meus dados estão seguros com OpenCode Enterprise?</summary>
|
||||
<summary>Meus dados estão seguros com opencode Enterprise?</summary>
|
||||
|
||||
Sim. O OpenCode não armazena seu código ou dados de contexto. Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA. Com a configuração central e a integração SSO, seus dados permanecem seguros dentro da infraestrutura de sua organização.
|
||||
Sim. O opencode não armazena seu código ou dados de contexto. Todo o processamento acontece localmente ou através de chamadas diretas de API para seu provedor de IA. Com a configuração central e a integração SSO, seus dados permanecem seguros dentro da infraestrutura de sua organização.
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Podemos usar nosso próprio registro NPM privado?</summary>
|
||||
|
||||
O OpenCode suporta registros npm privados através do suporte nativo do arquivo `.npmrc` do Bun. Se sua organização usa um registro privado, como JFrog Artifactory, Nexus ou similar, certifique-se de que os desenvolvedores estejam autenticados antes de executar o OpenCode.
|
||||
O opencode suporta registros npm privados através do suporte nativo do arquivo `.npmrc` do Bun. Se sua organização usa um registro privado, como JFrog Artifactory, Nexus ou similar, certifique-se de que os desenvolvedores estejam autenticados antes de executar o opencode.
|
||||
|
||||
Para configurar a autenticação com seu registro privado:
|
||||
|
||||
@@ -147,11 +147,11 @@ Para configurar a autenticação com seu registro privado:
|
||||
npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/
|
||||
```
|
||||
|
||||
Isso cria `~/.npmrc` com os detalhes de autenticação. O OpenCode irá automaticamente
|
||||
Isso cria `~/.npmrc` com os detalhes de autenticação. O opencode irá automaticamente
|
||||
capturar isso.
|
||||
|
||||
:::caution
|
||||
Você deve estar logado no registro privado antes de executar o OpenCode.
|
||||
Você deve estar logado no registro privado antes de executar o opencode.
|
||||
:::
|
||||
|
||||
Alternativamente, você pode configurar manualmente um arquivo `.npmrc`:
|
||||
@@ -161,6 +161,6 @@ registry=https://your-company.jfrog.io/api/npm/npm-virtual/
|
||||
//your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN}
|
||||
```
|
||||
|
||||
Os desenvolvedores devem estar logados no registro privado antes de executar o OpenCode para garantir que os pacotes possam ser instalados a partir do seu registro empresarial.
|
||||
Os desenvolvedores devem estar logados no registro privado antes de executar o opencode para garantir que os pacotes possam ser instalados a partir do seu registro empresarial.
|
||||
|
||||
</details>
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: Formatadores
|
||||
description: OpenCode usa formatadores específicos de linguagem.
|
||||
description: opencode usa formatadores específicos de linguagem.
|
||||
---
|
||||
|
||||
OpenCode formata automaticamente arquivos após serem escritos ou editados usando formatadores específicos de linguagem. Isso garante que o código gerado siga os estilos de código do seu projeto.
|
||||
opencode formata automaticamente arquivos após serem escritos ou editados usando formatadores específicos de linguagem. Isso garante que o código gerado siga os estilos de código do seu projeto.
|
||||
|
||||
---
|
||||
|
||||
## Integrado
|
||||
|
||||
OpenCode vem com vários formatadores integrados para linguagens e frameworks populares. Abaixo está uma lista dos formatadores, extensões de arquivo suportadas e comandos ou opções de configuração necessárias.
|
||||
opencode vem com vários formatadores integrados para linguagens e frameworks populares. Abaixo está uma lista dos formatadores, extensões de arquivo suportadas e comandos ou opções de configuração necessárias.
|
||||
|
||||
| Formatador | Extensões | Requisitos |
|
||||
| -------------------- | ------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
|
||||
@@ -38,13 +38,13 @@ OpenCode vem com vários formatadores integrados para linguagens e frameworks po
|
||||
| oxfmt (Experimental) | .js, .jsx, .ts, .tsx | Dependência `oxfmt` em `package.json` e uma [variável de ambiente experimental](/docs/cli/#experimental) |
|
||||
| ormolu | .hs | Comando `ormolu` disponível |
|
||||
|
||||
Portanto, se seu projeto tiver `prettier` em seu `package.json`, o OpenCode o usará automaticamente.
|
||||
Portanto, se seu projeto tiver `prettier` em seu `package.json`, o opencode o usará automaticamente.
|
||||
|
||||
---
|
||||
|
||||
## Como funciona
|
||||
|
||||
Quando o OpenCode escreve ou edita um arquivo, ele:
|
||||
Quando o opencode escreve ou edita um arquivo, ele:
|
||||
|
||||
1. Verifica a extensão do arquivo em relação a todos os formatadores habilitados.
|
||||
2. Executa o comando do formatador apropriado no arquivo.
|
||||
@@ -56,7 +56,7 @@ Esse processo acontece em segundo plano, garantindo que seus estilos de código
|
||||
|
||||
## Configurar
|
||||
|
||||
Você pode personalizar os formatadores através da seção `formatter` em sua configuração do OpenCode.
|
||||
Você pode personalizar os formatadores através da seção `formatter` em sua configuração do opencode.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
|
||||
@@ -1,17 +1,17 @@
|
||||
---
|
||||
title: GitHub
|
||||
description: Use OpenCode em problemas e pull-requests do GitHub.
|
||||
description: Use opencode em problemas e pull-requests do GitHub.
|
||||
---
|
||||
|
||||
OpenCode integra-se ao seu fluxo de trabalho do GitHub. Mencione `/opencode` ou `/oc` em seu comentário, e o OpenCode executará tarefas dentro do seu runner do GitHub Actions.
|
||||
opencode integra-se ao seu fluxo de trabalho do GitHub. Mencione `/opencode` ou `/oc` em seu comentário, e o opencode executará tarefas dentro do seu runner do GitHub Actions.
|
||||
|
||||
---
|
||||
|
||||
## Recursos
|
||||
|
||||
- **Triagem de problemas**: Peça ao OpenCode para analisar um problema e explicá-lo para você.
|
||||
- **Corrigir e implementar**: Peça ao OpenCode para corrigir um problema ou implementar um recurso. E ele trabalhará em um novo branch e enviará um PR com todas as alterações.
|
||||
- **Seguro**: O OpenCode é executado dentro dos runners do seu GitHub.
|
||||
- **Triagem de problemas**: Peça ao opencode para analisar um problema e explicá-lo para você.
|
||||
- **Corrigir e implementar**: Peça ao opencode para corrigir um problema ou implementar um recurso. E ele trabalhará em um novo branch e enviará um PR com todas as alterações.
|
||||
- **Seguro**: O opencode é executado dentro dos runners do seu GitHub.
|
||||
|
||||
---
|
||||
|
||||
@@ -63,7 +63,7 @@ Ou você pode configurá-lo manualmente.
|
||||
fetch-depth: 1
|
||||
persist-credentials: false
|
||||
|
||||
- name: Run OpenCode
|
||||
- name: Run opencode
|
||||
uses: anomalyco/opencode/github@latest
|
||||
env:
|
||||
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
|
||||
@@ -81,13 +81,13 @@ Ou você pode configurá-lo manualmente.
|
||||
|
||||
## Configuração
|
||||
|
||||
- `model`: O modelo a ser usado com o OpenCode. Tem o formato de `provider/model`. Isso é **obrigatório**.
|
||||
- `model`: O modelo a ser usado com o opencode. Tem o formato de `provider/model`. Isso é **obrigatório**.
|
||||
- `agent`: O agente a ser usado. Deve ser um agente primário. Retorna ao `default_agent` da configuração ou `"build"` se não encontrado.
|
||||
- `share`: Se deve compartilhar a sessão do OpenCode. O padrão é **true** para repositórios públicos.
|
||||
- `prompt`: Prompt personalizado opcional para substituir o comportamento padrão. Use isso para personalizar como o OpenCode processa solicitações.
|
||||
- `token`: Token de acesso do GitHub opcional para realizar operações como criar comentários, confirmar alterações e abrir pull requests. Por padrão, o OpenCode usa o token de acesso da instalação do aplicativo GitHub OpenCode, então commits, comentários e pull requests aparecem como se fossem da aplicação.
|
||||
- `share`: Se deve compartilhar a sessão do opencode. O padrão é **true** para repositórios públicos.
|
||||
- `prompt`: Prompt personalizado opcional para substituir o comportamento padrão. Use isso para personalizar como o opencode processa solicitações.
|
||||
- `token`: Token de acesso do GitHub opcional para realizar operações como criar comentários, confirmar alterações e abrir pull requests. Por padrão, o opencode usa o token de acesso da instalação do aplicativo GitHub opencode, então commits, comentários e pull requests aparecem como se fossem da aplicação.
|
||||
|
||||
Alternativamente, você pode usar o [`GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) embutido do runner do GitHub Action sem instalar o aplicativo GitHub OpenCode. Apenas certifique-se de conceder as permissões necessárias em seu fluxo de trabalho:
|
||||
Alternativamente, você pode usar o [`GITHUB_TOKEN`](https://docs.github.com/en/actions/tutorials/authenticate-with-github_token) embutido do runner do GitHub Action sem instalar o aplicativo GitHub opencode. Apenas certifique-se de conceder as permissões necessárias em seu fluxo de trabalho:
|
||||
|
||||
```yaml
|
||||
permissions:
|
||||
@@ -103,23 +103,23 @@ Ou você pode configurá-lo manualmente.
|
||||
|
||||
## Eventos Suportados
|
||||
|
||||
O OpenCode pode ser acionado pelos seguintes eventos do GitHub:
|
||||
O opencode pode ser acionado pelos seguintes eventos do GitHub:
|
||||
|
||||
| Tipo de Evento | Acionado Por | Detalhes |
|
||||
| ----------------------------- | --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `issue_comment` | Comentário em um problema ou PR | Mencione `/opencode` ou `/oc` em seu comentário. O OpenCode lê o contexto e pode criar branches, abrir PRs ou responder. |
|
||||
| `pull_request_review_comment` | Comentário em linhas de código específicas em um PR | Mencione `/opencode` ou `/oc` enquanto revisa o código. O OpenCode recebe o caminho do arquivo, números das linhas e contexto do diff. |
|
||||
| `issues` | Problema aberto ou editado | Aciona automaticamente o OpenCode quando problemas são criados ou modificados. Requer entrada de `prompt`. |
|
||||
| `pull_request` | PR aberto ou atualizado | Aciona automaticamente o OpenCode quando PRs são abertos, sincronizados ou reabertos. Útil para revisões automatizadas. |
|
||||
| `schedule` | Cron baseado em agendamento | Execute o OpenCode em um cronograma. Requer entrada de `prompt`. A saída vai para logs e PRs (sem problema para comentar). |
|
||||
| `workflow_dispatch` | Acionamento manual pela interface do GitHub | Acione o OpenCode sob demanda através da aba Ações. Requer entrada de `prompt`. A saída vai para logs e PRs. |
|
||||
| `issue_comment` | Comentário em um problema ou PR | Mencione `/opencode` ou `/oc` em seu comentário. O opencode lê o contexto e pode criar branches, abrir PRs ou responder. |
|
||||
| `pull_request_review_comment` | Comentário em linhas de código específicas em um PR | Mencione `/opencode` ou `/oc` enquanto revisa o código. O opencode recebe o caminho do arquivo, números das linhas e contexto do diff. |
|
||||
| `issues` | Problema aberto ou editado | Aciona automaticamente o opencode quando problemas são criados ou modificados. Requer entrada de `prompt`. |
|
||||
| `pull_request` | PR aberto ou atualizado | Aciona automaticamente o opencode quando PRs são abertos, sincronizados ou reabertos. Útil para revisões automatizadas. |
|
||||
| `schedule` | Cron baseado em agendamento | Execute o opencode em um cronograma. Requer entrada de `prompt`. A saída vai para logs e PRs (sem problema para comentar). |
|
||||
| `workflow_dispatch` | Acionamento manual pela interface do GitHub | Acione o opencode sob demanda através da aba Ações. Requer entrada de `prompt`. A saída vai para logs e PRs. |
|
||||
|
||||
### Exemplo de Agendamento
|
||||
|
||||
Execute o OpenCode em um cronograma para realizar tarefas automatizadas:
|
||||
Execute o opencode em um cronograma para realizar tarefas automatizadas:
|
||||
|
||||
```yaml title=".github/workflows/opencode-scheduled.yml"
|
||||
name: Tarefa Agendada OpenCode
|
||||
name: Tarefa Agendada opencode
|
||||
|
||||
on:
|
||||
schedule:
|
||||
@@ -139,7 +139,7 @@ jobs:
|
||||
with:
|
||||
persist-credentials: false
|
||||
|
||||
- name: Run OpenCode
|
||||
- name: Run opencode
|
||||
uses: anomalyco/opencode/github@latest
|
||||
env:
|
||||
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
|
||||
@@ -150,7 +150,7 @@ jobs:
|
||||
Se você encontrar problemas que valem a pena serem abordados, abra um problema para rastreá-los.
|
||||
```
|
||||
|
||||
Para eventos agendados, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções. Fluxos de trabalho agendados são executados sem um contexto de usuário para verificação de permissões, então o fluxo de trabalho deve conceder `contents: write` e `pull-requests: write` se você espera que o OpenCode crie branches ou PRs.
|
||||
Para eventos agendados, a entrada `prompt` é **obrigatória** uma vez que não há comentário para extrair instruções. Fluxos de trabalho agendados são executados sem um contexto de usuário para verificação de permissões, então o fluxo de trabalho deve conceder `contents: write` e `pull-requests: write` se você espera que o opencode crie branches ou PRs.
|
||||
|
||||
---
|
||||
|
||||
@@ -191,7 +191,7 @@ jobs:
|
||||
- Sugira melhorias
|
||||
```
|
||||
|
||||
Para eventos de `pull_request`, se nenhum `prompt` for fornecido, o OpenCode padrão será revisar o pull request.
|
||||
Para eventos de `pull_request`, se nenhum `prompt` for fornecido, o opencode padrão será revisar o pull request.
|
||||
|
||||
---
|
||||
|
||||
@@ -252,7 +252,7 @@ Para eventos de `issues`, a entrada `prompt` é **obrigatória** uma vez que nã
|
||||
|
||||
## Prompts Personalizados
|
||||
|
||||
Substitua o prompt padrão para personalizar o comportamento do OpenCode para seu fluxo de trabalho.
|
||||
Substitua o prompt padrão para personalizar o comportamento do opencode para seu fluxo de trabalho.
|
||||
|
||||
```yaml title=".github/workflows/opencode.yml"
|
||||
- uses: anomalyco/opencode/github@latest
|
||||
@@ -271,7 +271,7 @@ Isso é útil para impor critérios de revisão específicos, padrões de codifi
|
||||
|
||||
## Exemplos
|
||||
|
||||
Aqui estão alguns exemplos de como você pode usar o OpenCode no GitHub.
|
||||
Aqui estão alguns exemplos de como você pode usar o opencode no GitHub.
|
||||
|
||||
- **Explicar um problema**
|
||||
|
||||
@@ -281,7 +281,7 @@ Aqui estão alguns exemplos de como você pode usar o OpenCode no GitHub.
|
||||
/opencode explain this issue
|
||||
```
|
||||
|
||||
O OpenCode lerá toda a conversa, incluindo todos os comentários, e responderá com uma explicação clara.
|
||||
O opencode lerá toda a conversa, incluindo todos os comentários, e responderá com uma explicação clara.
|
||||
|
||||
- **Corrigir um problema**
|
||||
|
||||
@@ -291,7 +291,7 @@ Aqui estão alguns exemplos de como você pode usar o OpenCode no GitHub.
|
||||
/opencode fix this
|
||||
```
|
||||
|
||||
E o OpenCode criará um novo branch, implementará as alterações e abrirá um PR com as mudanças.
|
||||
E o opencode criará um novo branch, implementará as alterações e abrirá um PR com as mudanças.
|
||||
|
||||
- **Revisar PRs e fazer alterações**
|
||||
|
||||
@@ -301,18 +301,18 @@ Aqui estão alguns exemplos de como você pode usar o OpenCode no GitHub.
|
||||
Delete the attachment from S3 when the note is removed /oc
|
||||
```
|
||||
|
||||
O OpenCode implementará a alteração solicitada e a confirmará no mesmo PR.
|
||||
O opencode implementará a alteração solicitada e a confirmará no mesmo PR.
|
||||
|
||||
- **Revisar linhas de código específicas**
|
||||
|
||||
Deixe um comentário diretamente nas linhas de código na aba "Files" do PR. O OpenCode detecta automaticamente o arquivo, os números das linhas e o contexto do diff para fornecer respostas precisas.
|
||||
Deixe um comentário diretamente nas linhas de código na aba "Files" do PR. O opencode detecta automaticamente o arquivo, os números das linhas e o contexto do diff para fornecer respostas precisas.
|
||||
|
||||
```
|
||||
[Comentário sobre linhas específicas na aba Files]
|
||||
/oc add error handling here
|
||||
```
|
||||
|
||||
Ao comentar sobre linhas específicas, o OpenCode recebe:
|
||||
Ao comentar sobre linhas específicas, o opencode recebe:
|
||||
- O arquivo exato sendo revisado
|
||||
- As linhas específicas de código
|
||||
- O contexto do diff ao redor
|
||||
|
||||
@@ -1,33 +1,33 @@
|
||||
---
|
||||
title: GitLab
|
||||
description: Use OpenCode em problemas e solicitações de mesclagem do GitLab.
|
||||
description: Use opencode em problemas e solicitações de mesclagem do GitLab.
|
||||
---
|
||||
|
||||
OpenCode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo.
|
||||
opencode se integra ao seu fluxo de trabalho do GitLab através do seu pipeline CI/CD do GitLab ou com o GitLab Duo.
|
||||
|
||||
Em ambos os casos, o OpenCode será executado em seus runners do GitLab.
|
||||
Em ambos os casos, o opencode será executado em seus runners do GitLab.
|
||||
|
||||
---
|
||||
|
||||
## GitLab CI
|
||||
|
||||
OpenCode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um [componente CI](https://docs.gitlab.com/ee/ci/components/)
|
||||
opencode funciona em um pipeline regular do GitLab. Você pode integrá-lo a um pipeline como um [componente CI](https://docs.gitlab.com/ee/ci/components/)
|
||||
|
||||
Aqui estamos usando um componente CI/CD criado pela comunidade para OpenCode — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode).
|
||||
Aqui estamos usando um componente CI/CD criado pela comunidade para opencode — [nagyv/gitlab-opencode](https://gitlab.com/nagyv/gitlab-opencode).
|
||||
|
||||
---
|
||||
|
||||
### Recursos
|
||||
|
||||
- **Use configuração personalizada por trabalho**: Configure o OpenCode com um diretório de configuração personalizado, por exemplo `./config/#custom-directory` para habilitar ou desabilitar funcionalidades por invocação do OpenCode.
|
||||
- **Configuração mínima**: O componente CI configura o OpenCode em segundo plano, você só precisa criar a configuração do OpenCode e o prompt inicial.
|
||||
- **Use configuração personalizada por trabalho**: Configure o opencode com um diretório de configuração personalizado, por exemplo `./config/#custom-directory` para habilitar ou desabilitar funcionalidades por invocação do opencode.
|
||||
- **Configuração mínima**: O componente CI configura o opencode em segundo plano, você só precisa criar a configuração do opencode e o prompt inicial.
|
||||
- **Flexível**: O componente CI suporta várias entradas para personalizar seu comportamento.
|
||||
|
||||
---
|
||||
|
||||
### Configuração
|
||||
|
||||
1. Armazene seu JSON de autenticação do OpenCode como variáveis de ambiente do tipo File em **Configurações** > **CI/CD** > **Variáveis**. Certifique-se de marcá-las como "Mascaradas e ocultas".
|
||||
1. Armazene seu JSON de autenticação do opencode como variáveis de ambiente do tipo File em **Configurações** > **CI/CD** > **Variáveis**. Certifique-se de marcá-las como "Mascaradas e ocultas".
|
||||
2. Adicione o seguinte ao seu arquivo `.gitlab-ci.yml`.
|
||||
|
||||
```yaml title=".gitlab-ci.yml"
|
||||
@@ -35,7 +35,7 @@ Aqui estamos usando um componente CI/CD criado pela comunidade para OpenCode —
|
||||
- component: $CI_SERVER_FQDN/nagyv/gitlab-opencode/opencode@2
|
||||
inputs:
|
||||
config_dir: ${CI_PROJECT_DIR}/opencode-config
|
||||
auth_json: $OPENCODE_AUTH_JSON # O nome da variável para seu JSON de autenticação do OpenCode
|
||||
auth_json: $OPENCODE_AUTH_JSON # O nome da variável para seu JSON de autenticação do opencode
|
||||
command: optional-custom-command
|
||||
message: "Seu prompt aqui"
|
||||
```
|
||||
@@ -46,23 +46,23 @@ Para mais entradas e casos de uso [consulte a documentação](https://gitlab.com
|
||||
|
||||
## GitLab Duo
|
||||
|
||||
OpenCode se integra ao seu fluxo de trabalho do GitLab.
|
||||
Mencione `@opencode` em um comentário, e o OpenCode executará tarefas dentro do seu pipeline CI do GitLab.
|
||||
opencode se integra ao seu fluxo de trabalho do GitLab.
|
||||
Mencione `@opencode` em um comentário, e o opencode executará tarefas dentro do seu pipeline CI do GitLab.
|
||||
|
||||
---
|
||||
|
||||
### Recursos
|
||||
|
||||
- **Triagem de problemas**: Peça ao OpenCode para analisar um problema e explicá-lo para você.
|
||||
- **Corrigir e implementar**: Peça ao OpenCode para corrigir um problema ou implementar uma funcionalidade.
|
||||
- **Triagem de problemas**: Peça ao opencode para analisar um problema e explicá-lo para você.
|
||||
- **Corrigir e implementar**: Peça ao opencode para corrigir um problema ou implementar uma funcionalidade.
|
||||
Ele criará um novo branch e abrirá uma solicitação de mesclagem com as alterações.
|
||||
- **Seguro**: O OpenCode é executado em seus runners do GitLab.
|
||||
- **Seguro**: O opencode é executado em seus runners do GitLab.
|
||||
|
||||
---
|
||||
|
||||
### Configuração
|
||||
|
||||
O OpenCode é executado em seu pipeline CI/CD do GitLab, aqui está o que você precisará para configurá-lo:
|
||||
O opencode é executado em seu pipeline CI/CD do GitLab, aqui está o que você precisará para configurá-lo:
|
||||
|
||||
:::tip
|
||||
Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent_platform/agent_assistant/) para instruções atualizadas.
|
||||
@@ -91,7 +91,7 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent
|
||||
- apt-get install --yes glab
|
||||
- echo "Configurando glab"
|
||||
- echo $GITLAB_HOST
|
||||
- echo "Criando configuração de autenticação do OpenCode"
|
||||
- echo "Criando configuração de autenticação do opencode"
|
||||
- mkdir --parents ~/.local/share/opencode
|
||||
- |
|
||||
cat > ~/.local/share/opencode/auth.json << EOF
|
||||
@@ -104,10 +104,10 @@ Consulte a [**documentação do GitLab**](https://docs.gitlab.com/user/duo_agent
|
||||
EOF
|
||||
- echo "Configurando git"
|
||||
- git config --global user.email "opencode@gitlab.com"
|
||||
- git config --global user.name "OpenCode"
|
||||
- git config --global user.name "opencode"
|
||||
- echo "Testando glab"
|
||||
- glab issue list
|
||||
- echo "Executando OpenCode"
|
||||
- echo "Executando opencode"
|
||||
- |
|
||||
opencode run "
|
||||
Você é um assistente de IA ajudando com operações do GitLab.
|
||||
@@ -158,7 +158,7 @@ Você pode consultar a [documentação dos agentes da CLI do GitLab](https://doc
|
||||
|
||||
### Exemplos
|
||||
|
||||
Aqui estão alguns exemplos de como você pode usar o OpenCode no GitLab.
|
||||
Aqui estão alguns exemplos de como você pode usar o opencode no GitLab.
|
||||
|
||||
:::tip
|
||||
Você pode configurar para usar uma frase de gatilho diferente de `@opencode`.
|
||||
@@ -172,7 +172,7 @@ Você pode configurar para usar uma frase de gatilho diferente de `@opencode`.
|
||||
@opencode explain this issue
|
||||
```
|
||||
|
||||
O OpenCode lerá o problema e responderá com uma explicação clara.
|
||||
O opencode lerá o problema e responderá com uma explicação clara.
|
||||
|
||||
- **Corrigir um problema**
|
||||
|
||||
@@ -182,7 +182,7 @@ Você pode configurar para usar uma frase de gatilho diferente de `@opencode`.
|
||||
@opencode fix this
|
||||
```
|
||||
|
||||
O OpenCode criará um novo branch, implementará as alterações e abrirá uma solicitação de mesclagem com as alterações.
|
||||
O opencode criará um novo branch, implementará as alterações e abrirá uma solicitação de mesclagem com as alterações.
|
||||
|
||||
- **Revisar solicitações de mesclagem**
|
||||
|
||||
@@ -192,4 +192,4 @@ Você pode configurar para usar uma frase de gatilho diferente de `@opencode`.
|
||||
@opencode review this merge request
|
||||
```
|
||||
|
||||
O OpenCode revisará a solicitação de mesclagem e fornecerá feedback.
|
||||
O opencode revisará a solicitação de mesclagem e fornecerá feedback.
|
||||
|
||||
@@ -1,24 +1,24 @@
|
||||
---
|
||||
title: IDE
|
||||
description: A extensão OpenCode para VS Code, Cursor e outras IDEs
|
||||
description: A extensão opencode para VS Code, Cursor e outras IDEs
|
||||
---
|
||||
|
||||
OpenCode integra-se com VS Code, Cursor ou qualquer IDE que suporte um terminal. Basta executar `opencode` no terminal para começar.
|
||||
opencode integra-se com VS Code, Cursor ou qualquer IDE que suporte um terminal. Basta executar `opencode` no terminal para começar.
|
||||
|
||||
---
|
||||
|
||||
## Uso
|
||||
|
||||
- **Lançamento Rápido**: Use `Cmd+Esc` (Mac) ou `Ctrl+Esc` (Windows/Linux) para abrir o OpenCode em uma visualização de terminal dividido, ou focar em uma sessão de terminal existente se uma já estiver em execução.
|
||||
- **Nova Sessão**: Use `Cmd+Shift+Esc` (Mac) ou `Ctrl+Shift+Esc` (Windows/Linux) para iniciar uma nova sessão de terminal OpenCode, mesmo que uma já esteja aberta. Você também pode clicar no botão OpenCode na interface.
|
||||
- **Consciência de Contexto**: Compartilhe automaticamente sua seleção ou aba atual com o OpenCode.
|
||||
- **Lançamento Rápido**: Use `Cmd+Esc` (Mac) ou `Ctrl+Esc` (Windows/Linux) para abrir o opencode em uma visualização de terminal dividido, ou focar em uma sessão de terminal existente se uma já estiver em execução.
|
||||
- **Nova Sessão**: Use `Cmd+Shift+Esc` (Mac) ou `Ctrl+Shift+Esc` (Windows/Linux) para iniciar uma nova sessão de terminal opencode, mesmo que uma já esteja aberta. Você também pode clicar no botão opencode na interface.
|
||||
- **Consciência de Contexto**: Compartilhe automaticamente sua seleção ou aba atual com o opencode.
|
||||
- **Atalhos de Referência de Arquivo**: Use `Cmd+Option+K` (Mac) ou `Alt+Ctrl+K` (Linux/Windows) para inserir referências de arquivo. Por exemplo, `@File#L37-42`.
|
||||
|
||||
---
|
||||
|
||||
## Instalação
|
||||
|
||||
Para instalar o OpenCode no VS Code e forks populares como Cursor, Windsurf, VSCodium:
|
||||
Para instalar o opencode no VS Code e forks populares como Cursor, Windsurf, VSCodium:
|
||||
|
||||
1. Abra o VS Code
|
||||
2. Abra o terminal integrado
|
||||
@@ -30,7 +30,7 @@ Se, por outro lado, você quiser usar sua própria IDE ao executar `/editor` ou
|
||||
|
||||
### Instalação Manual
|
||||
|
||||
Procure por **OpenCode** no Marketplace de Extensões e clique em **Instalar**.
|
||||
Procure por **opencode** no Marketplace de Extensões e clique em **Instalar**.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: Introdução
|
||||
description: Comece com o OpenCode.
|
||||
description: Comece com o opencode.
|
||||
---
|
||||
|
||||
import { Tabs, TabItem } from "@astrojs/starlight/components"
|
||||
import config from "../../../../config.mjs"
|
||||
export const console = config.console
|
||||
|
||||
[**OpenCode**](/) é um agente de codificação AI de código aberto. Está disponível como uma interface baseada em terminal, aplicativo desktop ou extensão de IDE.
|
||||
[**opencode**](/) é um agente de codificação AI de código aberto. Está disponível como uma interface baseada em terminal, aplicativo desktop ou extensão de IDE.
|
||||
|
||||

|
||||

|
||||
|
||||
Vamos começar.
|
||||
|
||||
@@ -17,7 +17,7 @@ Vamos começar.
|
||||
|
||||
#### Pré-requisitos
|
||||
|
||||
Para usar o OpenCode no seu terminal, você precisará de:
|
||||
Para usar o opencode no seu terminal, você precisará de:
|
||||
|
||||
1. Um emulador de terminal moderno como:
|
||||
- [WezTerm](https://wezterm.org), multiplataforma
|
||||
@@ -31,7 +31,7 @@ Para usar o OpenCode no seu terminal, você precisará de:
|
||||
|
||||
## Instalar
|
||||
|
||||
A maneira mais fácil de instalar o OpenCode é através do script de instalação.
|
||||
A maneira mais fácil de instalar o opencode é através do script de instalação.
|
||||
|
||||
```bash
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
@@ -79,7 +79,7 @@ Você também pode instalá-lo com os seguintes comandos:
|
||||
brew install anomalyco/tap/opencode
|
||||
```
|
||||
|
||||
> Recomendamos usar o tap do OpenCode para as versões mais atualizadas. A fórmula oficial `brew install opencode` é mantida pela equipe do Homebrew e é atualizada com menos frequência.
|
||||
> Recomendamos usar o tap do opencode para as versões mais atualizadas. A fórmula oficial `brew install opencode` é mantida pela equipe do Homebrew e é atualizada com menos frequência.
|
||||
|
||||
- **Usando Paru no Arch Linux**
|
||||
|
||||
@@ -90,7 +90,7 @@ Você também pode instalá-lo com os seguintes comandos:
|
||||
#### Windows
|
||||
|
||||
:::tip[Recomendado: Use WSL]
|
||||
Para a melhor experiência no Windows, recomendamos usar o [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). Ele oferece melhor desempenho e total compatibilidade com os recursos do OpenCode.
|
||||
Para a melhor experiência no Windows, recomendamos usar o [Windows Subsystem for Linux (WSL)](/docs/windows-wsl). Ele oferece melhor desempenho e total compatibilidade com os recursos do opencode.
|
||||
:::
|
||||
|
||||
- **Usando Chocolatey**
|
||||
@@ -123,7 +123,7 @@ Para a melhor experiência no Windows, recomendamos usar o [Windows Subsystem fo
|
||||
docker run -it --rm ghcr.io/anomalyco/opencode
|
||||
```
|
||||
|
||||
O suporte para instalar o OpenCode no Windows usando Bun está atualmente em andamento.
|
||||
O suporte para instalar o opencode no Windows usando Bun está atualmente em andamento.
|
||||
|
||||
Você também pode baixar o binário na seção [Releases](https://github.com/anomalyco/opencode/releases).
|
||||
|
||||
@@ -131,10 +131,10 @@ Você também pode baixar o binário na seção [Releases](https://github.com/an
|
||||
|
||||
## Configurar
|
||||
|
||||
Com o OpenCode, você pode usar qualquer provedor de LLM configurando suas chaves de API.
|
||||
Com o opencode, você pode usar qualquer provedor de LLM configurando suas chaves de API.
|
||||
|
||||
Se você é novo no uso de provedores de LLM, recomendamos usar o [OpenCode Zen](/docs/zen).
|
||||
É uma lista selecionada de modelos que foram testados e verificados pela equipe do OpenCode.
|
||||
É uma lista selecionada de modelos que foram testados e verificados pela equipe do opencode.
|
||||
|
||||
1. Execute o comando `/connect` no TUI, selecione opencode e acesse [opencode.ai/auth](https://opencode.ai/auth).
|
||||
|
||||
@@ -165,31 +165,31 @@ Agora que você configurou um provedor, pode navegar até um projeto no qual des
|
||||
cd /caminho/para/projeto
|
||||
```
|
||||
|
||||
E execute o OpenCode.
|
||||
E execute o opencode.
|
||||
|
||||
```bash
|
||||
opencode
|
||||
```
|
||||
|
||||
Em seguida, inicialize o OpenCode para o projeto executando o seguinte comando.
|
||||
Em seguida, inicialize o opencode para o projeto executando o seguinte comando.
|
||||
|
||||
```bash frame="none"
|
||||
/init
|
||||
```
|
||||
|
||||
Isso fará com que o OpenCode analise seu projeto e crie um arquivo `AGENTS.md` na raiz do projeto.
|
||||
Isso fará com que o opencode analise seu projeto e crie um arquivo `AGENTS.md` na raiz do projeto.
|
||||
|
||||
:::tip
|
||||
Você deve commitar o arquivo `AGENTS.md` do seu projeto no Git.
|
||||
:::
|
||||
|
||||
Isso ajuda o OpenCode a entender a estrutura do projeto e os padrões de codificação utilizados.
|
||||
Isso ajuda o opencode a entender a estrutura do projeto e os padrões de codificação utilizados.
|
||||
|
||||
---
|
||||
|
||||
## Uso
|
||||
|
||||
Agora você está pronto para usar o OpenCode para trabalhar em seu projeto. Sinta-se à vontade para perguntar qualquer coisa!
|
||||
Agora você está pronto para usar o opencode para trabalhar em seu projeto. Sinta-se à vontade para perguntar qualquer coisa!
|
||||
|
||||
Se você é novo no uso de um agente de codificação AI, aqui estão alguns exemplos que podem ajudar.
|
||||
|
||||
@@ -197,7 +197,7 @@ Se você é novo no uso de um agente de codificação AI, aqui estão alguns exe
|
||||
|
||||
### Fazer perguntas
|
||||
|
||||
Você pode pedir ao OpenCode para explicar a base de código para você.
|
||||
Você pode pedir ao opencode para explicar a base de código para você.
|
||||
|
||||
:::tip
|
||||
Use a tecla `@` para buscar arquivos no projeto.
|
||||
@@ -213,11 +213,11 @@ Isso é útil se houver uma parte da base de código na qual você não trabalho
|
||||
|
||||
### Adicionar recursos
|
||||
|
||||
Você pode pedir ao OpenCode para adicionar novos recursos ao seu projeto. Embora primeiro recomendemos pedir para ele criar um plano.
|
||||
Você pode pedir ao opencode para adicionar novos recursos ao seu projeto. Embora primeiro recomendemos pedir para ele criar um plano.
|
||||
|
||||
1. **Criar um plano**
|
||||
|
||||
O OpenCode tem um _Modo de Plano_ que desabilita sua capacidade de fazer alterações e, em vez disso, sugere _como_ implementará o recurso.
|
||||
O opencode tem um _Modo de Plano_ que desabilita sua capacidade de fazer alterações e, em vez disso, sugere _como_ implementará o recurso.
|
||||
|
||||
Mude para ele usando a tecla **Tab**. Você verá um indicador para isso no canto inferior direito.
|
||||
|
||||
@@ -233,10 +233,10 @@ Você pode pedir ao OpenCode para adicionar novos recursos ao seu projeto. Embor
|
||||
A partir dessa tela, o usuário pode restaurar uma nota ou excluí-la permanentemente.
|
||||
```
|
||||
|
||||
Você quer dar ao OpenCode detalhes suficientes para entender o que você deseja. Ajuda conversar com ele como se você estivesse falando com um desenvolvedor júnior da sua equipe.
|
||||
Você quer dar ao opencode detalhes suficientes para entender o que você deseja. Ajuda conversar com ele como se você estivesse falando com um desenvolvedor júnior da sua equipe.
|
||||
|
||||
:::tip
|
||||
Dê ao OpenCode bastante contexto e exemplos para ajudá-lo a entender o que você deseja.
|
||||
Dê ao opencode bastante contexto e exemplos para ajudá-lo a entender o que você deseja.
|
||||
:::
|
||||
|
||||
2. **Iterar sobre o plano**
|
||||
@@ -252,7 +252,7 @@ Você pode pedir ao OpenCode para adicionar novos recursos ao seu projeto. Embor
|
||||
Arraste e solte imagens no terminal para adicioná-las ao prompt.
|
||||
:::
|
||||
|
||||
O OpenCode pode escanear qualquer imagem que você fornecer e adicioná-la ao prompt. Você pode fazer isso arrastando e soltando uma imagem no terminal.
|
||||
O opencode pode escanear qualquer imagem que você fornecer e adicioná-la ao prompt. Você pode fazer isso arrastando e soltando uma imagem no terminal.
|
||||
|
||||
3. **Construir o recurso**
|
||||
|
||||
@@ -272,19 +272,19 @@ Você pode pedir ao OpenCode para adicionar novos recursos ao seu projeto. Embor
|
||||
|
||||
### Fazer alterações
|
||||
|
||||
Para alterações mais simples, você pode pedir ao OpenCode para construí-las diretamente sem precisar revisar o plano primeiro.
|
||||
Para alterações mais simples, você pode pedir ao opencode para construí-las diretamente sem precisar revisar o plano primeiro.
|
||||
|
||||
```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
|
||||
Precisamos adicionar autenticação à rota /settings. Dê uma olhada em como isso é tratado na rota /notes em @packages/functions/src/notes.ts e implemente a mesma lógica em @packages/functions/src/settings.ts
|
||||
```
|
||||
|
||||
Você quer ter certeza de fornecer uma boa quantidade de detalhes para que o OpenCode faça as alterações corretas.
|
||||
Você quer ter certeza de fornecer uma boa quantidade de detalhes para que o opencode faça as alterações corretas.
|
||||
|
||||
---
|
||||
|
||||
### Desfazer alterações
|
||||
|
||||
Vamos supor que você peça ao OpenCode para fazer algumas alterações.
|
||||
Vamos supor que você peça ao opencode para fazer algumas alterações.
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
Você pode refatorar a função em @packages/functions/src/api/index.ts?
|
||||
@@ -296,13 +296,13 @@ Mas você percebe que não era isso que você queria. Você **pode desfazer** as
|
||||
/undo
|
||||
```
|
||||
|
||||
O OpenCode agora reverterá as alterações que você fez e mostrará sua mensagem original novamente.
|
||||
O opencode agora reverterá as alterações que você fez e mostrará sua mensagem original novamente.
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
Você pode refatorar a função em @packages/functions/src/api/index.ts?
|
||||
```
|
||||
|
||||
A partir daqui, você pode ajustar o prompt e pedir ao OpenCode para tentar novamente.
|
||||
A partir daqui, você pode ajustar o prompt e pedir ao opencode para tentar novamente.
|
||||
|
||||
:::tip
|
||||
Você pode executar `/undo` várias vezes para desfazer várias alterações.
|
||||
@@ -318,7 +318,7 @@ Ou você **pode refazer** as alterações usando o comando `/redo`.
|
||||
|
||||
## Compartilhar
|
||||
|
||||
As conversas que você tem com o OpenCode podem ser [compartilhadas com sua equipe](/docs/share).
|
||||
As conversas que você tem com o opencode podem ser [compartilhadas com sua equipe](/docs/share).
|
||||
|
||||
```bash frame="none"
|
||||
/share
|
||||
@@ -330,12 +330,12 @@ Isso criará um link para a conversa atual e o copiará para sua área de transf
|
||||
As conversas não são compartilhadas por padrão.
|
||||
:::
|
||||
|
||||
Aqui está uma [conversa de exemplo](https://opencode.ai/s/4XP1fce5) com o OpenCode.
|
||||
Aqui está uma [conversa de exemplo](https://opencode.ai/s/4XP1fce5) com o opencode.
|
||||
|
||||
---
|
||||
|
||||
## Personalizar
|
||||
|
||||
E é isso! Agora você é um profissional em usar o OpenCode.
|
||||
E é isso! Agora você é um profissional em usar o opencode.
|
||||
|
||||
Para torná-lo seu, recomendamos [escolher um tema](/docs/themes), [personalizar os atalhos de teclado](/docs/keybinds), [configurar formatadores de código](/docs/formatters), [criar comandos personalizados](/docs/commands) ou brincar com a [configuração do OpenCode](/docs/config).
|
||||
Para torná-lo seu, recomendamos [escolher um tema](/docs/themes), [personalizar os atalhos de teclado](/docs/keybinds), [configurar formatadores de código](/docs/formatters), [criar comandos personalizados](/docs/commands) ou brincar com a [configuração do opencode](/docs/config).
|
||||
|
||||
@@ -3,7 +3,7 @@ title: Atalhos de Teclado
|
||||
description: Personalize seus atalhos de teclado.
|
||||
---
|
||||
|
||||
OpenCode tem uma lista de atalhos de teclado que você pode personalizar através da configuração do OpenCode.
|
||||
opencode tem uma lista de atalhos de teclado que você pode personalizar através da configuração do opencode.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
@@ -107,7 +107,7 @@ OpenCode tem uma lista de atalhos de teclado que você pode personalizar atravé
|
||||
|
||||
## Tecla líder
|
||||
|
||||
OpenCode usa uma tecla `leader` para a maioria dos atalhos de teclado. Isso evita conflitos no seu terminal.
|
||||
opencode usa uma tecla `leader` para a maioria dos atalhos de teclado. Isso evita conflitos no seu terminal.
|
||||
|
||||
Por padrão, `ctrl+x` é a tecla líder e a maioria das ações requer que você primeiro pressione a tecla líder e depois o atalho. Por exemplo, para iniciar uma nova sessão, você primeiro pressiona `ctrl+x` e depois pressiona `n`.
|
||||
|
||||
@@ -132,7 +132,7 @@ Você pode desativar um atalho adicionando a tecla à sua configuração com um
|
||||
|
||||
## Atalhos do prompt do desktop
|
||||
|
||||
O prompt de entrada do aplicativo desktop OpenCode suporta atalhos comuns de estilo Readline/Emacs para edição de texto. Estes são embutidos e atualmente não são configuráveis via `opencode.json`.
|
||||
O prompt de entrada do aplicativo desktop opencode suporta atalhos comuns de estilo Readline/Emacs para edição de texto. Estes são embutidos e atualmente não são configuráveis via `opencode.json`.
|
||||
|
||||
| Atalho | Ação |
|
||||
| -------- | ------------------------------------------------ |
|
||||
|
||||
@@ -1,15 +1,15 @@
|
||||
---
|
||||
title: Servidores LSP
|
||||
description: OpenCode integra-se aos seus servidores LSP.
|
||||
description: opencode integra-se aos seus servidores LSP.
|
||||
---
|
||||
|
||||
OpenCode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.
|
||||
opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.
|
||||
|
||||
---
|
||||
|
||||
## Integrado
|
||||
|
||||
OpenCode vem com vários servidores LSP integrados para linguagens populares:
|
||||
opencode vem com vários servidores LSP integrados para linguagens populares:
|
||||
|
||||
| Servidor LSP | Extensões | Requisitos |
|
||||
| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------ |
|
||||
@@ -26,7 +26,7 @@ OpenCode vem com vários servidores LSP integrados para linguagens populares:
|
||||
| gleam | .gleam | Comando `gleam` disponível |
|
||||
| gopls | .go | Comando `go` disponível |
|
||||
| hls | .hs, .lhs | Comando `haskell-language-server-wrapper` disponível |
|
||||
| jdtls | .java | `Java SDK (versão 21+)` instalado |
|
||||
| jdtls | .java | `Java SDK (version 21+)` instalado |
|
||||
| kotlin-ls | .kt, .kts | Instala automaticamente para projetos Kotlin |
|
||||
| lua-ls | .lua | Instala automaticamente para projetos Lua |
|
||||
| nixd | .nix | Comando `nixd` disponível |
|
||||
|
||||
@@ -3,7 +3,7 @@ title: Servidores MCP
|
||||
description: Adicione ferramentas MCP locais e remotas.
|
||||
---
|
||||
|
||||
Você pode adicionar ferramentas externas ao OpenCode usando o _Modelo de Contexto de Protocolo_, ou MCP. O OpenCode suporta servidores locais e remotos.
|
||||
Você pode adicionar ferramentas externas ao opencode usando o _Modelo de Contexto de Protocolo_, ou MCP. O opencode suporta servidores locais e remotos.
|
||||
|
||||
Uma vez adicionadas, as ferramentas MCP estão automaticamente disponíveis para o LLM juntamente com as ferramentas integradas.
|
||||
|
||||
@@ -23,17 +23,17 @@ Certos servidores MCP, como o servidor MCP do GitHub, tendem a adicionar muitos
|
||||
|
||||
## Habilitar
|
||||
|
||||
Você pode definir servidores MCP em sua [Configuração do OpenCode](https://opencode.ai/docs/config/) sob `mcp`. Adicione cada MCP com um nome único. Você pode se referir a esse MCP pelo nome ao solicitar ao LLM.
|
||||
Você pode definir servidores MCP em sua [Configuração do opencode](https://opencode.ai/docs/config/) sob `mcp`. Adicione cada MCP com um nome único. Você pode se referir a esse MCP pelo nome ao solicitar ao LLM.
|
||||
|
||||
```jsonc title="opencode.jsonc" {6}
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"nome-do-servidor-mcp": {
|
||||
"mcp-server-name": {
|
||||
// ...
|
||||
"enabled": true,
|
||||
},
|
||||
"nome-do-outro-servidor-mcp": {
|
||||
"another-mcp-server-name": {
|
||||
// ...
|
||||
},
|
||||
},
|
||||
@@ -75,13 +75,13 @@ Adicione servidores MCP locais usando `type` como `"local"` dentro do objeto MCP
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-servidor-mcp-local": {
|
||||
"my-local-mcp-server": {
|
||||
"type": "local",
|
||||
// Ou ["bun", "x", "meu-comando-mcp"]
|
||||
"command": ["npx", "-y", "meu-comando-mcp"],
|
||||
// Ou ["bun", "x", "my-mcp-command"]
|
||||
"command": ["npx", "-y", "my-mcp-command"],
|
||||
"enabled": true,
|
||||
"environment": {
|
||||
"MINHA_VAR_DE_ENV": "valor_da_var_de_env",
|
||||
"MY_ENV_VAR": "env_var_value",
|
||||
},
|
||||
},
|
||||
},
|
||||
@@ -96,7 +96,7 @@ Por exemplo, aqui está como você pode adicionar o servidor MCP de teste [`@mod
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"mcp_tudo": {
|
||||
"mcp_everything": {
|
||||
"type": "local",
|
||||
"command": ["npx", "-y", "@modelcontextprotocol/server-everything"],
|
||||
},
|
||||
@@ -104,10 +104,10 @@ Por exemplo, aqui está como você pode adicionar o servidor MCP de teste [`@mod
|
||||
}
|
||||
```
|
||||
|
||||
E para usá-lo, posso adicionar `use the mcp_tudo tool` aos meus prompts.
|
||||
E para usá-lo, posso adicionar `use the mcp_everything tool` aos meus prompts.
|
||||
|
||||
```txt "mcp_tudo"
|
||||
use the mcp_tudo tool to add the number 3 and 4
|
||||
```txt "mcp_everything"
|
||||
use the mcp_everything tool to add the number 3 and 4
|
||||
```
|
||||
|
||||
---
|
||||
@@ -134,12 +134,12 @@ Adicione servidores MCP remotos definindo `type` como `"remote"`.
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-mcp-remoto": {
|
||||
"my-remote-mcp": {
|
||||
"type": "remote",
|
||||
"url": "https://meu-servidor-mcp.com",
|
||||
"url": "https://my-mcp-server.com",
|
||||
"enabled": true,
|
||||
"headers": {
|
||||
"Authorization": "Bearer MINHA_CHAVE_API"
|
||||
"Authorization": "Bearer MY_API_KEY"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -165,7 +165,7 @@ O `url` é a URL do servidor MCP remoto e com a opção `headers` você pode pas
|
||||
|
||||
## OAuth
|
||||
|
||||
O OpenCode lida automaticamente com a autenticação OAuth para servidores MCP remotos. Quando um servidor requer autenticação, o OpenCode irá:
|
||||
O opencode lida automaticamente com a autenticação OAuth para servidores MCP remotos. Quando um servidor requer autenticação, o opencode irá:
|
||||
|
||||
1. Detectar a resposta 401 e iniciar o fluxo OAuth
|
||||
2. Usar **Registro Dinâmico de Cliente (RFC 7591)** se suportado pelo servidor
|
||||
@@ -181,7 +181,7 @@ Para a maioria dos servidores MCP habilitados para OAuth, nenhuma configuração
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-servidor-oauth": {
|
||||
"my-oauth-server": {
|
||||
"type": "remote",
|
||||
"url": "https://mcp.exemplo.com/mcp"
|
||||
}
|
||||
@@ -189,7 +189,7 @@ Para a maioria dos servidores MCP habilitados para OAuth, nenhuma configuração
|
||||
}
|
||||
```
|
||||
|
||||
Se o servidor requer autenticação, o OpenCode solicitará que você se autentique quando tentar usá-lo pela primeira vez. Se não, você pode [iniciar manualmente o fluxo](#authenticating) com `opencode mcp auth <nome-do-servidor>`.
|
||||
Se o servidor requer autenticação, o opencode solicitará que você se autentique quando tentar usá-lo pela primeira vez. Se não, você pode [iniciar manualmente o fluxo](#authenticating) com `opencode mcp auth <server-name>`.
|
||||
|
||||
---
|
||||
|
||||
@@ -201,12 +201,12 @@ Se você tiver credenciais de cliente do provedor do servidor MCP, pode configur
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-servidor-oauth": {
|
||||
"my-oauth-server": {
|
||||
"type": "remote",
|
||||
"url": "https://mcp.exemplo.com/mcp",
|
||||
"oauth": {
|
||||
"clientId": "{env:MINHA_CHAVE_CLIENTE_MCP}",
|
||||
"clientSecret": "{env:MINHA_CHAVE_SECRETA_MCP}",
|
||||
"clientId": "{env:MY_MCP_CLIENT_KEY}",
|
||||
"clientSecret": "{env:MY_MCP_CLIENT_SECRET}",
|
||||
"scope": "tools:read tools:execute"
|
||||
}
|
||||
}
|
||||
@@ -223,7 +223,7 @@ Você pode iniciar manualmente a autenticação ou gerenciar credenciais.
|
||||
Autentique-se com um servidor MCP específico:
|
||||
|
||||
```bash
|
||||
opencode mcp auth meu-servidor-oauth
|
||||
opencode mcp auth my-oauth-server
|
||||
```
|
||||
|
||||
Liste todos os servidores MCP e seu status de autenticação:
|
||||
@@ -235,10 +235,10 @@ opencode mcp list
|
||||
Remova credenciais armazenadas:
|
||||
|
||||
```bash
|
||||
opencode mcp logout meu-servidor-oauth
|
||||
opencode mcp logout my-oauth-server
|
||||
```
|
||||
|
||||
O comando `mcp auth` abrirá seu navegador para autorização. Após você autorizar, o OpenCode armazenará os tokens de forma segura em `~/.local/share/opencode/mcp-auth.json`.
|
||||
O comando `mcp auth` abrirá seu navegador para autorização. Após você autorizar, o opencode armazenará os tokens de forma segura em `~/.local/share/opencode/mcp-auth.json`.
|
||||
|
||||
---
|
||||
|
||||
@@ -250,12 +250,12 @@ Se você quiser desabilitar o OAuth automático para um servidor (por exemplo, p
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-servidor-chave-api": {
|
||||
"my-api-key-server": {
|
||||
"type": "remote",
|
||||
"url": "https://mcp.exemplo.com/mcp",
|
||||
"oauth": false,
|
||||
"headers": {
|
||||
"Authorization": "Bearer {env:MINHA_CHAVE_API}"
|
||||
"Authorization": "Bearer {env:MY_API_KEY}"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -282,7 +282,7 @@ Se um servidor MCP remoto estiver falhando na autenticação, você pode diagnos
|
||||
opencode mcp auth list
|
||||
|
||||
# Depurar conexão e fluxo OAuth para um servidor específico
|
||||
opencode mcp debug meu-servidor-oauth
|
||||
opencode mcp debug my-oauth-server
|
||||
```
|
||||
|
||||
O comando `mcp debug` mostra o status de autenticação atual, testa a conectividade HTTP e tenta o fluxo de descoberta OAuth.
|
||||
@@ -291,7 +291,7 @@ O comando `mcp debug` mostra o status de autenticação atual, testa a conectivi
|
||||
|
||||
## Gerenciar
|
||||
|
||||
Seus MCPs estão disponíveis como ferramentas no OpenCode, juntamente com ferramentas integradas. Portanto, você pode gerenciá-los através da configuração do OpenCode como qualquer outra ferramenta.
|
||||
Seus MCPs estão disponíveis como ferramentas no opencode, juntamente com ferramentas integradas. Portanto, você pode gerenciá-los através da configuração do opencode como qualquer outra ferramenta.
|
||||
|
||||
---
|
||||
|
||||
@@ -303,17 +303,17 @@ Isso significa que você pode habilitá-los ou desabilitá-los globalmente.
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-mcp-foo": {
|
||||
"my-mcp-foo": {
|
||||
"type": "local",
|
||||
"command": ["bun", "x", "meu-comando-mcp-foo"]
|
||||
"command": ["bun", "x", "my-mcp-command-foo"]
|
||||
},
|
||||
"meu-mcp-bar": {
|
||||
"my-mcp-bar": {
|
||||
"type": "local",
|
||||
"command": ["bun", "x", "meu-comando-mcp-bar"]
|
||||
"command": ["bun", "x", "my-mcp-command-bar"]
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"meu-mcp-foo": false
|
||||
"my-mcp-foo": false
|
||||
}
|
||||
}
|
||||
```
|
||||
@@ -324,22 +324,22 @@ Também podemos usar um padrão glob para desabilitar todos os MCPs corresponden
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-mcp-foo": {
|
||||
"my-mcp-foo": {
|
||||
"type": "local",
|
||||
"command": ["bun", "x", "meu-comando-mcp-foo"]
|
||||
"command": ["bun", "x", "my-mcp-command-foo"]
|
||||
},
|
||||
"meu-mcp-bar": {
|
||||
"my-mcp-bar": {
|
||||
"type": "local",
|
||||
"command": ["bun", "x", "meu-comando-mcp-bar"]
|
||||
"command": ["bun", "x", "my-mcp-command-bar"]
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"meu-mcp*": false
|
||||
"my-mcp*": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Aqui estamos usando o padrão glob `meu-mcp*` para desabilitar todos os MCPs.
|
||||
Aqui estamos usando o padrão glob `my-mcp*` para desabilitar todos os MCPs.
|
||||
|
||||
---
|
||||
|
||||
@@ -354,19 +354,19 @@ Se você tiver um grande número de servidores MCP, pode querer habilitá-los ap
|
||||
{
|
||||
"$schema": "https://opencode.ai/config.json",
|
||||
"mcp": {
|
||||
"meu-mcp": {
|
||||
"my-mcp": {
|
||||
"type": "local",
|
||||
"command": ["bun", "x", "meu-comando-mcp"],
|
||||
"command": ["bun", "x", "my-mcp-command"],
|
||||
"enabled": true
|
||||
}
|
||||
},
|
||||
"tools": {
|
||||
"meu-mcp*": false
|
||||
"my-mcp*": false
|
||||
},
|
||||
"agent": {
|
||||
"meu-agente": {
|
||||
"my-agent": {
|
||||
"tools": {
|
||||
"meu-mcp*": true
|
||||
"my-mcp*": true
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -379,7 +379,7 @@ Se você tiver um grande número de servidores MCP, pode querer habilitá-los ap
|
||||
|
||||
O padrão glob usa padrões simples de regex globbing:
|
||||
|
||||
- `*` corresponde a zero ou mais de qualquer caractere (por exemplo, `"meu-mcp*"` corresponde a `meu-mcp_search`, `meu-mcp_list`, etc.)
|
||||
- `*` corresponde a zero ou mais de qualquer caractere (por exemplo, `"my-mcp*"` corresponde a `my-mcp_search`, `my-mcp_list`, etc.)
|
||||
- `?` corresponde exatamente a um caractere
|
||||
- Todos os outros caracteres correspondem literalmente
|
||||
|
||||
@@ -423,7 +423,7 @@ Após adicionar a configuração, autentique-se com o Sentry:
|
||||
opencode mcp auth sentry
|
||||
```
|
||||
|
||||
Isso abrirá uma janela do navegador para completar o fluxo OAuth e conectar o OpenCode à sua conta do Sentry.
|
||||
Isso abrirá uma janela do navegador para completar o fluxo OAuth e conectar o opencode à sua conta do Sentry.
|
||||
|
||||
Uma vez autenticado, você pode usar ferramentas do Sentry em seus prompts para consultar problemas, projetos e dados de erro.
|
||||
|
||||
|
||||
@@ -3,13 +3,13 @@ title: Modelos
|
||||
description: Configurando um provedor e modelo LLM.
|
||||
---
|
||||
|
||||
OpenCode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais.
|
||||
opencode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais.
|
||||
|
||||
---
|
||||
|
||||
## Provedores
|
||||
|
||||
Os provedores mais populares são pré-carregados por padrão. Se você adicionou as credenciais para um provedor através do comando `/connect`, elas estarão disponíveis quando você iniciar o OpenCode.
|
||||
Os provedores mais populares são pré-carregados por padrão. Se você adicionou as credenciais para um provedor através do comando `/connect`, elas estarão disponíveis quando você iniciar o opencode.
|
||||
|
||||
Saiba mais sobre [provedores](/docs/providers).
|
||||
|
||||
@@ -35,7 +35,7 @@ Considere usar um dos modelos que recomendamos.
|
||||
|
||||
No entanto, há apenas alguns deles que são bons tanto em gerar código quanto em chamar ferramentas.
|
||||
|
||||
Aqui estão vários modelos que funcionam bem com o OpenCode, em nenhuma ordem específica. (Esta não é uma lista exaustiva nem necessariamente atualizada):
|
||||
Aqui estão vários modelos que funcionam bem com o opencode, em nenhuma ordem específica. (Esta não é uma lista exaustiva nem necessariamente atualizada):
|
||||
|
||||
- GPT 5.2
|
||||
- GPT 5.1 Codex
|
||||
@@ -48,7 +48,7 @@ Aqui estão vários modelos que funcionam bem com o OpenCode, em nenhuma ordem e
|
||||
|
||||
## Defina um padrão
|
||||
|
||||
Para definir um desses como o modelo padrão, você pode definir a chave `model` na sua configuração do OpenCode.
|
||||
Para definir um desses como o modelo padrão, você pode definir a chave `model` na sua configuração do opencode.
|
||||
|
||||
```json title="opencode.json" {3}
|
||||
{
|
||||
@@ -136,11 +136,11 @@ Você também pode definir variantes personalizadas que estendem as integradas.
|
||||
|
||||
## Variantes
|
||||
|
||||
Muitos modelos suportam várias variantes com diferentes configurações. O OpenCode vem com variantes padrão integradas para provedores populares.
|
||||
Muitos modelos suportam várias variantes com diferentes configurações. O opencode vem com variantes padrão integradas para provedores populares.
|
||||
|
||||
### Variantes integradas
|
||||
|
||||
O OpenCode vem com variantes padrão para muitos provedores:
|
||||
O opencode vem com variantes padrão para muitos provedores:
|
||||
|
||||
**Anthropic**:
|
||||
|
||||
@@ -202,11 +202,11 @@ Use a tecla de atalho `variant_cycle` para alternar rapidamente entre variantes.
|
||||
|
||||
## Carregando modelos
|
||||
|
||||
Quando o OpenCode é iniciado, ele verifica modelos na seguinte ordem de prioridade:
|
||||
Quando o opencode é iniciado, ele verifica modelos na seguinte ordem de prioridade:
|
||||
|
||||
1. A flag de linha de comando `--model` ou `-m`. O formato é o mesmo que no arquivo de configuração: `provider_id/model_id`.
|
||||
|
||||
2. A lista de modelos na configuração do OpenCode.
|
||||
2. A lista de modelos na configuração do opencode.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
|
||||
@@ -3,13 +3,13 @@ title: Rede
|
||||
description: Configure proxies e certificados personalizados.
|
||||
---
|
||||
|
||||
OpenCode suporta variáveis de ambiente de proxy padrão e certificados personalizados para ambientes de rede corporativa.
|
||||
opencode suporta variáveis de ambiente de proxy padrão e certificados personalizados para ambientes de rede corporativa.
|
||||
|
||||
---
|
||||
|
||||
## Proxy
|
||||
|
||||
OpenCode respeita variáveis de ambiente de proxy padrão.
|
||||
opencode respeita variáveis de ambiente de proxy padrão.
|
||||
|
||||
```bash
|
||||
# Proxy HTTPS (recomendado)
|
||||
@@ -48,7 +48,7 @@ Para proxies que requerem autenticação avançada como NTLM ou Kerberos, consid
|
||||
|
||||
## Certificados personalizados
|
||||
|
||||
Se sua empresa usa CAs personalizadas para conexões HTTPS, configure o OpenCode para confiá-las.
|
||||
Se sua empresa usa CAs personalizadas para conexões HTTPS, configure o opencode para confiá-las.
|
||||
|
||||
```bash
|
||||
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
|
||||
|
||||
@@ -3,7 +3,7 @@ title: Permissões
|
||||
description: Controle quais ações requerem aprovação para serem executadas.
|
||||
---
|
||||
|
||||
OpenCode usa a configuração `permission` para decidir se uma determinada ação deve ser executada automaticamente, solicitar sua aprovação ou ser bloqueada.
|
||||
opencode usa a configuração `permission` para decidir se uma determinada ação deve ser executada automaticamente, solicitar sua aprovação ou ser bloqueada.
|
||||
|
||||
A partir da versão `v1.1.1`, a configuração booleana legada `tools` foi descontinuada e mesclada na `permission`. A antiga configuração `tools` ainda é suportada para compatibilidade retroativa.
|
||||
|
||||
@@ -88,7 +88,7 @@ Você pode usar `~` ou `$HOME` no início de um padrão para referenciar seu dir
|
||||
|
||||
### Diretórios Externos
|
||||
|
||||
Use `external_directory` para permitir chamadas de ferramentas que tocam em caminhos fora do diretório de trabalho onde o OpenCode foi iniciado. Isso se aplica a qualquer ferramenta que aceite um caminho como entrada (por exemplo, `read`, `edit`, `list`, `glob`, `grep` e muitos comandos `bash`).
|
||||
Use `external_directory` para permitir chamadas de ferramentas que tocam em caminhos fora do diretório de trabalho onde o opencode foi iniciado. Isso se aplica a qualquer ferramenta que aceite um caminho como entrada (por exemplo, `read`, `edit`, `list`, `glob`, `grep` e muitos comandos `bash`).
|
||||
|
||||
A expansão do home (como `~/...`) afeta apenas como um padrão é escrito. Não torna um caminho externo parte do espaço de trabalho atual, então caminhos fora do diretório de trabalho ainda devem ser permitidos via `external_directory`.
|
||||
|
||||
@@ -127,7 +127,7 @@ Mantenha a lista focada em caminhos confiáveis e adicione regras adicionais de
|
||||
|
||||
## Permissões Disponíveis
|
||||
|
||||
As permissões do OpenCode são indexadas pelo nome da ferramenta, além de alguns guardas de segurança:
|
||||
As permissões do opencode são indexadas pelo nome da ferramenta, além de alguns guardas de segurança:
|
||||
|
||||
- `read` — leitura de um arquivo (corresponde ao caminho do arquivo)
|
||||
- `edit` — todas as modificações de arquivo (cobre `edit`, `write`, `patch`, `multiedit`)
|
||||
@@ -148,7 +148,7 @@ As permissões do OpenCode são indexadas pelo nome da ferramenta, além de algu
|
||||
|
||||
## Padrões
|
||||
|
||||
Se você não especificar nada, o OpenCode começa com padrões permissivos:
|
||||
Se você não especificar nada, o opencode começa com padrões permissivos:
|
||||
|
||||
- A maioria das permissões padrão é `"allow"`.
|
||||
- `doom_loop` e `external_directory` padrão é `"ask"`.
|
||||
@@ -171,10 +171,10 @@ Se você não especificar nada, o OpenCode começa com padrões permissivos:
|
||||
|
||||
## O que “Ask” Faz
|
||||
|
||||
Quando o OpenCode solicita aprovação, a interface oferece três resultados:
|
||||
Quando o opencode solicita aprovação, a interface oferece três resultados:
|
||||
|
||||
- `once` — aprovar apenas esta solicitação
|
||||
- `always` — aprovar futuras solicitações que correspondam aos padrões sugeridos (para o restante da sessão atual do OpenCode)
|
||||
- `always` — aprovar futuras solicitações que correspondam aos padrões sugeridos (para o restante da sessão atual do opencode)
|
||||
- `reject` — negar a solicitação
|
||||
|
||||
O conjunto de padrões que `always` aprovaria é fornecido pela ferramenta (por exemplo, aprovações de bash normalmente incluem um prefixo de comando seguro como `git status*`).
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
title: Plugins
|
||||
description: Escreva seus próprios plugins para estender o OpenCode.
|
||||
description: Escreva seus próprios plugins para estender o opencode.
|
||||
---
|
||||
|
||||
Plugins permitem que você estenda o OpenCode conectando-se a vários eventos e personalizando o comportamento. Você pode criar plugins para adicionar novos recursos, integrar-se a serviços externos ou modificar o comportamento padrão do OpenCode.
|
||||
Plugins permitem que você estenda o opencode conectando-se a vários eventos e personalizando o comportamento. Você pode criar plugins para adicionar novos recursos, integrar-se a serviços externos ou modificar o comportamento padrão do opencode.
|
||||
|
||||
Para exemplos, confira os [plugins](/docs/ecosystem#plugins) criados pela comunidade.
|
||||
|
||||
@@ -82,7 +82,7 @@ Plugins locais e ferramentas personalizadas podem usar pacotes npm externos. Adi
|
||||
}
|
||||
```
|
||||
|
||||
O OpenCode executa `bun install` na inicialização para instalar esses pacotes. Seus plugins e ferramentas podem então importá-los.
|
||||
O opencode executa `bun install` na inicialização para instalar esses pacotes. Seus plugins e ferramentas podem então importá-los.
|
||||
|
||||
```ts title=".opencode/plugins/my-plugin.ts"
|
||||
import { escape } from "shescape"
|
||||
@@ -224,7 +224,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr
|
||||
event: async ({ event }) => {
|
||||
// Enviar notificação ao concluir a sessão
|
||||
if (event.type === "session.idle") {
|
||||
await $`osascript -e 'display notification "Sessão concluída!" with title "opencode"'`
|
||||
await $`osascript -e 'display notification "Session completed!" with title "opencode"'`
|
||||
}
|
||||
},
|
||||
}
|
||||
@@ -234,7 +234,7 @@ export const NotificationPlugin = async ({ project, client, $, directory, worktr
|
||||
Estamos usando `osascript` para executar AppleScript no macOS. Aqui estamos usando para enviar notificações.
|
||||
|
||||
:::note
|
||||
Se você estiver usando o aplicativo desktop OpenCode, ele pode enviar notificações do sistema automaticamente quando uma resposta estiver pronta ou quando ocorrer um erro na sessão.
|
||||
Se você estiver usando o aplicativo desktop opencode, ele pode enviar notificações do sistema automaticamente quando uma resposta estiver pronta ou quando ocorrer um erro na sessão.
|
||||
:::
|
||||
|
||||
---
|
||||
@@ -291,7 +291,7 @@ export const CustomToolsPlugin: Plugin = async (ctx) => {
|
||||
},
|
||||
async execute(args, context) {
|
||||
const { directory, worktree } = context
|
||||
return `Olá ${args.foo} de ${directory} (worktree: ${worktree})`
|
||||
return `Hello ${args.foo} from ${directory} (worktree: ${worktree})`
|
||||
},
|
||||
}),
|
||||
},
|
||||
|
||||
@@ -1,17 +1,17 @@
|
||||
---
|
||||
title: Provedores
|
||||
description: Usando qualquer provedor LLM no OpenCode.
|
||||
description: Usando qualquer provedor LLM no opencode.
|
||||
---
|
||||
|
||||
import config from "../../../../config.mjs"
|
||||
export const console = config.console
|
||||
|
||||
OpenCode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais.
|
||||
opencode usa o [AI SDK](https://ai-sdk.dev/) e [Models.dev](https://models.dev) para suportar **75+ provedores LLM** e suporta a execução de modelos locais.
|
||||
|
||||
Para adicionar um provedor, você precisa:
|
||||
|
||||
1. Adicionar as chaves da API para o provedor usando o comando `/connect`.
|
||||
2. Configurar o provedor na sua configuração do OpenCode.
|
||||
2. Configurar o provedor na sua configuração do opencode.
|
||||
|
||||
---
|
||||
|
||||
@@ -23,7 +23,7 @@ Quando você adiciona as chaves da API de um provedor com o comando `/connect`,
|
||||
|
||||
### Configuração
|
||||
|
||||
Você pode personalizar os provedores através da seção `provider` na sua configuração do OpenCode.
|
||||
Você pode personalizar os provedores através da seção `provider` na sua configuração do opencode.
|
||||
|
||||
---
|
||||
|
||||
@@ -48,7 +48,7 @@ Você pode personalizar a URL base para qualquer provedor definindo a opção `b
|
||||
|
||||
## OpenCode Zen
|
||||
|
||||
OpenCode Zen é uma lista de modelos fornecidos pela equipe do OpenCode que foram testados e verificados para funcionar bem com o OpenCode. [Saiba mais](/docs/zen).
|
||||
OpenCode Zen é uma lista de modelos fornecidos pela equipe do opencode que foram testados e verificados para funcionar bem com o opencode. [Saiba mais](/docs/zen).
|
||||
|
||||
:::tip
|
||||
Se você é novo, recomendamos começar com o OpenCode Zen.
|
||||
@@ -77,7 +77,7 @@ Se você é novo, recomendamos começar com o OpenCode Zen.
|
||||
/models
|
||||
```
|
||||
|
||||
Funciona como qualquer outro provedor no OpenCode e é completamente opcional.
|
||||
Funciona como qualquer outro provedor no opencode e é completamente opcional.
|
||||
|
||||
---
|
||||
|
||||
@@ -120,7 +120,7 @@ Não vê um provedor aqui? Envie um PR.
|
||||
|
||||
### Amazon Bedrock
|
||||
|
||||
Para usar o Amazon Bedrock com o OpenCode:
|
||||
Para usar o Amazon Bedrock com o opencode:
|
||||
|
||||
1. Acesse o **Catálogo de Modelos** no console do Amazon Bedrock e solicite acesso aos modelos que você deseja.
|
||||
|
||||
@@ -273,7 +273,7 @@ Para perfis de inferência personalizados, use o nome do modelo e do provedor na
|
||||
```
|
||||
|
||||
:::info
|
||||
Usar sua assinatura Claude Pro/Max no OpenCode não é oficialmente suportado pela [Anthropic](https://anthropic.com).
|
||||
Usar sua assinatura Claude Pro/Max no opencode não é oficialmente suportado pela [Anthropic](https://anthropic.com).
|
||||
:::
|
||||
|
||||
##### Usando chaves da API
|
||||
@@ -656,7 +656,7 @@ GitLab Duo fornece um chat agente com suporte a ferramentas nativas através do
|
||||
#### Usando Token de Acesso Pessoal
|
||||
1. Vá para [Configurações do Usuário do GitLab > Tokens de Acesso](https://gitlab.com/-/user_settings/personal_access_tokens)
|
||||
2. Clique em **Adicionar novo token**
|
||||
3. Nome: `OpenCode`, Escopos: `api`
|
||||
3. Nome: `opencode`, Escopos: `api`
|
||||
4. Copie o token (começa com `glpat-`)
|
||||
5. Insira-o no terminal
|
||||
|
||||
@@ -679,8 +679,8 @@ armazenar o token no armazenamento de autenticação do opencode.
|
||||
##### GitLab Auto-Hospedado
|
||||
|
||||
:::note[nota de conformidade]
|
||||
OpenCode usa um pequeno modelo para algumas tarefas de IA, como gerar o título da sessão.
|
||||
Ele está configurado para usar gpt-5-nano por padrão, hospedado pela Zen. Para bloquear o OpenCode
|
||||
opencode usa um pequeno modelo para algumas tarefas de IA, como gerar o título da sessão.
|
||||
Ele está configurado para usar gpt-5-nano por padrão, hospedado pela Zen. Para bloquear o opencode
|
||||
para usar apenas sua própria instância hospedada do GitLab, adicione o seguinte ao seu
|
||||
arquivo `opencode.json`. Também é recomendado desativar o compartilhamento de sessões.
|
||||
|
||||
@@ -816,7 +816,7 @@ Alguns modelos precisam ser habilitados manualmente nas suas [configurações do
|
||||
|
||||
### Google Vertex AI
|
||||
|
||||
Para usar o Google Vertex AI com o OpenCode:
|
||||
Para usar o Google Vertex AI com o opencode:
|
||||
|
||||
1. Acesse o **Model Garden** no Console do Google Cloud e verifique os
|
||||
modelos disponíveis na sua região.
|
||||
@@ -998,7 +998,7 @@ Helicone suporta cabeçalhos personalizados para recursos como cache, rastreamen
|
||||
|
||||
##### Rastreamento de Sessões
|
||||
|
||||
O recurso [Sessões](https://docs.helicone.ai/features/sessions) do Helicone permite que você agrupe solicitações LLM relacionadas. Use o plugin [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) para registrar automaticamente cada conversa do OpenCode como uma sessão no Helicone.
|
||||
O recurso [Sessões](https://docs.helicone.ai/features/sessions) do Helicone permite que você agrupe solicitações LLM relacionadas. Use o plugin [opencode-helicone-session](https://github.com/H2Shami/opencode-helicone-session) para registrar automaticamente cada conversa do opencode como uma sessão no Helicone.
|
||||
|
||||
```bash
|
||||
npm install -g opencode-helicone-session
|
||||
@@ -1012,7 +1012,7 @@ Adicione-o à sua configuração.
|
||||
}
|
||||
```
|
||||
|
||||
O plugin injeta os cabeçalhos `Helicone-Session-Id` e `Helicone-Session-Name` em suas solicitações. Na página de Sessões do Helicone, você verá cada conversa do OpenCode listada como uma sessão separada.
|
||||
O plugin injeta os cabeçalhos `Helicone-Session-Id` e `Helicone-Session-Name` em suas solicitações. Na página de Sessões do Helicone, você verá cada conversa do opencode listada como uma sessão separada.
|
||||
|
||||
##### Cabeçalhos Comuns do Helicone
|
||||
|
||||
@@ -1216,7 +1216,7 @@ Para usar Kimi K2 do Moonshot AI:
|
||||
Você pode configurar o opencode para usar modelos locais através do Ollama.
|
||||
|
||||
:::tip
|
||||
Ollama pode se configurar automaticamente para o OpenCode. Consulte a [documentação de integração do Ollama](https://docs.ollama.com/integrations/opencode) para detalhes.
|
||||
Ollama pode se configurar automaticamente para o opencode. Consulte a [documentação de integração do Ollama](https://docs.ollama.com/integrations/opencode) para detalhes.
|
||||
:::
|
||||
|
||||
```json title="opencode.json" "ollama" {5, 6, 8, 10-14}
|
||||
@@ -1255,13 +1255,13 @@ Se chamadas de ferramentas não estiverem funcionando, tente aumentar `num_ctx`
|
||||
|
||||
### Ollama Cloud
|
||||
|
||||
Para usar o Ollama Cloud com o OpenCode:
|
||||
Para usar o Ollama Cloud com o opencode:
|
||||
|
||||
1. Acesse [https://ollama.com/](https://ollama.com/) e faça login ou crie uma conta.
|
||||
|
||||
2. Navegue até **Configurações** > **Chaves** e clique em **Adicionar Chave da API** para gerar uma nova chave da API.
|
||||
|
||||
3. Copie a chave da API para uso no OpenCode.
|
||||
3. Copie a chave da API para uso no opencode.
|
||||
|
||||
4. Execute o comando `/connect` e procure por **Ollama Cloud**.
|
||||
|
||||
@@ -1278,7 +1278,7 @@ Para usar o Ollama Cloud com o OpenCode:
|
||||
└ enter
|
||||
```
|
||||
|
||||
6. **Importante**: Antes de usar modelos em nuvem no OpenCode, você deve puxar as informações do modelo localmente:
|
||||
6. **Importante**: Antes de usar modelos em nuvem no opencode, você deve puxar as informações do modelo localmente:
|
||||
|
||||
```bash
|
||||
ollama pull gpt-oss:20b-cloud
|
||||
@@ -1326,7 +1326,7 @@ Se você já tiver uma chave da API, pode selecionar **Inserir chave da API manu
|
||||
|
||||
### OpenCode Zen
|
||||
|
||||
OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe do OpenCode. [Saiba mais](/docs/zen).
|
||||
OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe do opencode. [Saiba mais](/docs/zen).
|
||||
|
||||
1. Faça login em **<a href={console}>OpenCode Zen</a>** e clique em **Criar Chave da API**.
|
||||
|
||||
@@ -1336,7 +1336,7 @@ OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equi
|
||||
/connect
|
||||
```
|
||||
|
||||
3. Insira sua chave da API do OpenCode.
|
||||
3. Insira sua chave da API do opencode.
|
||||
|
||||
```txt
|
||||
┌ Chave da API
|
||||
@@ -1474,7 +1474,7 @@ SAP AI Core fornece acesso a mais de 40 modelos do OpenAI, Anthropic, Google, Am
|
||||
|
||||
### OVHcloud AI Endpoints
|
||||
|
||||
1. Acesse o [painel OVHcloud](https://ovh.com/manager). Navegue até a seção `Nuvem Pública`, `IA & Aprendizado de Máquina` > `Endpoints de IA` e na aba `Chaves da API`, clique em **Criar uma nova chave da API**.
|
||||
1. Acesse o [painel OVHcloud](https://ovh.com/manager). Navegue até a seção `Public Cloud`, `AI & Machine Learning` > `Endpoints de IA` e na aba `API Keys`, clique em **Criar uma nova chave da API**.
|
||||
|
||||
2. Execute o comando `/connect` e procure por **OVHcloud AI Endpoints**.
|
||||
|
||||
@@ -1501,7 +1501,7 @@ SAP AI Core fornece acesso a mais de 40 modelos do OpenAI, Anthropic, Google, Am
|
||||
|
||||
### Scaleway
|
||||
|
||||
Para usar [APIs Generativas Scaleway](https://www.scaleway.com/en/docs/generative-apis/) com o Opencode:
|
||||
Para usar [APIs Generativas Scaleway](https://www.scaleway.com/en/docs/generative-apis/) com o opencode:
|
||||
|
||||
1. Acesse as [configurações de IAM do Scaleway Console](https://console.scaleway.com/iam/api-keys) para gerar uma nova chave da API.
|
||||
|
||||
@@ -1862,7 +1862,7 @@ Detalhes da configuração:
|
||||
- **limit.context**: Máximo de tokens de entrada que o modelo aceita.
|
||||
- **limit.output**: Máximo de tokens que o modelo pode gerar.
|
||||
|
||||
Os campos `limit` permitem que o OpenCode entenda quanto contexto você tem disponível. Provedores padrão puxam isso automaticamente do models.dev.
|
||||
Os campos `limit` permitem que o opencode entenda quanto contexto você tem disponível. Provedores padrão puxam isso automaticamente do models.dev.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -68,7 +68,7 @@ Como isso não é commitado no Git ou compartilhado com sua equipe, recomendamos
|
||||
|
||||
### Compatibilidade com Claude Code
|
||||
|
||||
Para usuários migrando do Claude Code, o OpenCode suporta as convenções de arquivo do Claude Code como alternativas:
|
||||
Para usuários migrando do Claude Code, o opencode suporta as convenções de arquivo do Claude Code como alternativas:
|
||||
|
||||
- **Regras do projeto**: `CLAUDE.md` no diretório do seu projeto (usado se não existir `AGENTS.md`)
|
||||
- **Regras globais**: `~/.claude/CLAUDE.md` (usado se não existir `~/.config/opencode/AGENTS.md`)
|
||||
|
||||
@@ -62,7 +62,7 @@ const opencode = await createOpencode({
|
||||
},
|
||||
})
|
||||
|
||||
console.log(`Servidor rodando em ${opencode.server.url}`)
|
||||
console.log(`Server running at ${opencode.server.url}`)
|
||||
|
||||
opencode.server.close()
|
||||
```
|
||||
|
||||
@@ -62,7 +62,7 @@ Você pode executar `opencode serve` para iniciar um servidor autônomo. Se voc
|
||||
|
||||
Quando você inicia o TUI, ele atribui aleatoriamente uma porta e um nome de host. Você pode passar os [flags](/docs/cli) `--hostname` e `--port`. Em seguida, use isso para se conectar ao seu servidor.
|
||||
|
||||
O endpoint [`/tui`](#tui) pode ser usado para controlar o TUI através do servidor. Por exemplo, você pode preencher ou executar um prompt. Essa configuração é usada pelos plugins do OpenCode [IDE](/docs/ide).
|
||||
O endpoint [`/tui`](#tui) pode ser usado para controlar o TUI através do servidor. Por exemplo, você pode preencher ou executar um prompt. Essa configuração é usada pelos plugins do opencode [IDE](/docs/ide).
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,9 +1,9 @@
|
||||
---
|
||||
title: Compartilhar
|
||||
description: Compartilhe suas conversas do OpenCode.
|
||||
description: Compartilhe suas conversas do opencode.
|
||||
---
|
||||
|
||||
O recurso de compartilhamento do OpenCode permite que você crie links públicos para suas conversas do OpenCode, para que você possa colaborar com colegas de equipe ou obter ajuda de outros.
|
||||
O recurso de compartilhamento do opencode permite que você crie links públicos para suas conversas do opencode, para que você possa colaborar com colegas de equipe ou obter ajuda de outros.
|
||||
|
||||
:::note
|
||||
Conversas compartilhadas são acessíveis publicamente para qualquer pessoa com o link.
|
||||
@@ -13,7 +13,7 @@ Conversas compartilhadas são acessíveis publicamente para qualquer pessoa com
|
||||
|
||||
## Como funciona
|
||||
|
||||
Quando você compartilha uma conversa, o OpenCode:
|
||||
Quando você compartilha uma conversa, o opencode:
|
||||
|
||||
1. Cria uma URL pública única para sua sessão
|
||||
2. Sincroniza seu histórico de conversas com nossos servidores
|
||||
@@ -23,13 +23,13 @@ Quando você compartilha uma conversa, o OpenCode:
|
||||
|
||||
## Compartilhamento
|
||||
|
||||
O OpenCode suporta três modos de compartilhamento que controlam como as conversas são compartilhadas:
|
||||
O opencode suporta três modos de compartilhamento que controlam como as conversas são compartilhadas:
|
||||
|
||||
---
|
||||
|
||||
### Manual (padrão)
|
||||
|
||||
Por padrão, o OpenCode usa o modo de compartilhamento manual. As sessões não são compartilhadas automaticamente, mas você pode compartilhá-las manualmente usando o comando `/share`:
|
||||
Por padrão, o opencode usa o modo de compartilhamento manual. As sessões não são compartilhadas automaticamente, mas você pode compartilhá-las manualmente usando o comando `/share`:
|
||||
|
||||
```
|
||||
/share
|
||||
|
||||
@@ -3,7 +3,7 @@ title: "Habilidades do Agente"
|
||||
description: "Defina comportamentos reutilizáveis via definições de SKILL.md"
|
||||
---
|
||||
|
||||
As habilidades do agente permitem que o OpenCode descubra instruções reutilizáveis do seu repositório ou diretório pessoal.
|
||||
As habilidades do agente permitem que o opencode descubra instruções reutilizáveis do seu repositório ou diretório pessoal.
|
||||
As habilidades são carregadas sob demanda através da ferramenta nativa `skill`—os agentes veem as habilidades disponíveis e podem carregar o conteúdo completo quando necessário.
|
||||
|
||||
---
|
||||
@@ -11,7 +11,7 @@ As habilidades são carregadas sob demanda através da ferramenta nativa `skill`
|
||||
## Colocar arquivos
|
||||
|
||||
Crie uma pasta por nome de habilidade e coloque um `SKILL.md` dentro dela.
|
||||
O OpenCode pesquisa nesses locais:
|
||||
O opencode pesquisa nesses locais:
|
||||
|
||||
- Configuração do projeto: `.opencode/skills/<name>/SKILL.md`
|
||||
- Configuração global: `~/.config/opencode/skills/<name>/SKILL.md`
|
||||
@@ -24,7 +24,7 @@ O OpenCode pesquisa nesses locais:
|
||||
|
||||
## Entender a descoberta
|
||||
|
||||
Para caminhos locais do projeto, o OpenCode sobe a partir do seu diretório de trabalho atual até alcançar a árvore de trabalho do git.
|
||||
Para caminhos locais do projeto, o opencode sobe a partir do seu diretório de trabalho atual até alcançar a árvore de trabalho do git.
|
||||
Ele carrega qualquer `skills/*/SKILL.md` correspondente em `.opencode/` e qualquer `.claude/skills/*/SKILL.md` ou `.agents/skills/*/SKILL.md` ao longo do caminho.
|
||||
|
||||
As definições globais também são carregadas de `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` e `~/.agents/skills/*/SKILL.md`.
|
||||
@@ -102,7 +102,7 @@ Faça perguntas esclarecedoras se o esquema de versionamento alvo não estiver c
|
||||
|
||||
## Reconhecer descrição da ferramenta
|
||||
|
||||
O OpenCode lista as habilidades disponíveis na descrição da ferramenta `skill`.
|
||||
O opencode lista as habilidades disponíveis na descrição da ferramenta `skill`.
|
||||
Cada entrada inclui o nome e a descrição da habilidade:
|
||||
|
||||
```xml
|
||||
|
||||
@@ -3,9 +3,9 @@ title: Temas
|
||||
description: Selecione um tema embutido ou defina o seu próprio.
|
||||
---
|
||||
|
||||
Com o OpenCode, você pode selecionar um dos vários temas embutidos, usar um tema que se adapta ao tema do seu terminal ou definir seu próprio tema personalizado.
|
||||
Com o opencode, você pode selecionar um dos vários temas embutidos, usar um tema que se adapta ao tema do seu terminal ou definir seu próprio tema personalizado.
|
||||
|
||||
Por padrão, o OpenCode usa nosso próprio tema `opencode`.
|
||||
Por padrão, o opencode usa nosso próprio tema `opencode`.
|
||||
|
||||
---
|
||||
|
||||
@@ -23,7 +23,7 @@ Sem suporte a truecolor, os temas podem aparecer com precisão de cor reduzida o
|
||||
|
||||
## Temas embutidos
|
||||
|
||||
O OpenCode vem com vários temas embutidos.
|
||||
O opencode vem com vários temas embutidos.
|
||||
|
||||
| Nome | Descrição |
|
||||
| ---------------------- | --------------------------------------------------------------------------- |
|
||||
@@ -53,7 +53,7 @@ O tema `system` é projetado para se adaptar automaticamente ao esquema de cores
|
||||
|
||||
O tema do sistema é para usuários que:
|
||||
|
||||
- Querem que o OpenCode corresponda à aparência do seu terminal
|
||||
- Querem que o opencode corresponda à aparência do seu terminal
|
||||
- Usam esquemas de cores de terminal personalizados
|
||||
- Preferem uma aparência consistente em todos os aplicativos de terminal
|
||||
|
||||
@@ -74,7 +74,7 @@ Você pode selecionar um tema chamando a seleção de tema com o comando `/theme
|
||||
|
||||
## Temas personalizados
|
||||
|
||||
O OpenCode suporta um sistema de temas flexível baseado em JSON que permite aos usuários criar e personalizar temas facilmente.
|
||||
O opencode suporta um sistema de temas flexível baseado em JSON que permite aos usuários criar e personalizar temas facilmente.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -3,7 +3,7 @@ title: Ferramentas
|
||||
description: Gerencie as ferramentas que um LLM pode usar.
|
||||
---
|
||||
|
||||
As ferramentas permitem que o LLM execute ações em sua base de código. O OpenCode vem com um conjunto de ferramentas integradas, mas você pode estendê-lo com [ferramentas personalizadas](/docs/custom-tools) ou [servidores MCP](/docs/mcp-servers).
|
||||
As ferramentas permitem que o LLM execute ações em sua base de código. O opencode vem com um conjunto de ferramentas integradas, mas você pode estendê-lo com [ferramentas personalizadas](/docs/custom-tools) ou [servidores MCP](/docs/mcp-servers).
|
||||
|
||||
Por padrão, todas as ferramentas estão **ativadas** e não precisam de permissão para serem executadas. Você pode controlar o comportamento das ferramentas através de [permissões](/docs/permissions).
|
||||
|
||||
@@ -41,7 +41,7 @@ Você também pode usar curingas para controlar várias ferramentas ao mesmo tem
|
||||
|
||||
## Integradas
|
||||
|
||||
Aqui estão todas as ferramentas integradas disponíveis no OpenCode.
|
||||
Aqui estão todas as ferramentas integradas disponíveis no opencode.
|
||||
|
||||
---
|
||||
|
||||
@@ -291,9 +291,9 @@ Permite que o LLM busque e leia páginas da web. Útil para consultar documenta
|
||||
Pesquise na web por informações.
|
||||
|
||||
:::note
|
||||
Esta ferramenta está disponível apenas ao usar o provedor OpenCode ou quando a variável de ambiente `OPENCODE_ENABLE_EXA` está definida como qualquer valor verdadeiro (por exemplo, `true` ou `1`).
|
||||
Esta ferramenta está disponível apenas ao usar o provedor opencode ou quando a variável de ambiente `OPENCODE_ENABLE_EXA` está definida como qualquer valor verdadeiro (por exemplo, `true` ou `1`).
|
||||
|
||||
Para habilitar ao iniciar o OpenCode:
|
||||
Para habilitar ao iniciar o opencode:
|
||||
|
||||
```bash
|
||||
OPENCODE_ENABLE_EXA=1 opencode
|
||||
|
||||
@@ -3,7 +3,7 @@ title: Solução de Problemas
|
||||
description: Problemas comuns e como resolvê-los.
|
||||
---
|
||||
|
||||
Para depurar problemas com o OpenCode, comece verificando os logs e os dados locais que ele armazena no disco.
|
||||
Para depurar problemas com o opencode, comece verificando os logs e os dados locais que ele armazena no disco.
|
||||
|
||||
---
|
||||
|
||||
@@ -39,13 +39,13 @@ Este diretório contém:
|
||||
|
||||
## Aplicativo de Desktop
|
||||
|
||||
OpenCode Desktop executa um servidor OpenCode local (o sidecar `opencode-cli`) em segundo plano. A maioria dos problemas é causada por um plugin com mau funcionamento, um cache corrompido ou uma configuração de servidor incorreta.
|
||||
opencode Desktop executa um servidor opencode local (o sidecar `opencode-cli`) em segundo plano. A maioria dos problemas é causada por um plugin com mau funcionamento, um cache corrompido ou uma configuração de servidor incorreta.
|
||||
|
||||
### Verificações rápidas
|
||||
|
||||
- Saia completamente do aplicativo e reinicie-o.
|
||||
- Se o aplicativo mostrar uma tela de erro, clique em **Reiniciar** e copie os detalhes do erro.
|
||||
- Apenas macOS: menu `OpenCode` -> **Recarregar Webview** (ajuda se a interface estiver em branco/congelada).
|
||||
- Apenas macOS: menu `opencode` -> **Recarregar Webview** (ajuda se a interface estiver em branco/congelada).
|
||||
|
||||
---
|
||||
|
||||
@@ -72,13 +72,13 @@ Se você tiver plugins configurados, desative-os temporariamente removendo a cha
|
||||
|
||||
#### Verifique os diretórios de plugins
|
||||
|
||||
OpenCode também pode carregar plugins locais do disco. Mova-os temporariamente para fora do caminho (ou renomeie a pasta) e reinicie o aplicativo de desktop:
|
||||
opencode também pode carregar plugins locais do disco. Mova-os temporariamente para fora do caminho (ou renomeie a pasta) e reinicie o aplicativo de desktop:
|
||||
|
||||
- **Plugins globais**
|
||||
- **macOS/Linux**: `~/.config/opencode/plugins/`
|
||||
- **Windows**: Pressione `WIN+R` e cole `%USERPROFILE%\.config\opencode\plugins`
|
||||
- **Plugins de projeto** (apenas se você usar configuração por projeto)
|
||||
- `<seu-projeto>/.opencode/plugins/`
|
||||
- `<your-project>/.opencode/plugins/`
|
||||
|
||||
Se o aplicativo voltar a funcionar, reative os plugins um por um para descobrir qual está causando o problema.
|
||||
|
||||
@@ -86,22 +86,22 @@ Se o aplicativo voltar a funcionar, reative os plugins um por um para descobrir
|
||||
|
||||
### Limpar o cache
|
||||
|
||||
Se desativar plugins não ajudar (ou se a instalação de um plugin estiver travada), limpe o cache para que o OpenCode possa reconstruí-lo.
|
||||
Se desativar plugins não ajudar (ou se a instalação de um plugin estiver travada), limpe o cache para que o opencode possa reconstruí-lo.
|
||||
|
||||
1. Saia completamente do OpenCode Desktop.
|
||||
1. Saia completamente do opencode Desktop.
|
||||
2. Exclua o diretório de cache:
|
||||
|
||||
- **macOS**: Finder -> `Cmd+Shift+G` -> cole `~/.cache/opencode`
|
||||
- **Linux**: exclua `~/.cache/opencode` (ou execute `rm -rf ~/.cache/opencode`)
|
||||
- **Windows**: Pressione `WIN+R` e cole `%USERPROFILE%\.cache\opencode`
|
||||
|
||||
3. Reinicie o OpenCode Desktop.
|
||||
3. Reinicie o opencode Desktop.
|
||||
|
||||
---
|
||||
|
||||
### Corrigir problemas de conexão com o servidor
|
||||
|
||||
OpenCode Desktop pode iniciar seu próprio servidor local (padrão) ou conectar-se a uma URL de servidor que você configurou.
|
||||
opencode Desktop pode iniciar seu próprio servidor local (padrão) ou conectar-se a uma URL de servidor que você configurou.
|
||||
|
||||
Se você ver um diálogo **"Conexão Falhou"** (ou o aplicativo nunca passa da tela de inicialização), verifique se há uma URL de servidor personalizada.
|
||||
|
||||
@@ -132,21 +132,21 @@ No Linux, algumas configurações do Wayland podem causar janelas em branco ou e
|
||||
|
||||
### Windows: WebView2 runtime
|
||||
|
||||
No Windows, o OpenCode Desktop requer o **WebView2 Runtime** do Microsoft Edge. Se o aplicativo abrir em uma janela em branco ou não iniciar, instale/atualize o WebView2 e tente novamente.
|
||||
No Windows, o opencode Desktop requer o **WebView2 Runtime** do Microsoft Edge. Se o aplicativo abrir em uma janela em branco ou não iniciar, instale/atualize o WebView2 e tente novamente.
|
||||
|
||||
---
|
||||
|
||||
### Windows: Problemas gerais de desempenho
|
||||
|
||||
Se você estiver enfrentando desempenho lento, problemas de acesso a arquivos ou problemas no terminal no Windows, tente usar [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). O WSL fornece um ambiente Linux que funciona de forma mais integrada com os recursos do OpenCode.
|
||||
Se você estiver enfrentando desempenho lento, problemas de acesso a arquivos ou problemas no terminal no Windows, tente usar [WSL (Windows Subsystem for Linux)](/docs/windows-wsl). O WSL fornece um ambiente Linux que funciona de forma mais integrada com os recursos do opencode.
|
||||
|
||||
---
|
||||
|
||||
### Notificações não aparecendo
|
||||
|
||||
O OpenCode Desktop só mostra notificações do sistema quando:
|
||||
O opencode Desktop só mostra notificações do sistema quando:
|
||||
|
||||
- as notificações estão habilitadas para o OpenCode nas configurações do seu sistema operacional, e
|
||||
- as notificações estão habilitadas para o opencode nas configurações do seu sistema operacional, e
|
||||
- a janela do aplicativo não está focada.
|
||||
|
||||
---
|
||||
@@ -155,8 +155,8 @@ O OpenCode Desktop só mostra notificações do sistema quando:
|
||||
|
||||
Se o aplicativo não iniciar e você não conseguir limpar as configurações pela interface, redefina o estado salvo do aplicativo de desktop.
|
||||
|
||||
1. Saia do OpenCode Desktop.
|
||||
2. Encontre e exclua estes arquivos (eles estão no diretório de dados do aplicativo OpenCode Desktop):
|
||||
1. Saia do opencode Desktop.
|
||||
2. Encontre e exclua estes arquivos (eles estão no diretório de dados do aplicativo opencode Desktop):
|
||||
|
||||
- `opencode.settings.dat` (URL do servidor padrão do desktop)
|
||||
- `opencode.global.dat` e `opencode.workspace.*.dat` (estado da interface como servidores/projetos recentes)
|
||||
@@ -171,7 +171,7 @@ Para encontrar o diretório rapidamente:
|
||||
|
||||
## Obtendo ajuda
|
||||
|
||||
Se você estiver enfrentando problemas com o OpenCode:
|
||||
Se você estiver enfrentando problemas com o opencode:
|
||||
|
||||
1. **Relatar problemas no GitHub**
|
||||
|
||||
@@ -195,7 +195,7 @@ Aqui estão alguns problemas comuns e como resolvê-los.
|
||||
|
||||
---
|
||||
|
||||
### OpenCode não inicia
|
||||
### opencode não inicia
|
||||
|
||||
1. Verifique os logs em busca de mensagens de erro
|
||||
2. Tente executar com `--print-logs` para ver a saída no terminal
|
||||
|
||||
@@ -1,13 +1,13 @@
|
||||
---
|
||||
title: TUI
|
||||
description: Usando a interface de usuário de terminal OpenCode.
|
||||
description: Usando a interface de usuário de terminal opencode.
|
||||
---
|
||||
|
||||
import { Tabs, TabItem } from "@astrojs/starlight/components"
|
||||
|
||||
OpenCode fornece uma interface de terminal interativa ou TUI para trabalhar em seus projetos com um LLM.
|
||||
opencode fornece uma interface de terminal interativa ou TUI para trabalhar em seus projetos com um LLM.
|
||||
|
||||
Executar OpenCode inicia o TUI para o diretório atual.
|
||||
Executar opencode inicia o TUI para o diretório atual.
|
||||
|
||||
```bash
|
||||
opencode
|
||||
@@ -57,7 +57,7 @@ A saída do comando é adicionada à conversa como um resultado de ferramenta.
|
||||
|
||||
## Comandos
|
||||
|
||||
Ao usar o TUI do OpenCode, você pode digitar `/` seguido pelo nome de um comando para executar ações rapidamente. Por exemplo:
|
||||
Ao usar o TUI do opencode, você pode digitar `/` seguido pelo nome de um comando para executar ações rapidamente. Por exemplo:
|
||||
|
||||
```bash frame="none"
|
||||
/help
|
||||
@@ -71,7 +71,7 @@ Aqui estão todos os comandos de barra disponíveis:
|
||||
|
||||
### connect
|
||||
|
||||
Adicione um provedor ao OpenCode. Permite que você selecione entre os provedores disponíveis e adicione suas chaves de API.
|
||||
Adicione um provedor ao opencode. Permite que você selecione entre os provedores disponíveis e adicione suas chaves de API.
|
||||
|
||||
```bash frame="none"
|
||||
/connect
|
||||
@@ -117,7 +117,7 @@ Abra um editor externo para compor mensagens. Usa o editor definido na sua vari
|
||||
|
||||
### exit
|
||||
|
||||
Saia do OpenCode. _Aliases_: `/quit`, `/q`
|
||||
Saia do opencode. _Aliases_: `/quit`, `/q`
|
||||
|
||||
```bash frame="none"
|
||||
/exit
|
||||
@@ -333,7 +333,7 @@ Tanto os comandos `/editor` quanto `/export` usam o editor especificado na sua v
|
||||
|
||||
As opções de editor populares incluem:
|
||||
|
||||
- `code` - Visual Studio Code
|
||||
- `code` - VS Code
|
||||
- `cursor` - Cursor
|
||||
- `windsurf` - Windsurf
|
||||
- `nvim` - Editor Neovim
|
||||
@@ -352,7 +352,7 @@ Alguns editores precisam de argumentos de linha de comando para rodar em modo bl
|
||||
|
||||
## Configurar
|
||||
|
||||
Você pode personalizar o comportamento do TUI através do seu arquivo de configuração do OpenCode.
|
||||
Você pode personalizar o comportamento do TUI através do seu arquivo de configuração do opencode.
|
||||
|
||||
```json title="opencode.json"
|
||||
{
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
---
|
||||
title: Web
|
||||
description: Usando OpenCode no seu navegador.
|
||||
description: Usando opencode no seu navegador.
|
||||
---
|
||||
|
||||
OpenCode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma poderosa experiência de codificação com IA sem precisar de um terminal.
|
||||
opencode pode ser executado como uma aplicação web no seu navegador, proporcionando a mesma poderosa experiência de codificação com IA sem precisar de um terminal.
|
||||
|
||||

|
||||

|
||||
|
||||
## Começando
|
||||
|
||||
@@ -15,7 +15,7 @@ Inicie a interface web executando:
|
||||
opencode web
|
||||
```
|
||||
|
||||
Isso inicia um servidor local em `127.0.0.1` com uma porta aleatória disponível e abre automaticamente o OpenCode no seu navegador padrão.
|
||||
Isso inicia um servidor local em `127.0.0.1` com uma porta aleatória disponível e abre automaticamente o opencode no seu navegador padrão.
|
||||
|
||||
:::caution
|
||||
Se `OPENCODE_SERVER_PASSWORD` não estiver definido, o servidor ficará sem segurança. Isso é aceitável para uso local, mas deve ser configurado para acesso à rede.
|
||||
@@ -33,7 +33,7 @@ Você pode configurar o servidor web usando flags de linha de comando ou no seu
|
||||
|
||||
### Porta
|
||||
|
||||
Por padrão, o OpenCode escolhe uma porta disponível. Você pode especificar uma porta:
|
||||
Por padrão, o opencode escolhe uma porta disponível. Você pode especificar uma porta:
|
||||
|
||||
```bash
|
||||
opencode web --port 4096
|
||||
@@ -41,13 +41,13 @@ opencode web --port 4096
|
||||
|
||||
### Nome do Host
|
||||
|
||||
Por padrão, o servidor se vincula a `127.0.0.1` (apenas localhost). Para tornar o OpenCode acessível na sua rede:
|
||||
Por padrão, o servidor se vincula a `127.0.0.1` (apenas localhost). Para tornar o opencode acessível na sua rede:
|
||||
|
||||
```bash
|
||||
opencode web --hostname 0.0.0.0
|
||||
```
|
||||
|
||||
Ao usar `0.0.0.0`, o OpenCode exibirá endereços locais e de rede:
|
||||
Ao usar `0.0.0.0`, o opencode exibirá endereços locais e de rede:
|
||||
|
||||
```
|
||||
Acesso local: http://localhost:4096
|
||||
@@ -92,19 +92,19 @@ O nome de usuário padrão é `opencode`, mas pode ser alterado com `OPENCODE_SE
|
||||
|
||||
## Usando a Interface Web
|
||||
|
||||
Uma vez iniciada, a interface web fornece acesso às suas sessões do OpenCode.
|
||||
Uma vez iniciada, a interface web fornece acesso às suas sessões do opencode.
|
||||
|
||||
### Sessões
|
||||
|
||||
Visualize e gerencie suas sessões a partir da página inicial. Você pode ver sessões ativas e iniciar novas.
|
||||
|
||||

|
||||

|
||||
|
||||
### Status do Servidor
|
||||
|
||||
Clique em "Ver Servidores" para visualizar os servidores conectados e seu status.
|
||||
|
||||

|
||||

|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -1,14 +1,14 @@
|
||||
---
|
||||
title: Windows (WSL)
|
||||
description: Execute o OpenCode no Windows com WSL para melhor experiencia.
|
||||
description: Execute o opencode no Windows com WSL para melhor experiencia.
|
||||
---
|
||||
|
||||
import { Steps } from "@astrojs/starlight/components"
|
||||
|
||||
Embora o OpenCode possa rodar direto no Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para a melhor experiencia. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do OpenCode.
|
||||
Embora o opencode possa rodar direto no Windows, recomendamos usar [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install) para a melhor experiencia. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do opencode.
|
||||
|
||||
:::tip[Por que WSL?]
|
||||
O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o OpenCode depende.
|
||||
O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o opencode depende.
|
||||
:::
|
||||
|
||||
---
|
||||
@@ -21,17 +21,17 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi
|
||||
|
||||
Se ainda nao instalou, [instale o WSL](https://learn.microsoft.com/en-us/windows/wsl/install) usando o guia oficial da Microsoft.
|
||||
|
||||
2. **Instale o OpenCode no WSL**
|
||||
2. **Instale o opencode no WSL**
|
||||
|
||||
Depois de configurar o WSL, abra o terminal do WSL e instale o OpenCode usando um dos [metodos de instalacao](/docs/).
|
||||
Depois de configurar o WSL, abra o terminal do WSL e instale o opencode usando um dos [metodos de instalacao](/docs/).
|
||||
|
||||
```bash
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
```
|
||||
|
||||
3. **Use o OpenCode pelo WSL**
|
||||
3. **Use o opencode pelo WSL**
|
||||
|
||||
Va para o diretorio do seu projeto (acesse arquivos do Windows via `/mnt/c/`, `/mnt/d/` etc.) e execute o OpenCode.
|
||||
Va para o diretorio do seu projeto (acesse arquivos do Windows via `/mnt/c/`, `/mnt/d/` etc.) e execute o opencode.
|
||||
|
||||
```bash
|
||||
cd /mnt/c/Users/YourName/project
|
||||
@@ -44,7 +44,7 @@ O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a termi
|
||||
|
||||
## App desktop + servidor WSL
|
||||
|
||||
Se voce prefere usar o app desktop do OpenCode, mas quer rodar o servidor no WSL:
|
||||
Se voce prefere usar o app desktop do opencode, mas quer rodar o servidor no WSL:
|
||||
|
||||
1. **Inicie o servidor no WSL** com `--hostname 0.0.0.0` para permitir conexoes externas:
|
||||
|
||||
@@ -79,7 +79,7 @@ Para a melhor experiencia web no Windows:
|
||||
opencode web --hostname 0.0.0.0
|
||||
```
|
||||
|
||||
2. **Acesse pelo navegador do Windows** em `http://localhost:<port>` (o OpenCode mostra a URL)
|
||||
2. **Acesse pelo navegador do Windows** em `http://localhost:<port>` (o opencode mostra a URL)
|
||||
|
||||
Executar `opencode web` a partir do WSL garante acesso correto ao sistema de arquivos e integracao com o terminal, continuando acessivel no navegador do Windows.
|
||||
|
||||
@@ -101,13 +101,13 @@ opencode
|
||||
```
|
||||
|
||||
:::tip
|
||||
Para uma experiencia mais fluida, considere clonar/copiar seu repositorio para o sistema de arquivos do WSL (por exemplo em `~/code/`) e executar o OpenCode por la.
|
||||
Para uma experiencia mais fluida, considere clonar/copiar seu repositorio para o sistema de arquivos do WSL (por exemplo em `~/code/`) e executar o opencode por la.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## Dicas
|
||||
|
||||
- Mantenha o OpenCode rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido
|
||||
- Use a [extensao WSL do VS Code](https://code.visualstudio.com/docs/remote/wsl) junto com o OpenCode para um fluxo de desenvolvimento integrado
|
||||
- Sua configuracao e suas sessoes do OpenCode ficam armazenadas no ambiente WSL em `~/.local/share/opencode/`
|
||||
- Mantenha o opencode rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido
|
||||
- Use a [extensao WSL do VS Code](https://code.visualstudio.com/docs/remote/wsl) junto com o opencode para um fluxo de desenvolvimento integrado
|
||||
- Sua configuracao e suas sessoes do opencode ficam armazenadas no ambiente WSL em `~/.local/share/opencode/`
|
||||
|
||||
@@ -1,19 +1,19 @@
|
||||
---
|
||||
title: Zen
|
||||
description: Lista selecionada de modelos fornecidos pela OpenCode.
|
||||
description: Lista selecionada de modelos fornecidos pela opencode.
|
||||
---
|
||||
|
||||
import config from "../../../../config.mjs"
|
||||
export const console = config.console
|
||||
export const email = `mailto:${config.email}`
|
||||
|
||||
OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe da OpenCode.
|
||||
OpenCode Zen é uma lista de modelos testados e verificados fornecidos pela equipe da opencode.
|
||||
|
||||
:::note
|
||||
OpenCode Zen está atualmente em beta.
|
||||
:::
|
||||
|
||||
Zen funciona como qualquer outro provedor na OpenCode. Você faz login no OpenCode Zen e obtém sua chave de API. É **completamente opcional** e você não precisa usá-la para utilizar a OpenCode.
|
||||
Zen funciona como qualquer outro provedor na opencode. Você faz login no OpenCode Zen e obtém sua chave de API. É **completamente opcional** e você não precisa usá-la para utilizar a opencode.
|
||||
|
||||
---
|
||||
|
||||
@@ -22,7 +22,7 @@ Zen funciona como qualquer outro provedor na OpenCode. Você faz login no OpenCo
|
||||
Existem um grande número de modelos disponíveis, mas apenas alguns desses modelos funcionam bem como agentes de codificação. Além disso, a maioria dos provedores é configurada de maneira muito diferente; portanto, você obtém desempenhos e qualidades muito diferentes.
|
||||
|
||||
:::tip
|
||||
Testamos um grupo selecionado de modelos e provedores que funcionam bem com a OpenCode.
|
||||
Testamos um grupo selecionado de modelos e provedores que funcionam bem com a opencode.
|
||||
:::
|
||||
|
||||
Portanto, se você estiver usando um modelo através de algo como OpenRouter, você nunca pode ter certeza se está obtendo a melhor versão do modelo que deseja.
|
||||
@@ -39,7 +39,7 @@ OpenCode Zen é um gateway de IA que lhe dá acesso a esses modelos.
|
||||
|
||||
## Como funciona
|
||||
|
||||
OpenCode Zen funciona como qualquer outro provedor na OpenCode.
|
||||
OpenCode Zen funciona como qualquer outro provedor na opencode.
|
||||
|
||||
1. Você faz login no **<a href={console}>OpenCode Zen</a>**, adiciona seus dados de cobrança e copia sua chave de API.
|
||||
2. Você executa o comando `/connect` na TUI, seleciona OpenCode Zen e cola sua chave de API.
|
||||
@@ -85,7 +85,7 @@ Você também pode acessar nossos modelos através dos seguintes endpoints da AP
|
||||
| Qwen3 Coder 480B | qwen3-coder | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` |
|
||||
| Big Pickle | big-pickle | `https://opencode.ai/zen/v1/chat/completions` | `@ai-sdk/openai-compatible` |
|
||||
|
||||
O [id do modelo](/docs/config/#models) na sua configuração da OpenCode usa o formato `opencode/<model-id>`. Por exemplo, para GPT 5.2 Codex, você usaria `opencode/gpt-5.2-codex` na sua configuração.
|
||||
O [id do modelo](/docs/config/#models) na sua configuração da opencode usa o formato `opencode/<model-id>`. Por exemplo, para GPT 5.2 Codex, você usaria `opencode/gpt-5.2-codex` na sua configuração.
|
||||
|
||||
---
|
||||
|
||||
@@ -147,10 +147,10 @@ As taxas de cartão de crédito são repassadas ao custo (4,4% + $0,30 por trans
|
||||
|
||||
Os modelos gratuitos:
|
||||
|
||||
- GLM 4.7 Free está disponível na OpenCode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
- Kimi K2.5 Free está disponível na OpenCode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
- MiniMax M2.1 Free está disponível na OpenCode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
- Big Pickle é um modelo oculto que está gratuito na OpenCode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
- GLM 4.7 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
- Kimi K2.5 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
- MiniMax M2.1 Free está disponível na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
- Big Pickle é um modelo oculto que está gratuito na opencode por tempo limitado. A equipe está usando esse tempo para coletar feedback e melhorar o modelo.
|
||||
|
||||
<a href={email}>Entre em contato conosco</a> se você tiver alguma dúvida.
|
||||
|
||||
@@ -233,4 +233,4 @@ Criamos o OpenCode Zen para:
|
||||
1. **Benchmark** os melhores modelos/provedores para agentes de codificação.
|
||||
2. Ter acesso às opções de **mais alta qualidade** e não degradar o desempenho ou redirecionar para provedores mais baratos.
|
||||
3. Repassar quaisquer **reduções de preço** vendendo ao custo; assim, a única margem é para cobrir nossas taxas de processamento.
|
||||
4. Não ter **vinculação** permitindo que você o use com qualquer outro agente de codificação. E sempre permitir que você use qualquer outro provedor com a OpenCode também.
|
||||
4. Não ter **vinculação** permitindo que você o use com qualquer outro agente de codificação. E sempre permitir que você use qualquer outro provedor com a opencode também.
|
||||
|
||||
Reference in New Issue
Block a user