Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Tutorial de configuración de OpenCode

Tutorial para instalar OpenCode y cambiar de modelo, tanto en la terminal como en la aplicación de escritorio.

Casos de uso: OpenCode es una herramienta de programación con IA de código abierto que puede utilizarse desde la terminal o desde la aplicación de escritorio. Este artículo sigue el orden «instalar OpenCode → configurar un modelo de Guishu Token → cambiar de modelo en la terminal o la aplicación de escritorio → comprobar el funcionamiento».

Opción de configuraciónValor recomendadoDescripción
Base URLhttps://api.llm-token.cn/v1Utiliza primero la ruta raíz con /v1; si aparece un error, elimínala.
API Keysk-xxxxxxxxIntroduce tu Key completa de Guishu Token.
ID del modeloNombre completo del modelo en la lista de modelosDebe coincidir carácter por carácter.

I. Instalar OpenCode

Elige cualquiera de estos métodos de instalación. Cuando termine, comprueba que puedes iniciar la herramienta introduciendo opencode en la terminal.

Sistema / métodoComando
npm
npm install -g opencode-ai
macOS / Linux Homebrew
brew install anomalyco/tap/opencode
Script de instalación
curl -fsSL https://opencode.ai/install | bash

Para la versión de escritorio, se recomienda descargar el instalador desde el sitio web oficial: https://opencode.ai/. La línea de comandos y la aplicación de escritorio pueden utilizar el mismo conjunto de configuraciones de modelos.

II. Añadir el proveedor Guishu Token con CC Switch

Si ya utilizas CC Switch habitualmente, puedes añadir un proveedor personalizado siguiendo las capturas de pantalla.

  1. Abre CC Switch, localiza la opción correspondiente y selecciona la opción para añadir un proveedor personalizado.
  2. Introduce el nombre del proveedor, por ejemplo, «Guishu Token».
  3. En Base URL, introduce https://api.llm-token.cn/v1.
  4. En API Key, introduce tu Key completa.
  5. En ID del modelo, introduce el nombre completo que aparece en la lista de modelos.

La imagen muestra la interfaz de CC Switch en la terminal de OpenCode. En la parte superior aparecen el logotipo «CC Switch» y varios iconos. En el centro se muestra el mensaje «Todavía no se ha añadido ningún proveedor», junto con los botones «Importar configuración actual» y «Añadir proveedor». Una flecha roja señala el icono «+» de la esquina superior derecha. Esta imagen está relacionada con el paso «Cambiar de modelo en la terminal» y corresponde al paso 4, en el que se recorre la lista de modelos personalizados para elegir el modelo recién configurado; muestra claramente dónde añadir un proveedor desde la terminal.La imagen muestra la interfaz de CC Switch en la terminal de OpenCode. E…

La imagen muestra la pantalla para añadir un proveedor nuevo al cambiar de modelo en la terminal de OpenCode. Incluye varios campos, como el nombre del proveedor, la API Key y la Base URL, señalados con flechas rojas para indicar la información que debe introducirse. Corresponden a los datos «my - provider», API Key y Base URL mencionados en el paso «Añadir un proveedor nuevo». En la parte inferior aparece también el botón «Añadir modelo», que permite añadir el modelo que se desea utilizar. La imagen muestra claramente la pantalla de la terminal y los campos esenciales para añadir el proveedor.La imagen muestra la pantalla para añadir un proveedor nuevo al cambiar…

III. Cambiar de modelo en la terminal

  1. Abre una terminal y ejecuta opencode.
  2. Cuando estés en OpenCode, pulsa Ctrl + P.
  3. Busca Switch Model y pulsa Intro.
  4. Desplázate hasta la lista de modelos personalizados y elige el que acabas de configurar.
opencode

Esta es una captura de la interfaz de terminal de OpenCode. En la parte superior aparece la identidad visual de «OpenCode» y, dentro del cuadro de entrada, el texto «Ask anything... 'Fix a TODO in the codebase'». La pantalla indica claramente que el modelo seleccionado es «GPT-5.5 OpenAI» y también muestra consejos de uso, entre ellos «Tip:/themes or Ctrl+X T to switch between 33 built-in themes». En la esquina inferior derecha aparece la versión «1.14.30». Esta pantalla corresponde al proceso de cambio de modelo en la terminal y es la interfaz que ve el usuario después de entrar en OpenCode.Esta es una captura de la interfaz de terminal de OpenCode. En la parte…

Ctrl + P

La imagen muestra la interfaz de terminal de OpenCode, con el indicador de comandos y parte del contenido del código. Se abre un menú de comandos en el que «Switch model» aparece resaltado en naranja y, a la derecha, se indica el atajo «ctrl+x m». Esta imagen corresponde a la sección «Cambiar de modelo en la terminal» y muestra dónde encontrar «Switch Model» antes de pulsar Intro, para facilitar la comprensión del procedimiento.La imagen muestra la interfaz de terminal de OpenCode, con el indicador…

Esta imagen muestra la interfaz de terminal de OpenCode en la pantalla «Select model». La página contiene varios modelos integrados, además de la opción personalizada «custom» y el modelo personalizado «gpt-5.5», que aparece seleccionado y resaltado en naranja. En la parte inferior se muestran también atajos, como «Connect provider» con ctrl+a y «Favorite» con ctrl+f. La imagen corresponde al paso en el que se recorre la lista de modelos personalizados y se selecciona el modelo ya configurado.Esta imagen muestra la interfaz de terminal de OpenCode en la pantalla «…

IV. Usar la aplicación de escritorio

Abre la aplicación de escritorio de OpenCode, busca en el selector de modelos el modelo configurado en CC Switch y selecciónalo para empezar a utilizarlo.

Esta imagen muestra la interfaz de la aplicación de escritorio de OpenCode, con un diseño general oscuro. A la izquierda aparece contenido relacionado con «Construye cualquier cosa» y una flecha roja resalta claramente la opción «Big Pickle». A la derecha se muestran opciones relacionadas con «Crear un repositorio Git». Esta imagen corresponde a la sección sobre el uso de la aplicación de escritorio y muestra la ubicación de una opción clave para facilitar la configuración.Esta imagen muestra la interfaz de la aplicación de escritorio de OpenCo…

Esta imagen muestra la interfaz de la aplicación de escritorio de OpenCode y sirve para explicar cómo añadir un modelo personalizado. El menú desplegable del selector de modelos está abierto a la izquierda y muestra opciones como GPT-4 nano y GPT-4.5; una flecha roja señala la opción «gpt-5.5». En el centro aparece un texto azul destacado que indica que a continuación se puede hacer clic en la zona correspondiente para añadir un modelo grande y que, al hacerlo, debe seleccionarse un modelo personalizado. Esta imagen está relacionada con el uso de la aplicación de escritorio y ayuda a completar el paso esencial de añadir un modelo personalizado.Esta imagen muestra la interfaz de la aplicación de escritorio de OpenCo…

V. Comprobación y problemas frecuentes

SituaciónSolución
opencode no se iniciaVuelve a abrir la terminal y comprueba que la ruta de instalación de npm / brew esté incluida en PATH.
La lista de modelos no contiene el modelo personalizadoComprueba que CC Switch haya guardado la configuración y reinicia OpenCode.
La solicitud fallaComprueba la Base URL, la API Key y el ID del modelo; prueba primero https://api.llm-token.cn/v1.
El modelo responde lentamentePrueba un modelo de respuesta rápida, como claude-sonnet-4-6 o MiniMax-M3-highspeed.

Tutorial de configuración de WorkBuddy

Los tres datos esenciales para conectar un modelo personalizado: Base URL, API Key e ID del modelo.

Tutorial de configuración de VS Code

Conecta el Token de Guishu mediante OpenAI Compatible en VS Code + Cline.

Secciones de esta página

I. Instalar OpenCodeII. Añadir el proveedor Guishu Token con CC SwitchIII. Cambiar de modelo en la terminalIV. Usar la aplicación de escritorioV. Comprobación y problemas frecuentes