Configurar Kimi Code: API Key, K3.1 Pro e Claude Code

Para usar uma API Key do I Code Easy no Kimi Code CLI, salve a chave e a URL com /v1 em ~/.kimi-code/config.toml e selecione k3.1-pro. No Claude Code, use variáveis ANTHROPIC_* e apenas o domínio na URL. Os dois clientes usam formatos de configuração diferentes.

Escolha o caminho para seu cliente

Crie uma conta, copie sua chave em API Keys e salve um endpoint para Kimi na seleção de endpoints. A chave do I Code Easy e a conta oficial Kimi são credenciais distintas. /login entra na conta oficial; não é a etapa para inserir a chave deste site.

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

No Windows, o Kimi Code também exige Git for Windows; confira os requisitos nas instruções oficiais de instalação.

Após instalar, abra outro terminal e confira a versão. Se kimi não for encontrado, resolva a instalação ou o PATH antes de alterar a configuração da API.

kimi --version

Consulte a página oficial do Kimi Code para instalação e atualização. Se sua versão não reconhecer as opções abaixo, compare a documentação oficial e a versão instalada antes de trocar a chave repetidamente.

2. Configurar a API da I Code Easy

Crie ~/.kimi-code/config.toml se necessário. No Windows, use .kimi-code/config.toml no diretório pessoal do usuário atual. Mescle com o arquivo existente, preservando outros providers, MCP e permissões. Mantenha um único default_model no nível superior, antes das tabelas TOML, e não acrescente tabelas duplicadas de provider ou modelo.

Se KIMI_CODE_HOME estiver definido, o diretório de configuração muda. default_model recebe o alias da tabela, como icodeeasy/k3.1-pro, e não apenas o nome do modelo enviado à API.

default_model = "icodeeasy/k3.1-pro"

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

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

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

[models."icodeeasy/k3"]
provider = "icodeeasy"
model = "k3"
max_context_size = 1048576
capabilities = ["thinking", "tool_use"]
display_name = "Kimi K3 (I Code Easy)"

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

No macOS / Linux, restrinja as permissões do arquivo:

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

Se o domínio principal estiver lento, use https://jp.icodeeasy.cc/v1 ou https://sg.icodeeasy.cc/v1 em base_url. Não acrescente /v1 duas vezes.

Escolher entre os quatro modelos

Veja preços e uso para preços atuais, saldo e consumo, e o catálogo de modelos para capacidades. Entrada de imagem e vídeo não é uma capacidade publicamente prometida para K3 ou K3-256K.

Os nomes antigos não selecionam todos o mesmo modelo. Nomes antigos da série K2, kimi e kimi-for-coding vão para K3.1 Pro; aliases Highspeed como kimi-for-coding-highspeed selecionam Highspeed. kimi-k3 e k3[1m] continuam sendo K3, enquanto kimi-k3-256k continua sendo K3-256K. Os nomes correspondentes com prefixo kimi- dos quatro modelos mantêm sua seleção.

Quando K3-256K excede o limite de contexto, o mecanismo existente eleva a solicitação para K3 e cobra essa solicitação pelo preço de K3. Inicie uma nova sessão após trocar de modelo para evitar reutilizar contexto já compactado.

Configuração temporária para teste

O Kimi Code atual não lê automaticamente a variável comum KIMI_API_KEY. Para um teste temporário, use as variáveis dedicadas KIMI_MODEL_*. Esse caminho é separado do arquivo de configuração; primeiro identifique qual deles está testando.

Definir KIMI_MODEL_NAME ativa o modelo do ambiente e exige KIMI_MODEL_API_KEY. Essas variáveis não são gravadas no arquivo e têm prioridade sobre seu default_model; a opção de linha de comando -m tem prioridade sobre o modelo do ambiente.

macOS / Linux:

export KIMI_MODEL_NAME="k3.1-pro"
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

Windows PowerShell (apenas a sessão atual):

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

Para testar Highspeed, altere KIMI_MODEL_NAME para k3.1-pro-highspeed. Fechar o terminal remove as variáveis definidas aqui. Valores salvos anteriormente em variáveis de usuário ou scripts de inicialização precisam ser removidos separadamente. Teste o TOML em um novo terminal sem essas variáveis temporárias.

3. Iniciar e verificar

Entre no diretório do projeto e execute:

cd your-project-directory
kimi

Na interface, execute /model e confirme Kimi K3.1 Pro (I Code Easy) ou a opção desejada. Ver apenas a versão ou a lista de modelos não comprova uma chamada bem-sucedida à API.

Envie primeiro uma mensagem simples, como “Responda apenas: conexão bem-sucedida”, antes de pedir leitura ou edição do projeto. Depois da resposta, confira status e modelo real nos logs de solicitações, e consumo e cobrança nos detalhes de uso. Oculte a chave em capturas para suporte.

Usar o Kimi K3.1 Pro pelo Claude Code

Para instalação e configuração geral, veja o guia do Claude Code. No macOS / Linux, adicione estas opções ao ~/.bashrc ou ~/.zshrc usado pelo seu shell:

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

Salve, execute source ~/.bashrc ou source ~/.zshrc e inicie claude. ANTHROPIC_BASE_URL usa apenas o domínio; alternativas: https://jp.icodeeasy.cc e https://sg.icodeeasy.cc. Abra uma nova sessão após trocar de modelo.

No Windows, defina as mesmas variáveis no PowerShell como $env:VARIAVEL="valor" e execute claude nessa janela. Se salvar variáveis permanentes no nível do usuário, abra uma nova janela do PowerShell; clientes já abertos não recebem os novos valores automaticamente. Não cole comandos Bash export diretamente no PowerShell.

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

Resolver 401, seleção de modelo e erros de URL

Configurar outro cliente

Claude Code · Configurar GLM · Preços, saldo e uso · Capacidades dos modelos

Referências oficiais

• Kimi Code: Arquivos de configuração
• Kimi Code: Variáveis de ambiente