|
| 1 | +<p align="center"> |
| 2 | + <a href="https://opencode.ai"> |
| 3 | + <picture> |
| 4 | + <source srcset="packages/console/app/src/asset/logo-ornate-dark.svg" media="(prefers-color-scheme: dark)"> |
| 5 | + <source srcset="packages/console/app/src/asset/logo-ornate-light.svg" media="(prefers-color-scheme: light)"> |
| 6 | + <img src="packages/console/app/src/asset/logo-ornate-light.svg" alt="Logo do OpenCode"> |
| 7 | + </picture> |
| 8 | + </a> |
| 9 | +</p> |
| 10 | +<p align="center">O agente de programação com IA de código aberto.</p> |
| 11 | +<p align="center"> |
| 12 | + <a href="https://opencode.ai/discord"><img alt="Discord" src="https://img.shields.io/discord/1391832426048651334?style=flat-square&label=discord" /></a> |
| 13 | + <a href="https://www.npmjs.com/package/opencode-ai"><img alt="npm" src="https://img.shields.io/npm/v/opencode-ai?style=flat-square" /></a> |
| 14 | + <a href="https://github.com/anomalyco/opencode/actions/workflows/publish.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/anomalyco/opencode/publish.yml?style=flat-square&branch=dev" /></a> |
| 15 | +</p> |
| 16 | + |
| 17 | +<p align="center"> |
| 18 | + <a href="README.md">English</a> | |
| 19 | + <a href="README.zh.md">Chinese (Simplified)</a> | |
| 20 | + <a href="README.zht.md">Chinese (Traditional)</a> | |
| 21 | + <a href="README.ko.md">Korean</a> | |
| 22 | + <a href="README.de.md">German</a> | |
| 23 | + <a href="README.es.md">Spanish</a> | |
| 24 | + <a href="README.fr.md">French</a> | |
| 25 | + <a href="README.da.md">Danish</a> | |
| 26 | + <a href="README.ja.md">Japanese</a> | |
| 27 | + <a href="README.pl.md">Polish</a> | |
| 28 | + <a href="README.ru.md">Russian</a> | |
| 29 | + <a href="README.ar.md">Arabic</a> | |
| 30 | + <a href="README.no.md">Norwegian</a> | |
| 31 | + <a href="README.br.md">Portuguese (Brazil)</a> |
| 32 | +</p> |
| 33 | + |
| 34 | +[](https://opencode.ai) |
| 35 | + |
| 36 | +--- |
| 37 | + |
| 38 | +### Instalação |
| 39 | + |
| 40 | +```bash |
| 41 | +# YOLO |
| 42 | +curl -fsSL https://opencode.ai/install | bash |
| 43 | + |
| 44 | +# Gerenciadores de pacotes |
| 45 | +npm i -g opencode-ai@latest # ou bun/pnpm/yarn |
| 46 | +scoop install opencode # Windows |
| 47 | +choco install opencode # Windows |
| 48 | +brew install anomalyco/tap/opencode # macOS e Linux (recomendado, sempre atualizado) |
| 49 | +brew install opencode # macOS e Linux (fórmula oficial do brew, atualiza menos) |
| 50 | +paru -S opencode-bin # Arch Linux |
| 51 | +mise use -g opencode # qualquer sistema |
| 52 | +nix run nixpkgs#opencode # ou github:anomalyco/opencode para a branch dev mais recente |
| 53 | +``` |
| 54 | + |
| 55 | +> [!TIP] |
| 56 | +> Remova versões anteriores a 0.1.x antes de instalar. |
| 57 | +
|
| 58 | +### App desktop (BETA) |
| 59 | + |
| 60 | +O OpenCode também está disponível como aplicativo desktop. Baixe diretamente pela [página de releases](https://github.com/anomalyco/opencode/releases) ou em [opencode.ai/download](https://opencode.ai/download). |
| 61 | + |
| 62 | +| Plataforma | Download | |
| 63 | +| --------------------- | ------------------------------------- | |
| 64 | +| macOS (Apple Silicon) | `opencode-desktop-darwin-aarch64.dmg` | |
| 65 | +| macOS (Intel) | `opencode-desktop-darwin-x64.dmg` | |
| 66 | +| Windows | `opencode-desktop-windows-x64.exe` | |
| 67 | +| Linux | `.deb`, `.rpm` ou AppImage | |
| 68 | + |
| 69 | +```bash |
| 70 | +# macOS (Homebrew) |
| 71 | +brew install --cask opencode-desktop |
| 72 | +# Windows (Scoop) |
| 73 | +scoop bucket add extras; scoop install extras/opencode-desktop |
| 74 | +``` |
| 75 | + |
| 76 | +#### Diretório de instalação |
| 77 | + |
| 78 | +O script de instalação respeita a seguinte ordem de prioridade para o caminho de instalação: |
| 79 | + |
| 80 | +1. `$OPENCODE_INSTALL_DIR` - Diretório de instalação personalizado |
| 81 | +2. `$XDG_BIN_DIR` - Caminho compatível com a especificação XDG Base Directory |
| 82 | +3. `$HOME/bin` - Diretório binário padrão do usuário (se existir ou puder ser criado) |
| 83 | +4. `$HOME/.opencode/bin` - Fallback padrão |
| 84 | + |
| 85 | +```bash |
| 86 | +# Exemplos |
| 87 | +OPENCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://opencode.ai/install | bash |
| 88 | +XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://opencode.ai/install | bash |
| 89 | +``` |
| 90 | + |
| 91 | +### Agents |
| 92 | + |
| 93 | +O OpenCode inclui dois agents integrados, que você pode alternar com a tecla `Tab`. |
| 94 | + |
| 95 | +- **build** - Padrão, agent com acesso total para trabalho de desenvolvimento |
| 96 | +- **plan** - Agent somente leitura para análise e exploração de código |
| 97 | + - Nega edições de arquivos por padrão |
| 98 | + - Pede permissão antes de executar comandos bash |
| 99 | + - Ideal para explorar codebases desconhecidas ou planejar mudanças |
| 100 | + |
| 101 | +Também há um subagent **general** para buscas complexas e tarefas em várias etapas. |
| 102 | +Ele é usado internamente e pode ser invocado com `@general` nas mensagens. |
| 103 | + |
| 104 | +Saiba mais sobre [agents](https://opencode.ai/docs/agents). |
| 105 | + |
| 106 | +### Documentação |
| 107 | + |
| 108 | +Para mais informações sobre como configurar o OpenCode, [**veja nossa documentação**](https://opencode.ai/docs). |
| 109 | + |
| 110 | +### Contribuir |
| 111 | + |
| 112 | +Se você tem interesse em contribuir com o OpenCode, leia os [contributing docs](./CONTRIBUTING.md) antes de enviar um pull request. |
| 113 | + |
| 114 | +### Construindo com OpenCode |
| 115 | + |
| 116 | +Se você estiver trabalhando em um projeto relacionado ao OpenCode e estiver usando "opencode" como parte do nome (por exemplo, "opencode-dashboard" ou "opencode-mobile"), adicione uma nota no README para deixar claro que não foi construído pela equipe do OpenCode e não é afiliado a nós de nenhuma forma. |
| 117 | + |
| 118 | +### FAQ |
| 119 | + |
| 120 | +#### Como isso é diferente do Claude Code? |
| 121 | + |
| 122 | +É muito parecido com o Claude Code em termos de capacidade. Aqui estão as principais diferenças: |
| 123 | + |
| 124 | +- 100% open source |
| 125 | +- Não está acoplado a nenhum provedor. Embora recomendemos os modelos que oferecemos pelo [OpenCode Zen](https://opencode.ai/zen); o OpenCode pode ser usado com Claude, OpenAI, Google ou até modelos locais. À medida que os modelos evoluem, as diferenças diminuem e os preços caem, então ser provider-agnostic é importante. |
| 126 | +- Suporte a LSP pronto para uso |
| 127 | +- Foco em TUI. O OpenCode é construído por usuários de neovim e pelos criadores do [terminal.shop](https://terminal.shop); vamos levar ao limite o que é possível no terminal. |
| 128 | +- Arquitetura cliente/servidor. Isso, por exemplo, permite executar o OpenCode no seu computador enquanto você o controla remotamente por um aplicativo mobile. Isso significa que o frontend TUI é apenas um dos possíveis clientes. |
| 129 | + |
| 130 | +--- |
| 131 | + |
| 132 | +**Junte-se à nossa comunidade** [Discord](https://discord.gg/opencode) | [X.com](https://x.com/opencode) |
0 commit comments