@neurocode-ai/web 1.18.8

package/src/content/docs/pt-br/models.mdx

@@ -0,0 +1,222 @@
+---
+title: Modelos
+description: Configurando um provedor e modelo LLM.
+---
+
+O 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.
+
+Saiba mais sobre [provedores](/docs/providers).
+
+---
+
+## Selecionando um modelo
+
+Depois de configurar seu provedor, você pode selecionar o modelo que deseja digitando:
+
+```bash frame="none"
+/models
+```
+
+---
+
+## Modelos recomendados
+
+Existem muitos modelos disponíveis, com novos modelos sendo lançados toda semana.
+
+:::tip
+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):
+
+- GPT 5.2
+- GPT 5.1 Codex
+- Claude Opus 4.5
+- Claude Sonnet 4.5
+- Minimax M2.1
+- Gemini 3 Pro
+
+---
+
+## Definindo um padrão
+
+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}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "lmstudio/google/gemma-3n-e4b"
+}
+```
+
+Aqui, o ID completo é `provider_id/model_id`. Por exemplo, se você estiver usando [OpenCode Zen](/docs/zen), você usaria `opencode/gpt-5.1-codex` para GPT 5.1 Codex.
+
+Se você configurou um [provedor personalizado](/docs/providers#custom), o `provider_id` é a chave da parte `provider` da sua configuração, e o `model_id` é a chave de `provider.models`.
+
+---
+
+## Configurando modelos
+
+Você pode configurar globalmente as opções de um modelo através da configuração.
+
+```jsonc title="opencode.jsonc" {7-12,19-24}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "options": {
+            "reasoningEffort": "high",
+            "textVerbosity": "low",
+            "reasoningSummary": "auto",
+            "include": ["reasoning.encrypted_content"],
+          },
+        },
+      },
+    },
+    "anthropic": {
+      "models": {
+        "claude-sonnet-4-5-20250929": {
+          "options": {
+            "thinking": {
+              "type": "enabled",
+              "budgetTokens": 16000,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+Aqui estamos configurando as configurações globais para dois modelos integrados: `gpt-5` quando acessado via o provedor `openai`, e `claude-sonnet-4-20250514` quando acessado via o provedor `anthropic`.
+Os nomes dos provedores e modelos integrados podem ser encontrados em [Models.dev](https://models.dev).
+
+Você também pode configurar essas opções para quaisquer agentes que estiver usando. A configuração do agente substitui quaisquer opções globais aqui. [Saiba mais](/docs/agents/#additional).
+
+Você também pode definir variantes personalizadas que estendem as integradas. As variantes permitem que você configure diferentes configurações para o mesmo modelo sem criar entradas duplicadas:
+
+```jsonc title="opencode.jsonc" {6-21}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "opencode": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "high": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+            "low": {
+              "reasoningEffort": "low",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+---
+
+## Variantes
+
+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:
+
+**Anthropic**:
+
+- `high` - Orçamento de pensamento alto (padrão)
+- `max` - Orçamento de pensamento máximo
+
+**OpenAI**:
+
+Varia por modelo, mas aproximadamente:
+
+- `none` - Sem raciocínio
+- `minimal` - Esforço de raciocínio mínimo
+- `low` - Baixo esforço de raciocínio
+- `medium` - Esforço de raciocínio médio
+- `high` - Alto esforço de raciocínio
+- `xhigh` - Esforço de raciocínio extra alto
+
+**Google**:
+
+- `low` - Orçamento de esforço/token mais baixo
+- `high` - Orçamento de esforço/token mais alto
+
+:::tip
+Esta lista não é abrangente. Muitos outros provedores também têm padrões integrados.
+:::
+
+### Variantes personalizadas
+
+Você pode substituir variantes existentes ou adicionar as suas:
+
+```jsonc title="opencode.jsonc" {7-18}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "thinking": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+            },
+            "fast": {
+              "disabled": true,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+### Ciclo de variantes
+
+Use a tecla de atalho `variant_cycle` para alternar rapidamente entre variantes. [Saiba mais](/docs/keybinds).
+
+---
+
+## Carregando modelos
+
+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.
+
+   ```json title="opencode.json"
+   {
+     "$schema": "https://opencode.ai/config.json",
+     "model": "anthropic/claude-sonnet-4-20250514"
+   }
+   ```
+
+   O formato aqui é `provider/model`.
+
+3. O último modelo usado.
+
+4. O primeiro modelo usando uma prioridade interna.

package/src/content/docs/pt-br/network.mdx

@@ -0,0 +1,57 @@
+---
+title: Rede
+description: Configure proxies e certificados personalizados.
+---
+
+O opencode suporta variáveis de ambiente de proxy padrão e certificados personalizados para ambientes de rede corporativa.
+
+---
+
+## Proxy
+
+O opencode respeita variáveis de ambiente de proxy padrão.
+
+```bash
+# HTTPS proxy (recommended)
+export HTTPS_PROXY=https://proxy.example.com:8080
+
+# HTTP proxy (if HTTPS not available)
+export HTTP_PROXY=http://proxy.example.com:8080
+
+# Bypass proxy for local server (required)
+export NO_PROXY=localhost,127.0.0.1
+```
+
+:::caution
+O TUI se comunica com um servidor HTTP local. Você deve ignorar o proxy para essa conexão para evitar loops de roteamento.
+:::
+
+Você pode configurar a porta e o nome do host do servidor usando [flags da CLI](/docs/cli#run).
+
+---
+
+### Autenticação
+
+Se o seu proxy requer autenticação básica, inclua as credenciais na URL.
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+:::caution
+Evite codificar senhas. Use variáveis de ambiente ou armazenamento seguro de credenciais.
+:::
+
+Para proxies que requerem autenticação avançada como NTLM ou Kerberos, considere usar um LLM Gateway que suporte seu método de autenticação.
+
+---
+
+## Certificados personalizados
+
+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
+```
+
+Isso funciona tanto para conexões de proxy quanto para acesso direto à API.

package/src/content/docs/pt-br/permissions.mdx

@@ -0,0 +1,235 @@
+---
+title: Permissões
+description: Controle quais ações requerem aprovação para serem executadas.
+---
+
+O 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.
+
+---
+
+## Ações
+
+Cada regra de permissão se resolve em uma das seguintes opções:
+
+- `"allow"` — executar sem aprovação
+- `"ask"` — solicitar aprovação
+- `"deny"` — bloquear a ação
+
+---
+
+## Configuração
+
+Você pode definir permissões globalmente (com `*`), e substituir ferramentas específicas.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "*": "ask",
+    "bash": "allow",
+    "edit": "deny"
+  }
+}
+```
+
+Você também pode definir todas as permissões de uma vez:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": "allow"
+}
+```
+
+---
+
+## Regras Granulares (Sintaxe de Objeto)
+
+Para a maioria das permissões, você pode usar um objeto para aplicar diferentes ações com base na entrada da ferramenta.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "npm *": "allow",
+      "rm *": "deny",
+      "grep *": "allow"
+    },
+    "edit": {
+      "*": "deny",
+      "packages/web/src/content/docs/*.mdx": "allow"
+    }
+  }
+}
+```
+
+As regras são avaliadas por correspondência de padrão, com a **última regra correspondente vencendo**. Um padrão comum é colocar a regra de captura `"*"` primeiro, e regras mais específicas depois.
+
+### Coringas
+
+Os padrões de permissão usam correspondência simples de coringas:
+
+- `*` corresponde a zero ou mais de qualquer caractere
+- `?` corresponde exatamente a um caractere
+- Todos os outros caracteres correspondem literalmente
+
+### Expansão do Diretório Home
+
+Você pode usar `~` ou `$HOME` no início de um padrão para referenciar seu diretório home. Isso é particularmente útil para regras de [`external_directory`](#external-directories).
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
+### 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`, `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`.
+
+Por exemplo, isso permite acesso a tudo sob `~/projects/personal/`:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    }
+  }
+}
+```
+
+Qualquer diretório permitido aqui herda os mesmos padrões do espaço de trabalho atual. Como [`read` padrão é `allow`](#defaults), leituras também são permitidas para entradas sob `external_directory`, a menos que sejam substituídas. Adicione regras explícitas quando uma ferramenta deve ser restrita nesses caminhos, como bloquear edições enquanto mantém leituras:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    },
+    "edit": {
+      "~/projects/personal/**": "deny"
+    }
+  }
+}
+```
+
+Mantenha a lista focada em caminhos confiáveis e adicione regras adicionais de permissão ou negação conforme necessário para outras ferramentas (por exemplo, `bash`).
+
+---
+
+## Permissões Disponíveis
+
+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`)
+- `glob` — globbing de arquivos (corresponde ao padrão glob)
+- `grep` — busca de conteúdo (corresponde ao padrão regex)
+- `bash` — execução de comandos de shell (corresponde a comandos analisados como `git status --porcelain`)
+- `task` — lançamento de subagentes (corresponde ao tipo de subagente)
+- `skill` — carregamento de uma habilidade (corresponde ao nome da habilidade)
+- `lsp` — execução de consultas LSP (atualmente não granular)
+- `webfetch` — busca de uma URL (corresponde à URL)
+- `websearch` — busca na web (corresponde à consulta)
+- `external_directory` — acionado quando uma ferramenta toca em caminhos fora do diretório de trabalho do projeto
+- `doom_loop` — acionado quando a mesma chamada de ferramenta se repete 3 vezes com entrada idêntica
+
+---
+
+## Padrões
+
+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"`.
+- `read` é `"allow"`, mas arquivos `.env` são negados por padrão:
+
+```json title="opencode.json"
+{
+  "permission": {
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    }
+  }
+}
+```
+
+---
+
+## O que “Ask” Faz
+
+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)
+- `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*`).
+
+---
+
+## Agentes
+
+Você pode substituir permissões por agente. As permissões do agente são mescladas com a configuração global, e as regras do agente têm precedência. [Saiba mais](/docs/agents#permissions) sobre permissões de agentes.
+
+:::note
+Consulte a seção [Regras Granulares (Sintaxe de Objeto)](#granular-rules-object-syntax) acima para exemplos mais detalhados de correspondência de padrões.
+:::
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "grep *": "allow"
+    }
+  },
+  "agent": {
+    "build": {
+      "permission": {
+        "bash": {
+          "*": "ask",
+          "git *": "allow",
+          "git commit *": "ask",
+          "git push *": "deny",
+          "grep *": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+Você também pode configurar permissões de agentes em Markdown:
+
+```markdown title="~/.config/opencode/agents/review.md"
+---
+description: Code review without edits
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---
+
+Only analyze code and suggest changes.
+```
+
+:::tip
+Use correspondência de padrões para comandos com argumentos. `"grep *"` permite `grep pattern file.txt`, enquanto `"grep"` sozinho o bloquearia. Comandos como `git status` funcionam para o comportamento padrão, mas requerem permissão explícita (como `"git status *"`) quando argumentos são passados.
+:::