Tutorial de configuração do VS Code
Use o Token Guishu no VS Code + Cline por meio de OpenAI Compatible.
Objetivo: instalar o Cline no VS Code e conectar o Token Guishu por meio de OpenAI Compatible. Após a configuração, você poderá usar a IA diretamente no VS Code para ler e alterar código, escrever comandos e explicar erros.
| Item | Valor | Observação |
|---|---|---|
| API Provider | OpenAI Compatible | O Cline oferece suporte oficial a provedores compatíveis com OpenAI. |
| Base URL | https://api.llm-token.cn/v1 | Não informe o caminho completo /chat/completions. |
| API Key | sk-xxxxxxxx | Cole sua Key completa. |
| Model ID | Copie o nome completo na lista de modelos | Quando o modelo não é encontrado, geralmente há um erro neste campo. |
1. Preparação
- Instale o VS Code: https://code.visualstudio.com/
- Instale o Git: https://git-scm.com/downloads
- No Windows, recomendamos reiniciar o computador após instalar o Git para que as variáveis de ambiente entrem em vigor.
2. Instalar a extensão Cline
- Abra o VS Code e clique em Extensions na barra lateral.
- Pesquise Cline e clique em Install.
- Após a instalação, o ícone do Cline aparecerá na barra lateral.
- Se o ícone não aparecer, reinicie o VS Code.
A imagem mostra a pesquisa pela extensão Cline no VS Code. O ícone “Exte…
3. Abrir as configurações do Cline
Clique no ícone do Cline na barra lateral e abra as configurações no painel do Cline.
Esta captura mostra a etapa de configuração do Cline no VS Code. A tela…
A imagem mostra as configurações do plugin Cline no VS Code. “Act Mode”…
4. Informar a interface do Token Guishu
- API Provider: selecione OpenAI Compatible.
- Base URL: informe
https://api.llm-token.cn/v1. - API Key: cole sua Key iniciada por
sk-. - Model ID: informe o ID completo do modelo, por exemplo,
claude-sonnet-4-6. - Salve e crie uma nova tarefa para testar.
Se ocorrer um erro ao salvar: confirme que a Base URL não foi definida como https://api.llm-token.cn/v1/chat/completions. O Cline exige o caminho raiz da API, ou seja, /v1.
5. Testes e solução de problemas
| Situação | Solução |
|---|---|
| Não é possível informar a URL | Confirme que você selecionou OpenAI Compatible, e não o provedor oficial comum da OpenAI. |
| Model Not Found | O ID do modelo deve ser idêntico ao exibido na lista. |
| Falha de conexão | Verifique a Key, a Base URL e o proxy; em redes corporativas ou acadêmicas, teste um hotspot. |
| O ícone do Cline não aparece | Reinicie o VS Code; se ainda não aparecer, reinstale a extensão. |