Your privacy choices

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

Tutorial de configuração do OpenCode

Instalação e troca de modelos no OpenCode, tanto no terminal quanto no aplicativo para desktop.

Quando usar: o OpenCode é uma ferramenta de programação com IA e código aberto que funciona no terminal e no desktop. Este guia segue a sequência “instalar o OpenCode → configurar um modelo do Token Guishu → trocar o modelo no terminal/desktop → verificar”.

ItemValor recomendadoObservação
Base URLhttps://api.llm-token.cn/v1Prefira o caminho raiz com /v1; remova-o se ocorrer um erro.
API Keysk-xxxxxxxxInforme sua Key completa do Token Guishu.
Model IDNome completo na lista de modelosDeve ser idêntico, caractere por caractere.

1. Instalar o OpenCode

Escolha um dos métodos abaixo. Após a instalação, confirme que opencode inicia no terminal.

Sistema / métodoComando
npm
npm install -g opencode-ai
macOS / Linux Homebrew
brew install anomalyco/tap/opencode
Script de instalação
curl -fsSL https://opencode.ai/install | bash

Para a versão desktop, recomendamos baixar o instalador no site oficial: https://opencode.ai/. O terminal e o aplicativo para desktop podem usar a mesma configuração de modelos.

2. Adicionar o provedor do Token Guishu com o CC Switch

Se você já usa o CC Switch, siga as capturas abaixo para adicionar um provedor personalizado.

  1. Abra o CC Switch e escolha a opção de adicionar um provedor personalizado.
  2. Informe um nome para o provedor, por exemplo, “Token Guishu”.
  3. Em Base URL, informe https://api.llm-token.cn/v1.
  4. Em API Key, informe sua Key completa.
  5. Em Model ID, informe o nome completo exibido na lista de modelos.

A imagem mostra a interface do CC Switch para OpenCode. A tela informa que ainda não há provedores e exibe os botões “Importar configuração atual” e “Adicionar provedor”. Uma seta vermelha aponta para o ícone “+” no canto superior direito, indicando onde adicionar um provedor. A captura corresponde ao ponto de entrada usado antes da etapa 4 de seleção do modelo personalizado.A imagem mostra a interface do CC Switch para OpenCode. A tela informa q…

A imagem mostra a tela de adição de um provedor no OpenCode. Setas vermelhas indicam os campos nome do provedor, API Key e Base URL. Na parte inferior, há também o botão “Adicionar modelo” para incluir o modelo desejado.A imagem mostra a tela de adição de um provedor no OpenCode. Setas verme…

3. Trocar o modelo no terminal

  1. Abra o terminal e execute opencode.
  2. No OpenCode, pressione Ctrl + P.
  3. Localize Switch Model e pressione Enter.
  4. Role até a lista de modelos personalizados e selecione o modelo configurado.
opencode

A imagem mostra a interface de terminal do OpenCode. O campo de entrada contém “Ask anything... 'Fix a TODO in the codebase'”, o modelo atual é “GPT-5.5 OpenAI”, a dica informa que há 33 temas integrados e o canto inferior direito mostra a versão “1.14.30”. Essa é a tela em que você pode iniciar a troca de modelo.A imagem mostra a interface de terminal do OpenCode. O campo de entrada…

Ctrl + P

A imagem mostra o menu de comandos no terminal do OpenCode. O comando “Switch model” está destacado em laranja e exibe o atalho “ctrl+x m”.A imagem mostra o menu de comandos no terminal do OpenCode. O comando “S…

A imagem mostra a tela “Select model” do OpenCode. Além dos modelos integrados, há uma seção “custom”; o modelo personalizado “gpt-5.5” está selecionado em laranja. Na parte inferior aparecem atalhos como Connect provider e Favorite.A imagem mostra a tela “Select model” do OpenCode. Além dos modelos inte…

4. Usar no desktop

Abra o OpenCode para desktop, localize na seleção de modelos aquele que foi configurado no CC Switch e selecione-o para começar.

A imagem mostra a interface escura do OpenCode para desktop. À esquerda há a área de criação, com a opção “Big Pickle” destacada por uma seta vermelha; à direita aparecem opções relacionadas à criação de um repositório Git. A imagem indica uma entrada importante na interface desktop.A imagem mostra a interface escura do OpenCode para desktop. À esquerda…

A imagem mostra o menu de modelos do OpenCode para desktop. Entre opções como GPT-4 nano e GPT-4.5, uma seta vermelha aponta para “gpt-5.5”. Uma instrução central indica onde adicionar um modelo de linguagem personalizado.A imagem mostra o menu de modelos do OpenCode para desktop. Entre opções…

5. Verificação e problemas comuns

SituaçãoSolução
opencode não iniciaReabra o terminal e confirme que o caminho de instalação do npm / brew está no PATH.
O modelo personalizado não apareceConfirme que o CC Switch salvou a configuração e reinicie o OpenCode.
Falha na solicitaçãoVerifique a Base URL, a API Key e o ID do modelo; teste primeiro https://api.llm-token.cn/v1.
Resposta lentaTeste um modelo de resposta rápida, como claude-sonnet-4-6 ou MiniMax-M3-highspeed.

Tutorial de configuração do WorkBuddy

Os três dados para conectar um modelo personalizado: Base URL, API Key e ID do modelo.

Tutorial de configuração do VS Code

Use o Token Guishu no VS Code + Cline por meio de OpenAI Compatible.

Seções desta página

1. Instalar o OpenCode2. Adicionar o provedor do Token Guishu com o CC Switch3. Trocar o modelo no terminal4. Usar no desktop5. Verificação e problemas comuns