Perguntas frequentes

Migrando da versão antiga

Se você está migrando da versão antiga, siga os passos abaixo — um único comando migra suas configurações, servidores MCP e histórico de sessões para a nova versão.

Novidades

• Adeus Python / uv: Reconstruído sobre Node.js — sem necessidade de ambiente Python, instalação mais simples
• Binário nativo, pronto para usar: Inicialização mais rápida e menor consumo de recursos
• Interface de terminal redesenhada: Experiência mais fluida e responsiva
• Migração completa de dados: Configurações, servidores MCP e histórico de sessões são transferidos sem complicações

Como migrar

Há duas formas de migrar.

Na primeira vez que você executa o kimi após instalar o kimi-code, ele verifica automaticamente se existem dados do kimi-cli em ~/.kimi/. Se encontrar algum, aparece um aviso de migração, e você pode optar por migrar agora, fazer isso depois ou não ser mais perguntado.

Você também pode executá-lo manualmente a qualquer momento:

Bash

Você pode escolher se quer migrar também as sessões de chat. Se ainda não precisar do histórico, escolha Config only (apenas configuração); caso contrário, escolha Config + N sessions (configuração + N sessões) para trazer tudo de uma só vez. Um resumo é exibido no final.

O que acontece durante a migração

O que é migrado: configuração (config.toml), configuração dos servidores MCP, histórico de entradas e as sessões de chat que você escolher migrar.

O que não é migrado: as credenciais de login OAuth e as autorizações dos serviços MCP não são copiadas, então você precisará executar o /login novamente e reautorizar os servidores MCP após a migração. Os plugins do kimi-cli também ficam de fora.

Após a migração, as sessões importadas do kimi-cli são marcadas com [imported] no seletor de sessões, para você distingui-las das novas.

Instalação e autenticação

Nenhum modelo disponível ao executar /login

Se você vir "No models available for the selected platform" (Nenhum modelo disponível para a plataforma selecionada) ao executar o /login, pode ser por estes motivos:

• Chave de API inválida ou expirada: Verifique se a chave de API que você inseriu está correta e ainda é válida.
• Problema de conexão de rede: Confirme se você consegue acessar o endereço do serviço de API (como api.kimi.com ou api.moonshot.cn).

Atenção à distinção entre plataformas

Os benefícios da assinatura do Kimi Code e a Plataforma aberta da Kimi têm Base URLs diferentes. Certifique-se de que a Base URL corresponda à API Key ao configurar.

A chave de API é inválida

Possíveis motivos para uma chave de API inválida:

• Chave inserida incorretamente: Verifique se há espaços extras ou caracteres faltando.
• Chave expirada ou revogada: Confirme o status da chave no console da plataforma.

Assinatura expirada ou créditos esgotados

Se você usa a plataforma Kimi Code, pode verificar seus créditos atuais e o status da assinatura pelo comando /usage. Se seus créditos estiverem esgotados ou sua assinatura tiver expirado, você precisa renovar ou fazer upgrade em Kimi Code.

Assinatura

Como solicito uma nota fiscal ou faço upgrade da minha assinatura?

Acesse a página de assinatura do Kimi e siga as instruções para enviar uma solicitação de nota fiscal ou fazer upgrade do seu plano.

Problemas de interação

Falha ao colar imagem

Ao colar uma imagem com Ctrl-V, se você vir "Current model does not support image input" (O modelo atual não suporta entrada de imagem), significa que o modelo em uso não suporta entrada de imagem.

Soluções:

• Mude para um modelo que suporte imagens: Use um modelo com a capacidade image_in.
• Verifique o conteúdo da área de transferência: Certifique-se de que ela realmente contém dados de imagem, e não o caminho de um arquivo de imagem.

Atualizações e upgrades

A primeira inicialização no macOS é lenta

O Gatekeeper do macOS realiza uma verificação de segurança na primeira vez que um novo programa é executado, deixando a inicialização mais lenta. Soluções:

• Aguarde a verificação concluir: Tenha paciência na primeira execução; as próximas voltarão à velocidade normal.
• Adicione às Ferramentas de Desenvolvedor: Adicione seu app de terminal em Ajustes do Sistema → Privacidade e Segurança → Ferramentas de Desenvolvedor.

Como atualizar o Kimi Code CLI

Execute kimi upgrade para verificar a versão mais recente e ver as opções de atualização. Escolha Install update now (Instalar atualização agora) para atualizar. Você também pode atualizar diretamente pelo gerenciador de pacotes:

Bash

Perguntas frequentes sobre a extensão do VS Code

Abaixo estão as perguntas frequentes sobre a extensão do Kimi Code para VS Code.

O VS Code diz que nenhum workspace está aberto

Abra uma pasta no VS Code. A extensão do Kimi Code para VS Code precisa de um workspace para funcionar corretamente.

O VS Code diz que não encontra o CLI

Instale o Kimi Code CLI manualmente e configure kimi.executablePath nas configurações do VS Code, ou certifique-se de que o CLI integrado está presente.

Falha no login pelo VS Code

Tente pular o login e usar o modo de chave de API, verifique sua conexão de rede ou tente novamente mais tarde pelo menu de ações da extensão do Kimi Code.

O VS Code envia mensagens sem resposta

Confirme se o Kimi Code CLI está disponível, se o modelo está configurado e se há uma pasta de workspace aberta no VS Code. Verifique os logs de erro em "Kimi Code: Show Logs".

A conexão do VS Code expira

Se não houver resposta em 30 segundos, a conexão expira. Verifique sua rede e tente novamente.

Erro no VS Code antes de enviar uma mensagem

Alguns erros impedem o envio de mensagens no VS Code, como o Kimi Code CLI não encontrado, versão muito antiga, não estar logado ou sessão ocupada. O erro aparecerá como uma notificação, e o que você digitou será preservado para tentar novamente.

Feedback e contato

A documentação não resolveu meu problema

Se nada acima resolveu seu problema, fique à vontade para nos contatar por e-mail: [email protected]. No e-mail, descreva o problema que você encontrou, os passos que seguiu e qualquer informação de log relevante, e responderemos o mais rápido possível.

Se tiver qualquer problema ou sugestão, você também pode enviar feedback no GitHub Issues.