Kimi Code 配置指南：API Key、K3.1 Pro 与 Claude Code

在 Kimi Code CLI 中使用 I Code Easy API Key：将密钥和带 /v1 的地址写入 ~/.kimi-code/config.toml，再选择 k3.1-pro。如果使用 Claude Code，则配置 ANTHROPIC_* 变量，地址只写域名。两种客户端的配置不能混用。

先按客户端选择配置路径

先注册账号，登录后在 API Keys 复制本站密钥，并在接入点选择为 Kimi 选择接入点。本站 API Key 与 Kimi 官方账号是两套凭据；/login 用于官方账号，不用于填入本站密钥。

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

Windows 使用 Kimi Code 前还需安装 Git for Windows，具体要求以官方安装文档为准。

安装后重新打开终端，再运行版本命令。若找不到 kimi，先处理安装或 PATH，再修改 API 配置。

kimi --version

安装方式与更新说明以 Kimi Code 官方页面为准；若你的版本不识别下文配置，先核对官方文档与本机版本，不要反复替换密钥。

2. 配置 I Code Easy API

新用户可创建 ~/.kimi-code/config.toml；Windows 对应当前用户主目录下的 .kimi-code/config.toml。已有文件请合并配置，保留其他 Provider、MCP 与权限设置。顶层 default_model 必须放在各个 TOML 表之前，且只保留一项；同名 Provider 或模型表也不要重复追加。

如设置了 KIMI_CODE_HOME，配置目录会随之改变。default_model 填写的是模型表的别名（例如 icodeeasy/k3.1-pro），不是单独的线上模型名。

default_model = "icodeeasy/k3.1-pro"

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

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

macOS / Linux 可限制配置文件权限：

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

主域名连接慢时，可将 base_url 换为 https://jp.icodeeasy.cc/v1 或 https://sg.icodeeasy.cc/v1。不要在这个字段重复追加 /v1。

四个模型如何选择

当前价格、余额和用量见价格与用量指南；支持范围见模型目录。K3 与 K3-256K 未公开承诺图片或视频输入能力。

旧名不是全部指向同一模型：K2 系列旧名、kimi 与 kimi-for-coding 路由到 K3.1 Pro；高速旧名如 kimi-for-coding-highspeed 对应高速版。kimi-k3 与 k3[1m] 仍为 K3，kimi-k3-256k 仍为 K3-256K。四档带 kimi- 前缀的对应写法仍按各自模型受理。

K3-256K 上下文溢出后会按既有机制升级为 K3，升级请求按 K3 价格计费。切换模型后建议开启新会话，避免沿用已压缩的旧上下文。

临时测试配置

当前 Kimi Code 不会自动读取普通 KIMI_API_KEY；临时试用使用专用 KIMI_MODEL_* 变量。它与写入配置文件是两条路径，排错时先确定自己正在使用哪一条。

设置 KIMI_MODEL_NAME 会启用环境变量模型，且必须提供 KIMI_MODEL_API_KEY。这组变量不写回文件，优先于文件中的 default_model；命令行 -m 选项又优先于环境变量模型。

macOS / Linux：

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

Windows PowerShell（仅当前会话）：

$env:KIMI_MODEL_NAME="k3.1-pro"
$env:KIMI_MODEL_API_KEY="你的 I Code Easy API Key"
$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

临时试用高速版时，把 KIMI_MODEL_NAME 改为 k3.1-pro-highspeed。关闭该终端后，这里设置的变量不会保留；如果之前写入过用户级变量或启动脚本，它们仍需单独清理。要验证 TOML 配置，请使用没有这组临时变量的新终端。

3. 启动和检查

进入自己的项目目录后运行：

cd your-project-directory
kimi

在界面中运行 /model，确认所选项为 Kimi K3.1 Pro (I Code Easy) 或你需要的另一档。只看到版本号或模型列表，还不能证明 API 调用已成功。

先发送一句普通对话，例如“只回复连接成功”，收到回答后再让客户端读取或修改项目。在请求日志核对请求状态与实际模型，并到用量明细检查用量和费用；分享排错截图前遮住密钥。

通过 Claude Code 使用 Kimi K3.1 Pro

Claude Code 的通用安装与配置见 Claude Code 指南。使用 Kimi 时，macOS / Linux 可将下面变量放入正在使用的 ~/.bashrc 或 ~/.zshrc：

export ANTHROPIC_AUTH_TOKEN="你的 I Code Easy API Key"
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"

保存后执行 source ~/.bashrc 或 source ~/.zshrc，再启动 claude。这里的 ANTHROPIC_BASE_URL 只写域名；备用地址为 https://jp.icodeeasy.cc 和 https://sg.icodeeasy.cc。切换模型后开启新会话。

Windows 可在当前 PowerShell 中用 $env:变量名="值" 设置同一组变量，再从这个窗口启动 claude。若写成用户级永久变量，需重新打开 PowerShell；已经运行的客户端不会自动取得新值。不要把 Bash 的 export 原样贴入 PowerShell。

$env:ANTHROPIC_AUTH_TOKEN="你的 I Code Easy API Key"
$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

常见问题：401、模型不生效与地址错误

继续配置其他客户端

Claude Code · GLM 配置 · 价格、余额与用量 · 模型能力目录

官方参考

• Kimi Code: 配置文件
• Kimi Code: 环境变量