AI.c 使用文档

主题

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

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

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

安装 Kimi Code ​

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

  • 确认已安装 Node.js 22.19.0 或更高版本：
bash
node --version
  • 使用 npm 全局安装最新版 Kimi Code：
bash
npm install -g @moonshot-ai/kimi-code@latest

使用 npm 安装 Kimi Code使用 npm 安装 Kimi Code

  • 检查安装结果：
bash
kimi --version

准备令牌和模型 ​

  • 在 模型广场 中查看目标模型支持的请求协议。
  • 按照 创建 API 令牌 创建支持该模型和协议的令牌。
  • 从下面三种协议中选择一种配置，不要把三个示例同时写入配置文件。

❗ 令牌分组必须匹配CC 和 claude-sale 分组不能用于第三方 CLI 接入。请以模型广场实时展示的模型 ID、支持协议和可用令牌分组为准。

模型详情页会列出该模型支持的 API 端点。例如下图中的模型同时支持 Anthropic Messages、OpenAI Chat Completions 和 OpenAI Responses：

在模型广场查看模型支持的 API 端点在模型广场查看模型支持的 API 端点

打开配置文件 ​

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

Windows

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

text
%USERPROFILE%\.kimi-code

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

macOS / Linux / WSL

配置文件路径为：

text
~/.kimi-code/config.toml

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

bash
mkdir -p ~/.kimi-code

然后打开或创建 config.toml。

配置 AI.c 网关 ​

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

  • sk-替换为你的API令牌：替换为在 AI.c 创建的 API 令牌。
  • 替换为模型广场中的模型ID：替换为令牌分组支持的实际模型 ID，例如模型广场当前提供的 deepseek-v4-flash。

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

OpenAI Chat Completions ​

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

toml
default_model = "packy_chat"

[providers.packy_chat]
type = "openai"
base_url = "https://ouraic.cn/v1"
api_key = "sk-替换为你的API令牌"

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

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

配置文件效果如下：

Kimi Code 的 OpenAI Chat Completions 配置Kimi Code 的 OpenAI Chat Completions 配置

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

使用 OpenAI Chat Completions 配置测试 Kimi Code使用 OpenAI Chat Completions 配置测试 Kimi Code

OpenAI Responses ​

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

toml
default_model = "packy_responses"

[providers.packy_responses]
type = "openai_responses"
base_url = "https://ouraic.cn/v1"
api_key = "sk-替换为你的API令牌"

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

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

配置文件效果如下：

Kimi Code 的 OpenAI Responses 配置Kimi Code 的 OpenAI Responses 配置

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

使用 OpenAI Responses 配置测试 Kimi Code使用 OpenAI Responses 配置测试 Kimi Code

Anthropic Messages ​

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

toml
default_model = "packy_anthropic"

[providers.packy_anthropic]
type = "anthropic"
base_url = "https://ouraic.cn"
api_key = "sk-替换为你的API令牌"

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

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

配置文件效果如下：

Kimi Code 的 Anthropic Messages 配置Kimi Code 的 Anthropic Messages 配置

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

使用 Anthropic Messages 配置测试 Kimi Code使用 Anthropic Messages 配置测试 Kimi Code

常见问题 ​

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

  • default_model 是否与 [models.<名称>] 完全一致。
  • [models.<名称>].provider 是否与 [providers.<名称>] 完全一致。
  • 模型 ID 是否属于当前令牌分组，并支持所选请求协议。
  • OpenAI Chat / Responses 的地址是否以 /v1 结尾。
  • Anthropic 的地址是否没有手动添加 /v1 或 /v1/messages。

官方配置参考 ​

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

最近更新: 2026/8/29 07:31贡献者: z-zodiac

基于 AI.c 中转服务整理的使用文档

AI.c