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"

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.

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. 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

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. Atualmente, os três upstreams oficiais primários o mapeiam para o modelo real k3-256k. Com a taxa de usuário 0.25, os preços efetivos de entrada, leitura de cache e saída são ¥2.50, ¥0.25 e ¥12.50 por MTok. Se o pool oficial estiver indisponível, o tráfego alterna automaticamente para o Kimi K2.7 Code e é cobrado pelo modelo de fallback 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.