Kimi Code 配置

Kimi Code配置

Kimi Code 是 Moonshot AI 推出的终端编码助手。本教程只介绍通过脑生云使用模型的基础安装、配置和验证方法。

其它功能请参考官方文档

MCP、Skills、Plugins 等扩展能力不在本基础教程中展开，请直接参考 Kimi Code 官方文档：

• MCP

• Agent Skills

• Plugins

不要泄露 API 令牌

下面示例中的 sk-替换为你的API令牌只是占位符。请勿在截图、聊天记录、公开仓库或工单中展示真实 API 令牌，也不要把包含令牌的 config.toml 提交到 Git 仓库。

安装 Kimi Code

Kimi Code 官方同时提供安装脚本和 npm 安装方式。本教程推荐使用 npm；其它安装方式和最新环境要求请查看 Kimi Code 官方入门文档。

1. 确认已安装 Node.js 22.19.0 或更高版本：

2. 使用 npm 全局安装最新版 Kimi Code：

3. 检查安装结果：

准备令牌和模型

1. 在已开通的模型与密钥权限中查看目标模型支持的请求协议。

2. 按照创建 API Key 创建支持该模型和协议的令牌。

3. 从下面三种协议中选择一种配置，不要把三个示例同时写入配置文件。

API 端点三种协议：
Anthropic Messages：https://api\.naoshengyun\.com
OpenAI Chat Completions：https://api\.naoshengyun\.com/v1
OpenAI Responses：https://api\.naoshengyun\.com/v1

接入提示：以下操作保留参考教程的流程，模型名称与兼容能力请以脑生云实际开通情况为准。

打开配置文件

Kimi Code 的基础配置文件名为 config.toml。首次运行 kimi 后会自动创建配置目录；如果没有生成，也可以手动创建目录和文件。

Windows

键盘按下“Win+R”，输入以下路径后回车：

%USERPROFILE%\.kimi-code

打开或创建该目录中的 config.toml。

macOS / Linux / WSL

配置文件路径为：

~/.kimi-code/config.toml

如果目录不存在，可以先执行：

然后打开或创建 config.toml。

配置脑生云网关

以下三种配置分别对应 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 协议。复制所选配置后，只需替换：

1. sk-替换为你的API令牌：替换为在脑生云创建的 API 令牌。

2. 替换为模型广场中的模型ID：替换为密钥权限支持的实际模型 ID，例如模型广场当前提供的 deepseek-v4-flash。

max_context_size 是必填项。示例使用 200000，如果模型广场标注了其它上下文长度，请按模型说明修改。

OpenAI Chat Completions

适用于支持 OpenAI Chat Completions 协议的模型，请求路径为 /v1/chat/completions。

default_model = "naoshengyun_chat"

[providers.naoshengyun_chat]
type = "openai"
base_url = "https://api.naoshengyun.com/v1"
api_key = "sk-替换为你的API令牌"

[models.naoshengyun_chat]
provider = "naoshengyun_chat"
model = "替换为模型广场中的模型ID"
max_context_size = 200000

base_url 填写到 /v1 即可，不要再拼接 /chat/completions，Kimi Code 会自动补齐请求路径。

配置文件效果如下：

Kimi Code 的 OpenAI Chat Completions 配置启动并发送消息后，能够正常回复即表示配置成功：

使用 OpenAI Chat Completions 配置测试 Kimi Code

OpenAI Responses

适用于支持 OpenAI Responses API 的模型，请求路径为 /v1/responses。

default_model = "naoshengyun_responses"

[providers.naoshengyun_responses]
type = "openai_responses"
base_url = "https://api.naoshengyun.com/v1"
api_key = "sk-替换为你的API令牌"

[models.naoshengyun_responses]
provider = "naoshengyun_responses"
model = "替换为模型广场中的模型ID"
max_context_size = 200000

base_url 填写到 /v1 即可，不要再拼接 /responses。type 必须写成 openai_responses，不能写成 openai-responses。

配置文件效果如下：

Kimi Code 的 OpenAI Responses 配置启动并发送消息后，能够正常回复即表示配置成功：

Anthropic Messages

适用于支持 Anthropic Messages 协议的模型，请求路径为 /v1/messages。

default_model = "naoshengyun_anthropic"

[providers.naoshengyun_anthropic]
type = "anthropic"
base_url = "https://api.naoshengyun.com"
api_key = "sk-替换为你的API令牌"

[models.naoshengyun_anthropic]
provider = "naoshengyun_anthropic"
model = "替换为模型广场中的模型ID"
max_context_size = 200000

Anthropic 的 base_url 不要添加 /v1 或 /v1/messages，Kimi Code 使用的 Anthropic SDK 会自动补齐请求路径。

配置文件效果如下：

Kimi Code 的 Anthropic Messages 配置启动并发送消息后，能够正常回复即表示配置成功：

环境变量一键启动

下面示例按 OpenAI Chat Completions 协议临时定义模型，不修改配置文件，关闭终端后自动失效。

Windows PowerShell

macOS / Linux

$env:KIMI_MODEL_NAME = Read-Host "请输入模型 ID"
$secureKey = Read-Host "请输入脑生云 API Key" -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secureKey)
try { $env:KIMI_MODEL_API_KEY = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr) } finally { [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr) }
$env:KIMI_MODEL_PROVIDER_TYPE = "openai"
$env:KIMI_MODEL_BASE_URL = "https://api.naoshengyun.com/v1"
$env:KIMI_MODEL_MAX_CONTEXT_SIZE = "200000"
kimi

如果 macOS/Linux 终端被中断后不显示输入字符，请运行 stty echo。

常见问题

如果启动或请求失败，优先检查：

1. default_model 是否与 [models.<名称>] 完全一致。

2. [models.<名称>].provider 是否与 [providers.<名称>] 完全一致。

3. 模型 ID 是否属于当前密钥权限，并支持所选请求协议。

4. OpenAI Chat / Responses 的地址是否以 /v1 结尾。

5. Anthropic 的地址是否没有手动添加 /v1 或 /v1/messages。

官方配置参考

Kimi Code 更新较快，完整配置和高级用法请以官方文档为准：

• 供应商与模型

• 配置文件

• 环境变量

• 配置覆盖

Kimi Code配置#

安装 Kimi Code#

准备令牌和模型#

打开配置文件#

Windows#

macOS / Linux / WSL#

配置 脑生云 网关#

OpenAI Chat Completions#

OpenAI Responses#

Anthropic Messages#

环境变量一键启动#

常见问题#

官方配置参考#

Kimi Code配置

安装 Kimi Code

准备令牌和模型

打开配置文件

Windows

macOS / Linux / WSL

配置脑生云网关

OpenAI Chat Completions

OpenAI Responses

Anthropic Messages

环境变量一键启动

常见问题

官方配置参考