| --- |
| title: Web |
| description: Usando OpenCode en su navegador. |
| --- |
|
|
| OpenCode puede ejecutarse como una aplicaci贸n web en su navegador, brindando la misma poderosa experiencia de codificaci贸n de IA sin necesidad de una terminal. |
|
|
|  |
|
|
| ## Empezar |
|
|
| Inicie la interfaz web ejecutando: |
|
|
| ```bash |
| opencode web |
| ``` |
|
|
| Esto inicia un servidor local en `127.0.0.1` con un puerto disponible aleatorio y abre autom谩ticamente OpenCode en su navegador predeterminado. |
|
|
| :::caution |
| Si no se establece `OPENCODE_SERVER_PASSWORD`, el servidor no ser谩 seguro. Esto est谩 bien para uso local, pero debe configurarse para acceso a la red. |
| ::: |
|
|
| :::tip[Windows Usuarios] |
| Para obtener la mejor experiencia, ejecute `opencode web` desde [WSL](/docs/windows-wsl) en lugar de PowerShell. Esto garantiza el acceso adecuado al sistema de archivos y la integraci贸n del terminal. |
| ::: |
|
|
| --- |
| |
| ## Configuraci贸n |
|
|
| Puede configurar el servidor web usando indicadores de l铆nea de comando o en su [archivo de configuraci贸n](/docs/config). |
|
|
| ### Puerto |
|
|
| De forma predeterminada, OpenCode elige un puerto disponible. Puede especificar un puerto: |
|
|
| ```bash |
| opencode web --port 4096 |
| ``` |
|
|
| ### Nombre de host |
|
|
| De forma predeterminada, el servidor se vincula a `127.0.0.1` (solo localhost). Para hacer que OpenCode sea accesible en su red: |
|
|
| ```bash |
| opencode web --hostname 0.0.0.0 |
| ``` |
|
|
| Al usar `0.0.0.0`, OpenCode mostrar谩 direcciones locales y de red: |
|
|
| ``` |
| Local access: http://localhost:4096 |
| Network access: http://192.168.1.100:4096 |
| ``` |
|
|
| ### Descubrimiento de mDNS |
|
|
| Habilite mDNS para que su servidor sea reconocible en la red local: |
|
|
| ```bash |
| opencode web --mdns |
| ``` |
|
|
| Esto establece autom谩ticamente el nombre de host en `0.0.0.0` y anuncia el servidor como `opencode.local`. |
|
|
| Puede personalizar el nombre de dominio mDNS para ejecutar varias instancias en la misma red: |
|
|
| ```bash |
| opencode web --mdns --mdns-domain myproject.local |
| ``` |
|
|
| ### CORS |
|
|
| Para permitir dominios adicionales para CORS (煤til para interfaces personalizadas): |
|
|
| ```bash |
| opencode web --cors https://example.com |
| ``` |
|
|
| ### Autenticaci贸n |
|
|
| Para proteger el acceso, establezca una contrase帽a utilizando la variable de entorno `OPENCODE_SERVER_PASSWORD`: |
|
|
| ```bash |
| OPENCODE_SERVER_PASSWORD=secret opencode web |
| ``` |
|
|
| El nombre de usuario predeterminado es `opencode` pero se puede cambiar con `OPENCODE_SERVER_USERNAME`. |
|
|
| --- |
| |
| ## Usar la interfaz web |
|
|
| Una vez iniciada, la interfaz web proporciona acceso a sus sesiones OpenCode. |
|
|
| ### Sesiones |
|
|
| Vea y administre sus sesiones desde la p谩gina de inicio. Puedes ver sesiones activas e iniciar otras nuevas. |
|
|
|  |
|
|
| ### Estado del servidor |
|
|
| Haga clic en "Ver servidores" para ver los servidores conectados y su estado. |
|
|
|  |
|
|
| --- |
| |
| ## Adjuntar una terminal |
|
|
| Puede conectar un terminal TUI a un servidor web en ejecuci贸n: |
|
|
| ```bash |
| # Start the web server |
| opencode web --port 4096 |
| |
| # In another terminal, attach the TUI |
| opencode attach http://localhost:4096 |
| ``` |
| |
| Esto le permite utilizar la interfaz web y el terminal simult谩neamente, compartiendo las mismas sesiones y estados. |
|
|
| --- |
| |
| ## Archivo de configuraci贸n |
|
|
| Tambi茅n puede configurar los ajustes del servidor en su archivo de configuraci贸n `opencode.json`: |
|
|
| ```json |
| { |
| "server": { |
| "port": 4096, |
| "hostname": "0.0.0.0", |
| "mdns": true, |
| "cors": ["https://example.com"] |
| } |
| } |
| ``` |
|
|
| Los indicadores de la l铆nea de comando tienen prioridad sobre la configuraci贸n del archivo de configuraci贸n. |
|
|
