Kimi Code / Kimi K3 安装与配置

Kimi Code 面向代码开发，可融入各类开发流程，以更快、更稳定的响应帮助完成编程任务。本页介绍如何安装官方 Kimi Code CLI，并使用 I Code Easy API Key 接入 kimi-k3。

Kimi Code CLI 与 Claude Code 是两个不同的客户端。如果你使用的是 Claude Code，请直接查看本页后半部分的 Claude Code 配置。

1. 安装 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

安装完成后重新打开终端，确认命令可用：

kimi --version

安装命令和产品说明可参考 Kimi Code 官方页面。

2. 配置 I Code Easy API

新版 Kimi Code 的长期配置文件位于 ~/.kimi-code/config.toml。新用户可以创建该文件；如果文件已经存在，请合并下面的配置，不要覆盖已有 Provider、MCP 或权限设置，并确保顶层 default_model 只保留一项。

default_model = "icodeeasy/kimi-k3"

[providers.icodeeasy]
type = "kimi"
base_url = "https://api.icodeeasy.cc/v1"
api_key = "你的 I Code Easy API Key"

[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"

macOS / Linux 建议限制配置文件权限：

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

如果主域名连接慢，可以把 base_url 换成 https://jp.icodeeasy.cc/v1 或 https://sg.icodeeasy.cc/v1。

上面的配置同时登记了两个模型：Kimi K3（1M 上下文，支持视频输入）和 Kimi K3 256K（256K 上下文，支持图片输入）。默认使用 Kimi K3；如果想默认使用更便宜的 256K 档位，把 default_model 改成 "icodeeasy/k3-256k" 即可，也可以在会话中随时用 /model 切换。当前 256K 档的有效价格为输入 / 缓存读取 / 输出 ¥2.00 / ¥0.20 / ¥10.00 每 MTok，1M 档为 ¥4.00 / ¥0.40 / ¥20.00 每 MTok。

3. 启动和检查

进入项目目录后启动 Kimi Code：

cd 你的项目目录
kimi

进入界面后可以运行 /model，确认当前模型为 Kimi K3 (I Code Easy)（也可以随时切换到 Kimi K3 256K (I Code Easy)），然后直接描述需要完成的编程任务。

使用 I Code Easy API Key 时不需要执行 /login；/login 用于登录 Kimi 官方账号。

临时测试配置

当前 Kimi Code 不会自动读取终端中的普通 KIMI_API_KEY。如果只想临时测试、不修改 config.toml，请使用专用的 KIMI_MODEL_* 环境变量：

export KIMI_MODEL_NAME="kimi-k3"
export KIMI_MODEL_API_KEY="你的 I Code Easy API Key"
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

如需临时测试 256K 模型，把 KIMI_MODEL_NAME 改为 k3-256k、KIMI_MODEL_MAX_CONTEXT_SIZE 改为 262144，并从 KIMI_MODEL_CAPABILITIES 中去掉 video_in。

关闭该终端后，这组临时配置不会保留。

通过 Claude Code 使用 Kimi K3 256K

如果你希望在 Claude Code 中使用 Kimi K3 256K，可在 ~/.bashrc 或 ~/.zshrc 中配置：

export ANTHROPIC_AUTH_TOKEN="你的 I Code Easy API Key"
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 是 Claude Code 兼容请求名，服务会将它映射到实际模型 k3-256k。用户倍率 0.2 下，输入、缓存读取和输出的有效价格分别为 ¥2.00、¥0.20 和 ¥10.00 / MTok。如因可用性需要使用兼容模型 Kimi K2.7 Code，将按实际使用的模型价格计费。

保存后运行 source ~/.bashrc 或 source ~/.zshrc，再启动 claude。如果主域名连接慢，可以把 ANTHROPIC_BASE_URL 换成 https://jp.icodeeasy.cc 或 https://sg.icodeeasy.cc。

Windows 用户可以在 PowerShell 中设置相同的用户级环境变量，设置完成后重新打开 PowerShell。