# Kimi Code 接入

Kimi Code 是独立应用，应用 ID 为 `kimi`。接入面向当前的 [MoonshotAI/kimi-code](https://github.com/MoonshotAI/kimi-code)，使用 `~/.kimi-code`；已归档的 Python Kimi CLI 使用 `~/.kimi`，其数据迁移由 Kimi Code 的 `kimi migrate` 完成。

## 使用方式

1. 在「应用」页安装 Kimi Code，或先按[官方说明](https://moonshotai.github.io/kimi-code/en/guides/getting-started)安装。CC Switch 使用官方独立程序安装器，自带运行时，不依赖系统 Node 版本；已有客户端升级使用 `kimi upgrade --yes`，静态兜底重跑官方安装器。手动使用 npm 包 `@moonshot-ai/kimi-code` 时需满足其 Node 要求，2.3.0 要求 Node ≥22.19.0，Node 22.12.0 会因缺少 `createZstdDecompress` 无法启动。
2. 在侧栏选择 **Kimi Code**。已有原生供应商和模型会自动出现在列表中。
3. 使用编程套餐时，在「授权中心」的 **Kimi Code** 分组中添加账号，完成授权后自动添加模型；「添加供应商」的「账号登录 → Kimi Code 官方登录」也可进入该分组。支持同时登录多个官方账号。使用 API Key 时，和 Pi 等应用一样，从「模型厂商」「第三方平台」「云服务商」「本地」分组中选择具体供应商，或使用各组共用的「自定义配置」。预设保留厂商的套餐、地区版本、模型参数、请求头和获取 API Key 的链接，并转换为 Kimi 原生字段。「模型厂商」中的 **Kimi** 包含开放平台、编程套餐及国内／海外版本。每个模型必须填写模型 ID 和正整数的上下文长度。
4. 和 Pi、Hermes 一样，卡片分「已添加」「未添加」两组。点击「添加」只将供应商及模型写入 Kimi 配置、不改变当前模型，之后可在 Kimi Code 的 `/model` 中直接选用；多个供应商可以同时添加。已添加卡片「更多」菜单中的「设为默认」会选择该供应商的模型，当前供应商以蓝色「默认」标识，与 OpenCode 一致。已有当前模型属于目标供应商时保留该模型，否则选择目标供应商的第一个原生模型；需要切换到其他具体模型时，可在 Kimi Code 内使用 `/model`。没有默认模型时，首次添加会选择该供应商的第一个模型。
5. 已添加卡片上的「移除」会从原生配置移除供应商和所属模型（卡片回到「未添加」），并保留 CC Switch 中的档案。正在使用的供应商、主模型或子代理模型池仍引用的模型不能移除，需要先在 Kimi Code 中调整选择。仍在原生配置中的官方 OAuth 节点禁止通过供应商页编辑、删除和移除，账号的添加、重新登录和删除统一在授权中心操作；原生节点已被 Kimi 移除时，可删除 CC Switch 中留下的档案，独立账号的本机凭据随之删除。

## 配置与能力

| 能力 | 原生位置／行为 |
| --- | --- |
| 供应商和模型 | `~/.kimi-code/config.toml` 的 `providers`、`models` 表 |
| 官方 OAuth | 授权中心支持多个账号，设备码授权；每个账号独立保存凭据和供应商，按账号显示昵称和额度 |
| 协议 | `kimi`、`openai`、`openai_responses`、`anthropic`、`google-genai`、`vertexai` |
| 模型能力 | 提供图片输入、思考、始终思考、工具调用、按需加载工具的配置；音视频等其他能力由 Kimi 原生管理，已有字段原样保留 |
| 供应商目录 | 复用已维护的 Pi 供应商信息并转换为 Kimi 原生协议和模型字段；AWS Bedrock 的专有签名协议不兼容，不提供该预设 |
| MCP | `~/.kimi-code/mcp.json`，支持 stdio、HTTP、SSE；SSE 使用原生的 `transport = "sse"` 字段 |
| Skills | `~/.kimi-code/skills/`，通过统一 Skills 页面管理 |
| 全局提示词 | `~/.kimi-code/AGENTS.md`，通过统一提示词页面管理 |
| 会话 | `~/.kimi-code/sessions/<workDirKey>/<sessionId>/state.json` 和 `agents/main/wire.jsonl` |
| 恢复会话 | `kimi --session <id>`，保留原工作目录和数据目录 |
| 用量 | 从已提交的 assistant 消息导入输入／输出和缓存 token，按 `step.end.messageId` 关联 `llm.request` 中的实际模型；使用项目价格表估算费用 |

设置环境变量 `KIMI_CODE_HOME` 后，上述位置全部跟随该目录。CC Switch 进程需要继承这个环境变量。

Kimi 使用原生多供应商配置，因此此接入采用共存模式。当前不提供 CC Switch 的本地路由或聚合模式。

Ollama、LM Studio 和 vLLM 预设使用各自的本地 OpenAI 兼容地址，并预填 `local` 占位 Key，供默认不校验凭据的服务使用；服务器已开启鉴权时应替换为实际 Key。模型 ID 和上下文长度需要与本机已加载的模型一致。Microsoft Foundry 的资源名占位符需要改为自己的资源名。

## 官方 OAuth 登录

官方账号供应商使用 Kimi 图标并带有「官方」徽标。默认账号沿用原生 `managed:kimi-code` 供应商，显示为 **Kimi Official**；其余账号的供应商 ID 取 `Kimi 订阅 <昵称>`（英文界面为 `Kimi Subscription <昵称>`，与 Kimi Code 给自己默认登录写死的「Kimi 订阅」并列；Kimi Code 把供应商 ID 当名称显示在模型选择器的分组上；只保留字母、数字、`-`、`_` 和空格，重名时补序号），卡片显示为 **Kimi Official · 昵称**；读不到昵称时退回 `kimi-code-ccs-<标识>`。供应商 ID 在创建后不随昵称改动；两台设备上昵称不同时会各得一个 ID。已有原生登录保持原 ID、模型别名和凭据引用，自动显示在授权中心；导入时补齐名称、图标和官方分类，自定义显示信息保留。

打开「授权中心」的 **Kimi Code** 分组，选择国内版或海外版后点击「登录 Kimi」或「添加账号」，在浏览器中输入授权码并确认。若浏览器没有自动打开，可使用页面上的授权链接和复制授权码按钮。「添加供应商 → 账号登录 → Kimi Code 官方登录」提供「管理 Kimi 账号」入口，进入同一个授权中心。此流程无需填写 API Key、模型或 JSON 配置，也不显示普通供应商表单的「添加」按钮。

登录区域固定对应以下官方地址，设备码申请、令牌交换和模型发现使用同一组地址，不自动跨区回退：

| 登录区域 | 授权主机 | 模型 API |
| --- | --- | --- |
| 国内版 | `https://auth.kimi.com` | `https://api.kimi.com/coding/v1` |
| 海外版 | `https://auth.kimi.ai` | `https://api.kimi.ai/coding/v1` |

授权成功后，CC Switch 从官方 `/models` 获取该账号的模型和能力。原生默认供应商不存在或其凭据文件缺失时，新登录沿用 `managed:kimi-code` 和官方默认 OAuth 引用，模型别名为 `kimi-code/<模型 ID>`；默认登录已存在时，新增账号使用独立供应商和 `<供应商 ID>/<模型 ID>` 模型别名。缺失的联网搜索和抓取服务也会添加。已有默认模型、用户别名、模型 overrides、自定义服务及其他账号配置会保留；没有默认模型时首次登录会选中该账号的模型。配置或凭据保存失败时恢复原配置，可点击「重试」继续完成当前授权。

凭据按官方格式保存在 `~/.kimi-code/credentials/`，仅后端读写，不进入供应商档案或前端响应。原生国内默认登录使用 `kimi-code.json`，海外版按官方规则选择独立的默认槽位；其余账号各自使用 `kimi-code-ccs-<8 位标识>.json`（标识由区域和账号 ID 算出，同一账号在不同设备上相同；早期版本创建的 UUID 槽位照常识别），模型别名也以这个槽位名为前缀（如 `kimi-code-ccs-<标识>/k3`），`default_model` 始终是 ASCII 键；认同一个账号时既看本机身份缓存，也看凭据槽位名，通过供应商的 `oauth.key` 与 `oauth.oauth_host` 引用。`KIMI_CODE_HOME` 仍用于选择数据目录；CC Switch 登录不使用 `KIMI_CODE_OAUTH_HOST`、`KIMI_OAUTH_HOST` 或 `KIMI_CODE_BASE_URL` 覆盖所选区域的地址。重新登录已有账号时保持该账号的区域与凭据槽位，使用该区域的固定官方地址。CC Switch 只在查询额度、令牌快过期时刷新，刷新前拿 Kimi 同款的凭据锁（`oauth/<槽位>.lock` 目录，5 秒未更新视为失效），锁内重读凭据，与 Kimi Code 不会同时轮换 refresh token；刷新被拒时按 Kimi 的规则先重读，别的进程已换新就沿用，否则写入作废标记、该账号需重新登录。Windows 上 Kimi Code 不加锁，CC Switch 也不刷新，令牌过期时额度提示先在 Kimi Code 里用一次该账号。登录、删除写凭据时同样持锁。

网络请求沿用 CC Switch 的全局出站代理设置。连接失败时显示授权主机及底层 DNS、TCP、TLS 或超时原因，便于核对系统代理和网络连接。

授权中心列出每个账号的昵称、登录状态、区域和额度，支持刷新、取消、逐账号重新登录、删除和「使用此账号」。登录后 CC Switch 用 `/me` 读取账号 ID 和昵称，缓存在本机的 `kimi_accounts.json`（不随云同步）；登录到已有账号时写回该账号原来的槽位，不新增账号，凭据槽位在授权完成时才确定。独立账号的模型显示名带上昵称，便于在 Kimi Code 的模型列表中区分。点击「使用此账号」或供应商卡片上的「设为默认」只选择该账号的对话模型，不改写服务配置；切换前检查该账号在本机有可用登录（从其他设备同步来的卡片需先在授权中心登录）。官方卡片打开 Kimi 页面时会顺带读取账号身份，卡片名随即带上昵称，不必先进授权中心。Kimi Code 2.3.0 的联网搜索和抓取使用原生默认凭据槽位，不随对话账号切换。重新登录更新该账号的模型目录和凭据，不创建另一个供应商，并保留供应商节点上的自定义字段（如 `custom_headers`）。删除独立账号会移除它的供应商节点、模型、本机凭据和卡片，正在使用的账号需先切走再删除；联网搜索或抓取若指向被删账号，改指 Kimi Code 自己的默认登录。Kimi Code 自己的默认登录只能「移出列表」：CC Switch 不替 Kimi 退出登录，凭据和模型保留，之后重新登录或默认槽位换成另一个账号时重新显示（列表因此为空时，状态显示「已移出列表」而非「未登录」）；需要退出请在 Kimi Code 中运行 `/logout`。一个账号的凭据损坏或使用钥匙串时，仅在该账号行显示错误，不影响其他账号。

协议及存储格式依据：[官方 OAuth 实现](https://github.com/MoonshotAI/kimi-code/tree/44cdf8f4039e2ff20d3fe8a4e7868bd90fd786e1/packages/oauth/src)。

## 数据保留规则

- 编辑供应商只修改对应的供应商节点和所属模型，保留其他供应商、全局设置、服务配置及未修改表的 TOML 注释。
- 原生模型键全局唯一。发现同名键属于另一个供应商时，拒绝覆盖。复制供应商时会生成新的模型别名，并先保存为未启用档案。
- 原生配置在外部变化后，刷新列表会更新同 ID 档案；原生节点被删除时，档案仍保留，状态变为未启用，可在 CC Switch 中删除该档案。
- CC Switch 不提供音视频能力开关，也不在预设中主动声明这些能力。原生模型及其 `overrides` 中的音视频、输出能力和未知能力字段在导入、编辑及保存时原样保留，由 Kimi 解释；图片输入和语言模型能力仍可在界面配置。
- Kimi 原生 Skills 目录可能包含用户自行安装的同名 Skill。重新同步、存储迁移及卸载未对 Kimi 启用的受管 Skill 时保留这些目录；显式启用、停用或更新时，只操作能确认为 CC Switch 部署的副本。
- 无法解析的 TOML／MCP JSON 会报错并保留原文件。供应商和 MCP 的原生写入与数据库保存之间发生失败时，恢复写入前的文件。
- 会话阅读优先使用原生日志中的已提交消息，避免与执行过程记录重复；分支切换后仅展示活动分支。会话删除在 Kimi Code 中完成，以保持会话索引、锁和历史记录一致。
- 用量使用日志中当时的模型，不从当前供应商推断历史归属。缺少模型时记为 `unknown`；缺少价格时费用为 `0`，并不表示免费。持久去重记录防止重复导入已汇总清理的请求或复制到分支中的历史请求。
- 首字读取 `step.end` 的原生计时，耗时优先使用首字等待与流式输出时长之和，排除后续工具执行；旧日志缺少原生计时时仅在起止时间可靠时估算耗时，已完成的内容块不能用于推断首字。速度沿用会话日志口径：输出 token ÷ 总耗时（含首字等待），输出至少 200 token、耗时至少 1 秒才显示，并带估算标记。
- 用量按日志变化进行增量同步；同一次请求稍后补齐的模型和计时会更新到仍保留的明细中。请求 ID 和持久去重记录保持稳定，已汇总清理的历史不会重复导入。

原生格式依据：[配置文件](https://moonshotai.github.io/kimi-code/en/configuration/config-files)、[数据位置](https://moonshotai.github.io/kimi-code/en/configuration/data-locations)、[MCP](https://moonshotai.github.io/kimi-code/en/customization/mcp)。