acp.mdx 3.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156
  1. ---
  2. title: ACP Soporte
  3. description: Utilice OpenCode en cualquier editor compatible con ACP.
  4. ---
  5. OpenCode admite el [Protocolo de cliente de agente](https://agentclientprotocol.com) o (ACP), lo que le permite usarlo directamente en editores e IDE compatibles.
  6. :::tip
  7. Para obtener una lista de editores y herramientas compatibles con ACP, consulte el [informe de progreso de ACP](https://zed.dev/blog/acp-progress-report#available-now).
  8. :::
  9. ACP es un protocolo abierto que estandariza la comunicación entre editores de código y agentes de codificación de IA.
  10. ---
  11. ## Configurar
  12. Para usar OpenCode a través de ACP, configure su editor para ejecutar el comando `opencode acp`.
  13. El comando inicia OpenCode como un subproceso compatible con ACP que se comunica con su editor a través de JSON-RPC a través de stdio.
  14. A continuación se muestran ejemplos de editores populares que admiten ACP.
  15. ---
  16. ### Zed
  17. Agregue a su configuración [Zed](https://zed.dev) (`~/.config/zed/settings.json`):
  18. ```json title="~/.config/zed/settings.json"
  19. {
  20. "agent_servers": {
  21. "OpenCode": {
  22. "command": "opencode",
  23. "args": ["acp"]
  24. }
  25. }
  26. }
  27. ```
  28. Para abrirlo, use la acción `agent: new thread` en la **Paleta de comandos**.
  29. También puedes vincular un atajo de teclado editando tu `keymap.json`:
  30. ```json title="keymap.json"
  31. [
  32. {
  33. "bindings": {
  34. "cmd-alt-o": [
  35. "agent::NewExternalAgentThread",
  36. {
  37. "agent": {
  38. "custom": {
  39. "name": "OpenCode",
  40. "command": {
  41. "command": "opencode",
  42. "args": ["acp"]
  43. }
  44. }
  45. }
  46. }
  47. ]
  48. }
  49. }
  50. ]
  51. ```
  52. ---
  53. ### IDE de JetBrains
  54. Agregue a su [JetBrains IDE](https://www.jetbrains.com/) acp.json de acuerdo con la [documentación](https://www.jetbrains.com/help/ai-assistant/acp.html):
  55. ```json title="acp.json"
  56. {
  57. "agent_servers": {
  58. "OpenCode": {
  59. "command": "/absolute/path/bin/opencode",
  60. "args": ["acp"]
  61. }
  62. }
  63. }
  64. ```
  65. Para abrirlo, use el nuevo agente 'OpenCode' en el selector de agentes de AI Chat.
  66. ---
  67. ### Avante.nvim
  68. Agregue a su configuración [Avante.nvim](https://github.com/yetone/avante.nvim):
  69. ```lua
  70. {
  71. acp_providers = {
  72. ["opencode"] = {
  73. command = "opencode",
  74. args = { "acp" }
  75. }
  76. }
  77. }
  78. ```
  79. Si necesita pasar variables de entorno:
  80. ```lua {6-8}
  81. {
  82. acp_providers = {
  83. ["opencode"] = {
  84. command = "opencode",
  85. args = { "acp" },
  86. env = {
  87. OPENCODE_API_KEY = os.getenv("OPENCODE_API_KEY")
  88. }
  89. }
  90. }
  91. }
  92. ```
  93. ---
  94. ### CódigoCompanion.nvim
  95. Para usar OpenCode como agente ACP en [CodeCompanion.nvim](https://github.com/olimorris/codecompanion.nvim), agregue lo siguiente a su configuración de Neovim:
  96. ```lua
  97. require("codecompanion").setup({
  98. interactions = {
  99. chat = {
  100. adapter = {
  101. name = "opencode",
  102. model = "claude-sonnet-4",
  103. },
  104. },
  105. },
  106. })
  107. ```
  108. Esta configuración configura CodeCompanion para usar OpenCode como agente ACP para el chat.
  109. Si necesita pasar variables de entorno (como `OPENCODE_API_KEY`), consulte [Configuración de adaptadores: variables de entorno](https://codecompanion.olimorris.dev/getting-started#setting-an-api-key) en la documentación de CodeCompanion.nvim para obtener detalles completos.
  110. ## Apoyo
  111. OpenCode funciona igual a través de ACP que en la terminal. Todas las funciones son compatibles:
  112. :::note
  113. Algunos comandos de barra integrados como `/undo` y `/redo` no son compatibles actualmente.
  114. :::
  115. - Herramientas integradas (operaciones de archivos, comandos de terminal, etc.)
  116. - Herramientas personalizadas y comandos de barra
  117. - Servidores MCP configurados en su configuración OpenCode
  118. - Reglas específicas del proyecto de `AGENTS.md`
  119. - Formateadores y linters personalizados
  120. - Sistema de agentes y permisos.