Instalação e configuração do Kimi Code / Kimi K3

O Kimi Code foi criado para fluxos de desenvolvimento de software, oferecendo assistência rápida e estável em tarefas de programação. Este guia mostra como instalar o Kimi Code CLI oficial e conectar ao kimi-k3 com uma chave da API I Code Easy.

Kimi Code CLI e Claude Code são clientes diferentes. Se você usa Claude Code, consulte a seção correspondente no final desta página.

1. Instalar o Kimi Code

macOS / Linux:

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

Windows PowerShell:

irm https://code.kimi.com/kimi-code/install.ps1 | iex

Depois da instalação, abra um novo terminal e verifique o comando:

kimi --version

Consulte a página oficial do Kimi Code para ver o instalador e a apresentação do produto.

2. Configurar a API I Code Easy

As versões atuais do Kimi Code armazenam as configurações persistentes em ~/.kimi-code/config.toml. Crie o arquivo se ele não existir. Se já existir, mescle as entradas abaixo sem substituir Providers, servidores MCP ou permissões existentes, e mantenha apenas uma entrada default_model no nível superior.

default_model = "icodeeasy/kimi-k3"

[providers.icodeeasy]
type = "kimi"
base_url = "https://api.icodeeasy.cc/v1"
api_key = "sua chave da API I Code Easy"

[models."icodeeasy/kimi-k3"]
provider = "icodeeasy"
model = "kimi-k3"
max_context_size = 1048576
capabilities = ["thinking", "always_thinking", "image_in", "video_in", "tool_use"]
display_name = "Kimi K3 (I Code Easy)"
support_efforts = ["max"]
default_effort = "max"

[models."icodeeasy/k3-256k"]
provider = "icodeeasy"
model = "k3-256k"
max_context_size = 262144
capabilities = ["thinking", "always_thinking", "image_in", "tool_use"]
display_name = "Kimi K3 256K (I Code Easy)"
support_efforts = ["low", "high", "max"]
default_effort = "high"

No macOS / Linux, restrinja o acesso ao arquivo de configuração:

chmod 600 ~/.kimi-code/config.toml

Se o domínio principal estiver lento, altere base_url para https://jp.icodeeasy.cc/v1 ou https://sg.icodeeasy.cc/v1.

A configuração acima registra dois modelos: Kimi K3 (contexto de 1M, com entrada de vídeo) e Kimi K3 256K (contexto de 256K, com entrada de imagem). O padrão é Kimi K3. Para usar por padrão o nível 256K, mais barato, altere default_model para "icodeeasy/k3-256k"; você também pode alternar a qualquer momento com /model durante a sessão. Na tarifa atual, o nível 256K custa ¥2.00 / ¥0.20 / ¥10.00 por MTok (entrada / leitura de cache / saída) e o nível 1M custa ¥4.00 / ¥0.40 / ¥20.00 por MTok.

3. Iniciar e verificar

Abra o projeto e inicie o Kimi Code:

cd seu-projeto
kimi

No Kimi Code, execute /model e confirme que Kimi K3 (I Code Easy) está selecionado (você também pode alternar para Kimi K3 256K (I Code Easy) a qualquer momento). Em seguida, descreva a tarefa de programação que deseja realizar.

Não é necessário executar /login ao usar uma chave da API I Code Easy. /login serve para entrar em uma conta Kimi.

Configuração temporária para testes

As versões atuais do Kimi Code não leem automaticamente um KIMI_API_KEY comum exportado pelo shell. Para testar sem modificar config.toml, use as variáveis dedicadas KIMI_MODEL_*:

export KIMI_MODEL_NAME="kimi-k3"
export KIMI_MODEL_API_KEY="sua chave da API I Code Easy"
export KIMI_MODEL_PROVIDER_TYPE="kimi"
export KIMI_MODEL_BASE_URL="https://api.icodeeasy.cc/v1"
export KIMI_MODEL_MAX_CONTEXT_SIZE="1048576"
export KIMI_MODEL_CAPABILITIES="thinking,always_thinking,image_in,video_in,tool_use"
kimi

Para testar temporariamente o modelo 256K, altere KIMI_MODEL_NAME para k3-256k, KIMI_MODEL_MAX_CONTEXT_SIZE para 262144 e remova video_in de KIMI_MODEL_CAPABILITIES.

Essas configurações temporárias desaparecem quando a sessão do terminal é encerrada.

Usar o Kimi K3 256K pelo Claude Code

Para usar o Kimi K3 256K no Claude Code, adicione o seguinte ao ~/.bashrc ou ~/.zshrc:

export ANTHROPIC_AUTH_TOKEN="sua chave da API I Code Easy"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="kimi-k3"
export ANTHROPIC_SMALL_FAST_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_OPUS_MODEL="kimi-k3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="kimi-k3"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

kimi-k3 é o nome de compatibilidade usado pelo Claude Code, e o serviço o mapeia para o modelo real k3-256k. Com a taxa de usuário 0.2, os preços efetivos de entrada, leitura de cache e saída são ¥2.00, ¥0.20 e ¥10.00 por MTok. Se a disponibilidade exigir o modelo compatível Kimi K2.7 Code, a cobrança seguirá o modelo realmente utilizado.

Salve o arquivo, execute source ~/.bashrc ou source ~/.zshrc e inicie claude. Se o domínio principal estiver lento, altere ANTHROPIC_BASE_URL para https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc.

No Windows, defina as mesmas variáveis de ambiente no nível do usuário pelo PowerShell e abra uma nova janela do PowerShell.