Todos os produtos
Search
Central de documentação

Qoder CN Series:Exceções na execução do terminal

Última atualização: Jun 29, 2026

Introdução

O ambiente de desenvolvimento e as configurações podem influenciar a execução de comandos no terminal. O VS Code e as IDEs JetBrains apresentam limitações e problemas de compatibilidade com terminais em diferentes sistemas operacionais. Isso pode impedir a invocação de comandos ou a obtenção de resultados ao usar o modo Agent do Qoder CN.

VS Code

Métodos comuns de solução de problemas

O plugin Qoder CN no VS Code depende da API de integração de shell do VS Code para executar comandos no terminal e ler as saídas. Esse recurso foi introduzido na versão 1.93 do VS Code e atualmente é compatível apenas com os seguintes shells:

Verifique se a sua versão do VS Code é superior a 1,93 e se o terminal padrão é um dos listados abaixo:

  • Linux/macOS: bash, fish, pwsh, zsh

  • Windows: Git Bash, pwsh

Em caso de exceções na execução do terminal, aplique os seguintes métodos:

Método 1: Atualize o VS Code

Confirme se a versão do VS Code é 1,93 ou superior:

  1. Abra o VS Code.

  2. Pressione Cmd + Shift + P (Mac) ou Ctrl + Shift + P (Windows/Linux).

  3. Digite Code: Check for Updates e selecione a opção correspondente.

  4. Reinicie o VS Code após concluir a atualização.

Método 2: Configure um shell compatível no VS Code

  1. Abra o VS Code.

  2. Pressione Cmd + Shift + P (Mac) ou Ctrl + Shift + P (Windows/Linux).

  3. Digite Terminal: Select Default Profile e selecione a opção.

  4. Escolha um shell compatível:

    • Linux/macOS: bash, fish, pwsh, zsh

    • Windows: Git Bash, pwsh

  5. Feche o VS Code e abra-o novamente.

Método 3: Instale manualmente a integração de shell

Se os problemas persistirem após seguir as etapas anteriores, instale manualmente a integração de shell.

Exemplos:

  • zsh:

    1. Adicione a linha abaixo ao arquivo ~/.zshrc:

      [[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path zsh)"
    2. Salve o arquivo.

    3. Feche o VS Code e abra-o novamente.

  • Bash (~/.bashrc):

[[ "$TERM_PROGRAM" == "vscode" ]] && . "$(code --locate-shell-integration-path bash)"
  • powershell ($Profile):

if ($env:TERM_PROGRAM -eq "vscode") { . "$(code --locate-shell-integration-path pwsh)" }
  • fish (~/.config/fish/config.fish):

string match -q "$TERM_PROGRAM" "vscode"; and . (code --locate-shell-integration-path fish)

Ainda está com problemas?

Caso não obtenha saída do terminal mesmo após tentar os métodos acima, clique em Stop Terminal para fechar a janela. Execute o comando novamente em seguida. Essa ação redefinirá a conexão do terminal e deverá corrigir o problema.

Windows

Git Bash

O Git Bash oferece uma experiência de linha de comando semelhante à do Unix no Windows. Para utilizá-lo:

  1. Baixe e execute o instalador do Git for Windows disponível em https://git-scm.com/downloads/win.

  2. Feche o VS Code e abra-o novamente.

  3. Pressione Ctrl + Shift + P para abrir a paleta de comandos.

  4. Digite Terminal: Select Default Profile e selecione a opção.

  5. Escolha Git Bash.

powershell

Certifique-se de que o powershell esteja atualizado para uma versão posterior à 7.

  • Verifique a versão atual executando: $PSVersionTable.PSVersion

  • Se a versão for inferior a 7, atualize o powershell.

Por padrão, o powershell restringe a execução de scripts por motivos de segurança. Para alterar essa configuração:

  1. Abra o powershell como administrador: pressione Win + X e selecione Windows PowerShell (Administrator) ou Windows Terminal (Administrator).

  2. Verifique a política de execução atual com o comando:

    Get-ExecutionPolicy
    • Se a saída já for RemoteSigned, Unrestricted ou Bypass, talvez não seja necessário alterar a política. Essas configurações permitem o funcionamento correto da integração de shell.

    • Caso a saída seja Restricted ou AllSigned, altere a política para ative a integração de shell.

  3. Altere a política de execução com o seguinte comando:

    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

    Isso defina a política RemoteSigned apenas para o usuário atual, sendo mais seguro do que uma alteração em todo o sistema.

  4. Confirme a alteração: digite Y no prompt e pressione Enter.

  5. Valide a mudança: execute Get-ExecutionPolicy novamente para confirmar a nova configuração.

  6. Reinicie o VS Code e teste a integração de shell novamente.

WSL

Ao usar o WSL, adicione . "$(code --locate-shell-integration-path bash)" ao arquivo ~/.bashrc, reinicie o terminal e tente novamente.

Outras exceções

Exceções na saída do terminal

Saídas anormais com retângulos, linhas, sequências de escape ou caracteres de controle geralmente indicam conflitos com ferramentas de personalização do terminal. Causas comuns incluem temas do zsh como Powerlevel10k, Oh My Zsh ou fish shell.

Procedimento de solução:

  1. Desative temporariamente essas ferramentas no arquivo de configuração do shell (por exemplo, ~/.zshrc para zsh).

  2. Se o problema for resolvido, reative os recursos gradualmente para identificar a ferramenta conflitante.

Por exemplo, se usar o Powerlevel10k no zsh, desative-o comentando as linhas relevantes no arquivo ~/.zshrc:

# Comment out the source line for Powerlevel10k
# source /path/to/powerlevel10k/powerlevel10k.zsh-theme

Caso o problema seja corrigido ao desativar esses temas, busque uma configuração alternativa de integração de shell para o VS Code.

IDEs JetBrains

Atualmente, o plugin Qoder CN não é compatível com o novo terminal (Beta), disponível na nova interface das IDEs a partir da versão 2024.1.

image.png

Para desativar o novo terminal:

  • Método 1: Em Settings ou Preferences, navegue até Tools - Terminal - Enable New Terminal e desmarque a opção do novo terminal.

  • Método 2: No título da janela do Terminal, clique em image.svg e desmarque Enable New Terminal.

Fale conosco

Fale conosco caso não consiga resolver o problema após aplicar as soluções deste documento.