Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

Kilo CLI

Codificação AI no terminal

Kilo CLI traz assistência de codificação com tecnologia de IA diretamente para o seu terminal. Conecte-o a QwenCloud via Token Plan (Personal Edition), Token Plan (Team Edition) ou faturamento pré-pago.

Início rápido

Comece a correr em alguns minutos:

# 1. Install (requires Node.js v18+)
npm install -g @kilocode/cli
kilo --version

# 2. Configure: Edit ~/.config/kilo/config.json
# Add provider configuration with your API key

# 3. Test (run kilo and type)
kilo
Ask: "Write a function to calculate fibonacci numbers"

Você deverá ver: Kilo gera o código da função fibonacci

Configuração

Abrir ~/.config/kilo/config.json com um editor de texto e adicione a configuração do plano escolhido.

Cota e cobrança gratuitas:

Usuários iniciantes recebem uma cota gratuita. Consulte Cota gratuita para obter detalhes.
Ativar somente cota gratuita para evitar cobranças inesperadas.

Plano de token (edição pessoal)

Você deve primeiro adquirir um pacote Token Plan (Personal Edition) com uma assinatura ativa. Você pode comprar um pacote na página Token Plan (Personal Edition).

Substituir YOUR_API_KEY com o Token Plan (Personal Edition) dedicado chave de API. Para modelos disponíveis, consulte Token Plan (Personal Edition) modelos suportados.

{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "bailian-token-plan-personal": {
      "npm": "@ai-sdk/anthropic",
      "name": "QwenCloud",
      "options": {
        "baseURL": "https://token-plan.maas.qwencloudapi.com/apps/anthropic/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "modalities": {
            "input": ["text"],
            "output": ["text"]
          }
        },
        "qwen3.8-max": {
          "name": "Qwen3.8 Max",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 262144
            }
          }
        },
        "qwen3.8-flash": {
          "name": "Qwen3.8 Flash",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 262144
            }
          }
        },
        "qwen3.7-max": {
          "name": "Qwen3.7 Max",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "qwen3.7-plus": {
          "name": "Qwen3.7 Plus",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "qwen3.6-flash": {
          "name": "Qwen3.6 Flash",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "glm-5.3": {
          "name": "GLM-5.3",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "glm-5.2": {
          "name": "GLM-5.2",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        },
        "deepseek-v4-pro-0813": {
          "name": "DeepSeek V4 Pro 0813"
        },
        "deepseek-v4-flash-0731": {
          "name": "DeepSeek V4 Flash 0731"
        },
        "deepseek-v4.1-flash": {
          "name": "DeepSeek V4.1 Flash"
        }
      }
    }
  }
}

**qwen3.8-max modo de pensamento **:

pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
temperatura: o padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
reasoning_effort: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Plano de Token (Edição de Equipe)

Você deve primeiro adquirir um Token Plan (Team Edition) com uma assinatura ativa na página Token Plan.

Substituir YOUR_API_KEY com o Token Plan (Team Edition) dedicado chave de API. Para modelos disponíveis, consulte Token Plan (Team Edition) modelos suportados.

{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "bailian-token-plan": {
      "npm": "@ai-sdk/anthropic",
      "name": "QwenCloud",
      "options": {
        "baseURL": "https://token-plan.maas.qwencloudapi.com/apps/anthropic/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "modalities": {
            "input": ["text"],
            "output": ["text"]
          }
        },
        "qwen3.8-max": {
          "name": "Qwen3.8 Max",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 262144
            }
          }
        },
        "qwen3.8-flash": {
          "name": "Qwen3.8 Flash",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 262144
            }
          }
        },
        "qwen3.7-max": {
          "name": "Qwen3.7 Max",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "qwen3.7-plus": {
          "name": "Qwen3.7 Plus",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "qwen3.6-plus": {
          "name": "Qwen3.6 Plus",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "qwen3.6-flash": {
          "name": "Qwen3.6 Flash",
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          },
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "deepseek-v4-pro": {
          "name": "DeepSeek V4 Pro"
        },
        "deepseek-v4-pro-0813": {
          "name": "DeepSeek V4 Pro 0813"
        },
        "deepseek-v4-flash-0731": {
          "name": "DeepSeek V4 Flash 0731"
        },
        "deepseek-v4.1-flash": {
          "name": "DeepSeek V4.1 Flash"
        },
        "kimi-k2.7-code": {
          "name": "Kimi K2.7 Code",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "kimi-k2.6": {
          "name": "Kimi K2.6",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "kimi-k2.5": {
          "name": "Kimi K2.5",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "glm-5.3": {
          "name": "GLM-5.3",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "glm-5.2": {
          "name": "GLM-5.2",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "glm-5.1": {
          "name": "GLM-5.1",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "glm-5": {
          "name": "GLM-5",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 8192
            }
          }
        },
        "MiniMax-M2.5": {
          "name": "MiniMax M2.5"
        }
      }
    }
  }
}

**qwen3.8-max modo de pensamento **:

pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
temperatura: o padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
reasoning_effort: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Pague conforme o uso

Substituir YOUR_API_KEY com o seu QwenCloud Chave API. Para modelos disponíveis, consulte modelos suportados.

{
  "$schema": "https://kilo.ai/config.json",
  "provider": {
    "qwencloud": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "QwenCloud",
      "options": {
        "baseURL": "https://maas.qwencloudapi.com/compatible-mode/v1",
        "apiKey": "YOUR_API_KEY"
      },
      "models": {
        "qwen3.7-plus": {
          "name": "Qwen3.7 Plus",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 1024
            }
          }
        },
        "qwen3.6-plus": {
          "name": "Qwen3.6 Plus",
          "options": {
            "thinking": {
              "type": "enabled",
              "budgetTokens": 1024
            }
          }
        }
      }
    }
  }
}

Para adicionar mais modelos, anexe-os no mesmo formato dentro models.

Recomendações de modelo

Tarefa	Modelo	Por que
Tarefas simples	`qwen3.7-plus`	Respostas rápidas, baixo custo
Codificação padrão	`qwen3.7-plus`	Desempenho equilibrado
Algoritmos complexos	`qwen3.6-plus`	Raciocínio forte
Projeto de arquitetura	`qwen3.6-plus`	Compreensão profunda do código

Verifique a configuração

Após salvar a configuração, reinicie o Kilo CLI, digite /models, procure por "QwenCloud", e selecione o modelo que você want usar.

Para mais dicas e comandos comuns, consulte a documentação oficial do Kilo Code.

Limitações

Apenas terminal: sem interface GUI
Uso de token: edições de vários arquivos consomem mais tokens
Compatibilidade de modelos: nem todos os recursos funcionam com todos os modelos

Solução de problemas

Erro "Chave de API inválida"

Solução:

Verifique se a chave API está correta e corresponde ao seu plano

Certifique-se de que a chave API tenha cota ou assinatura ativa

Erro "Modelo não encontrado"

Solução:

Verifique a ortografia do ID do modelo

Consulte Lista de modelos

Alto consumo de tokens

Solução:

Trabalhar em diretórios específicos

Use prompts precisos

Contexto claro com novas sessões

Escolha modelos apropriados para tarefas

Respostas lentas

Solução:

Use modelos mais rápidos como qwen3.7-plus

Verifique a conexão de rede

Reduza o tamanho do contexto

Otimização de token

Reduza o uso:

Diretórios específicos: navegue até pastas específicas do projeto
Avisos claros: seja específico sobre o que você precisa
Seleção de modelo: use modelos leves para tarefas simples
Gerenciamento de contexto: inicie novas sessões para tarefas não relacionadas
Alterações incrementais: faça edições pequenas e focadas

Perguntas frequentes

Se você encontrar erros, consulte a documentação de perguntas frequentes do plano de faturamento correspondente:

Pagamento conforme o uso: Códigos de erro e solução de problemas
Plano de token (edição pessoal): Perguntas frequentes sobre o plano de token (edição pessoal)
Plano de Token (Team Edition): Perguntas frequentes sobre o plano de token

Recursos relacionados

Plano de Token: Configuração com assinatura
Modelos: Modelos disponíveis
documentos da API: referência compatível com OpenAI
Documentos oficiais: documentação Kilo CLI