官方文档 + CLI 实测 · 截至 2026-11-10

Kimi Code CLI 自定义模型怎么接?config.toml 接入 Claude、GPT 与国产模型(2026 年 11 月)

能。截至 2026-11-10,Kimi Code CLI 官方文档《平台与模型》写明:在 ~/.kimi-code/config.toml 里为每条协议加一个 providers 表,type 取 anthropic、openai 或 openai_responses,也可以在 TUI 里输入 /provider 管理。按 Kimi Code CLI 2.5.2 实测,不登录 Kimi 账号即可调用 QCode:anthropic 填 https://api.qcode.cc/api 接 Claude,openai 填 https://api.qcode.cc/openai/v1 接 GPT 与国产型号,openai_responses 同样填 https://api.qcode.cc/openai/v1 接 GPT,三种都通过;用 api_key_env 从环境变量读 Key,配置文件里不写密钥。

更新于 2026-11-10

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#Kimi Code 自定义模型#kimi-code config.toml#不必登录 Kimi#CLI 2.5.2 实测

四条要点:官方文档与 2026-11-10 实测

3 种 type

CLI 2.5.2 实测都通过

截至 2026-11-10,按 Kimi Code CLI 2.5.2 实测:anthropic 配 https://api.qcode.cc/api(claude-haiku-5-5),openai 配 https://api.qcode.cc/openai/v1(deepseek-v4-flash),openai_responses 配同一地址(gpt-6.1-terra),三组都正常返回,全程没有执行 kimi login。

/v1

OpenAI 地址带 /v1,Anthropic 停在 /api

anthropic 的 base_url 写到 https://api.qcode.cc/api,openai 与 openai_responses 写到 https://api.qcode.cc/openai/v1,不要再补 /v1/messages、/chat/completions 或 /responses,也不留结尾斜杠。官方 openai 与 openai_responses 的默认 base_url 都是 https://api.openai.com/v1,改成 QCode 地址即可。

api_key_env

配置文件里不写 Key

api_key_env 填环境变量名,CLI 每次请求时重新读取;它与 api_key 互斥,只能设一个,api_key 会以明文写进文件。官方写明:除显式声明的 api_key_env 外,CLI 不会从 shell 环境变量自动取凭证,单独 export 一个变量不会让任何服务商拿到 Key。

2.5.2

截至 2026-11-10 的 CLI 版本

CLI 更新日志最新一条是 2.5.2(2026-11-06),npm 上 @moonshot-ai/kimi-code 的最新版本也是 2.5.2;桌面端更新日志最新一条是 1.3.2(2026-11-06)。本页的接入实测用的是 CLI 2.5.2。

Kimi Code CLI 能不能接别家的模型 API?

能。截至 2026-11-10,Kimi Code CLI 是 Moonshot AI 跑在终端里的编程 Agent,官方 README 写明它开箱即用 Kimi 模型,也可以配置成使用其他兼容的服务商;入门文档写:要接 Anthropic、OpenAI、Google 或其他服务商,直接编辑 ~/.kimi-code/config.toml 配置 API Key,详见《平台与模型》。type 一共有 6 个取值:kimi、anthropic、openai、openai_responses、google-genai、vertexai,QCode 的三种协议正好对应其中三个——anthropic 接 Claude,openai 接 GPT 与国产型号,openai_responses 接 GPT,所以一把 QCode Key 就能在同一个工具里同时用 Claude、GPT 与国产模型。Gemini 系列 QCode 暂不提供,请改用 Claude、GPT 或国产模型。本页讲 CLI;Kimi Code Desktop 与 CLI 共用 ~/.kimi-code/ 目录,桌面端的情况见下方常见问题。Kimi Work 是另一款产品,见 /kimi-work-guide。

截至 2026-11-10:CLI 2.5.2 与桌面端 1.3.2,均发布于 2026-11-06

截至 2026-11-10,Kimi Code CLI 更新日志最新一条是 2.5.2(2026-11-06),npm 上 @moonshot-ai/kimi-code 的最新版本也是 2.5.2;桌面端更新日志最新一条是 1.3.2(2026-11-06)。官方「最新动态」页写明,Kimi Code CLI 使用 ~/.kimi-code/config.toml,与早期 kimi-cli 的 ~/.kimi/config.toml 格式不兼容,kimi migrate 可以一步迁移旧版的配置、会话与 MCP 声明;按旧文件写的教程不适用于现行配置。同日按 Kimi Code CLI 2.5.2 实测,三种 type 都能调用 QCode。

时间线

2026-11-06

Kimi Code CLI 2.5.2 记入官方更新日志。

2026-11-06

Kimi Code Desktop 1.3.2 记入桌面端更新日志。

2026-11-10

按 Kimi Code CLI 2.5.2 实测:anthropic、openai、openai_responses 三种 type 都调用 QCode 成功,全程没有执行 kimi login。

官方文档写明的,和由 2026-11-10 实测补上的

Kimi Code 官方文档写明的

① type 共 6 个取值:kimi、anthropic、openai、openai_responses、google-genai、vertexai。anthropic 用于连接 Claude API;openai 用于 OpenAI Chat Completions 协议及任何兼容该协议的第三方服务,按需覆盖 base_url;openai_responses 是 OpenAI 较新的 Responses 接口,始终以流式工作,配置与 openai 相同。② 凭证:api_key 与 api_key_env 互斥,只能设一个;api_key 以明文写在配置文件里,api_key_env 每次请求时重新读取。除显式声明的 api_key_env 外,CLI 不会从 shell 环境变量自动取凭证。③ 每条模型别名都要写 provider、model 和 max_context_size(至少为 1);含点号的别名要加引号,例如 [models."qwen3.8-max"];default_model 必须是已定义的别名。④ 配置文件首次运行时自动创建;KIMI_CODE_HOME 改数据根目录,文件名仍是 config.toml;目前只有单一用户级配置文件,没有项目级配置机制。⑤ 在 TUI 里输入 /provider 打开服务商管理,kimi provider 是它在终端里的非交互等价命令;用 /login 登录的 Kimi Code 托管账号不出现在 /provider 里。⑥ kimi -p 以非交互方式跑一条提示词、不打开 TUI;-m 指定本次启动的模型别名,省略时用 default_model。⑦ kimi doctor 检查 config.toml 与 tui.toml,不启动 TUI、不修改文件;全部有效或跳过时退出码为 0,有缺失或无效时为 1;/reload 会重新加载这两个文件。⑧ 桌面端与 CLI 可以装在同一台机器上并共享部分本地配置,~/.kimi-code/ 存放配置、账号凭证、会话与日志,与 CLI 共享。

文档没写清、由 2026-11-10 实测补上的

截至 2026-11-10,按 Kimi Code CLI 2.5.2 实测:① 不需要登录 Kimi 账号:只写 ~/.kimi-code/config.toml、不执行 kimi login,三种 type 都正常返回;kimi login 与 /login 是登录 Kimi Code 托管服务用的。② base_url 写到前缀就停:anthropic 填 https://api.qcode.cc/api、openai 与 openai_responses 填 https://api.qcode.cc/openai/v1 都通过,后面的接口路径由 SDK 自己补。③ 国产型号这次挂在 type 为 openai 的服务商上(deepseek-v4-flash),与 QCode 接入文档的写法一致。④ 官方配置说明把 auto_session_title 列为顶层字段,2.5.2 的 kimi doctor 会提示 Unknown top-level key ignored by the v2 engine: auto_session_title.——只是警告,配置仍判定有效,删掉这一行即可。

自定义服务商与 /login 托管账号:接 QCode 用前者

自定义服务商:写 config.toml

在 ~/.kimi-code/config.toml 里加 type 为 anthropic、openai 或 openai_responses 的服务商,base_url 填 QCode 地址,api_key_env 指向存放 Key 的环境变量。截至 2026-11-10 按 Kimi Code CLI 2.5.2 实测三种都通过,不需要 kimi login;配好后可用 kimi provider list 或 TUI 的 /provider 查看。

/login:Kimi Code 托管服务

/login(终端命令是 kimi login)登录 Kimi Code 托管服务,官方写明登录后会自动配置 base_url 与凭证;type 为 kimi 的服务商默认 base_url 是 https://api.moonshot.ai/v1。这类托管账号不出现在 /provider 里,用 /login 与 /logout 管理。

怎么在 Kimi Code CLI 里接 QCode

① 安装: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,脚本不需要预装 Node.js(README 提醒 Windows 首次启动前先装 Git for Windows);也可以 npm install -g @moonshot-ai/kimi-code,这条需要 Node.js 22.19.0 或更高。② 编辑 ~/.kimi-code/config.toml,加三个服务商:qcode-anthropic 的 type 填 anthropic、base_url 填 https://api.qcode.cc/api;qcode-openai 的 type 填 openai、base_url 填 https://api.qcode.cc/openai/v1;qcode-responses 的 type 填 openai_responses、base_url 同样填 https://api.qcode.cc/openai/v1;三个都写 api_key_env,值为 QCODE_API_KEY。③ 每个模型写一条别名:qcode-haiku 指向 qcode-anthropic、model 填 claude-haiku-5-5;qcode-dsflash 指向 qcode-openai、model 填 deepseek-v4-flash;qcode-terra 指向 qcode-responses、model 填 gpt-6.1-terra。每条都写 max_context_size(按该模型的上下文长度填),再把 default_model 设成其中一个别名。④ export QCODE_API_KEY=cr_xxx,然后运行 kimi -p 加一句短提示,用 -m 选别名(省略时用 default_model),能正常回复即配通。⑤ 用 kimi doctor 检查配置文件、kimi provider list 查看已登记的服务商;改完文件重启 kimi,或在会话里执行 /reload。

用一把 QCode Key 跑 Kimi Code CLI

截至 2026-11-10,一把 QCode API Key 同时提供 Anthropic 与 OpenAI 两种兼容接口,正好对上 Kimi Code CLI 的三种 type:Claude 走 anthropic + https://api.qcode.cc/api,GPT 走 openai 或 openai_responses + https://api.qcode.cc/openai/v1,GLM、Kimi、DeepSeek、Qwen 走 openai。按 token 计费,各模型单价见 /models,常用型号有 claude-sonnet-5-5、claude-opus-5-5、claude-haiku-5-5、gpt-6.1-sol、gpt-6.1-terra、deepseek-v4.1-flash、glm-5.3、kimi-k3、qwen3.8-max。亚洲与北美接入点把域名换成 asia.qcode.cc 或 us.qcode.cc,路径不变,同一把 Key 通用。三步开始:① 注册并充值(支持支付宝等主流支付方式);② 购买个人套餐或按量包,复制以 cr_ 开头的 API Key;③ 按上文写入 ~/.kimi-code/config.toml,QCode 文档 https://docs.qcode.cc/docs/ide/kimi-code 有完整文件。不想包月?按量包(/pay-as-you-go)¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。

常见问题

Kimi Code CLI 能用 Claude 吗?

能。Kimi Code CLI 的自定义服务商支持 Anthropic 协议:type 设为 anthropic,base_url 填 QCode 的 https://api.qcode.cc/api,模型别名的 model 填 claude-sonnet-5-5、claude-opus-5-5 或 claude-haiku-5-5,即可调用 Claude 型号。截至 2026-11-10,按 Kimi Code CLI 2.5.2 实测,claude-haiku-5-5 正常返回。Claude 型号放在 anthropic 服务商下;GPT 与国产型号放在 openai 服务商下(https://api.qcode.cc/openai/v1)。

config.toml 在哪、怎么写?

在 ~/.kimi-code/config.toml,首次运行时自动创建;设了 KIMI_CODE_HOME 时在那个目录下,文件名仍是 config.toml,目前没有项目级配置文件。文件里是两类表:每个 providers 表写 type、base_url 和 api_key_env(或 api_key,二选一);每个 models 别名写 provider、model 和 max_context_size。别名含点号要加引号,如 [models."qwen3.8-max"];default_model 填一个已定义的别名。不想手改文件时,可在 TUI 里用 /provider,或在终端用 kimi provider。

base_url 要不要带 /v1?

OpenAI 的要带,Anthropic 的不带:openai 与 openai_responses 填 https://api.qcode.cc/openai/v1,anthropic 填 https://api.qcode.cc/api。截至 2026-11-10,按 Kimi Code CLI 2.5.2 实测,这三种填法都通过。填到这里就停,不要再补 /v1/messages、/chat/completions 或 /responses,也不留结尾斜杠,接口路径由 SDK 自己拼。报 404 时,先检查 base_url 是否多写或少写了一段。

要登录 Kimi 账号吗?

不用。截至 2026-11-10,按 Kimi Code CLI 2.5.2 实测,只写 ~/.kimi-code/config.toml、用 api_key_env 提供 QCode Key,没有执行 kimi login,三种 type 都正常返回。kimi login 与 /login 是登录 Kimi Code 托管服务用的,接 QCode 不需要。

Kimi Code 桌面端能加自定义服务商吗?

桌面端设置面板里有「模型供应商」区域,用来管理模型与服务商。官方桌面端文档写明,Kimi Code Desktop 与 CLI 可以装在同一台机器上并共享部分本地配置,~/.kimi-code/ 存放与 CLI 共享的配置、账号凭证、会话与日志;具体共享范围以各自的设置项和配置文件为准。官方没有给出桌面端逐字段的填写说明,所以上文的步骤是 CLI 的 config.toml 写法。截至 2026-11-10,桌面端更新日志最新为 1.3.2(2026-11-06)。

Kimi Work 和 Kimi Code 有什么区别?

是两款产品。Kimi Work 是 Moonshot 的本地桌面知识工作 Agent,处理文件夹、浏览器自动化与定时任务,介绍见 /kimi-work-guide;Kimi Code 是编程工具,本页讲的是它的 CLI 怎么在 ~/.kimi-code/config.toml 里接自定义服务商。想在 Claude Code 里调 DeepSeek、GLM、Kimi、Qwen,见 /claude-code-deepseek-glm-kimi-qwen。

资料来源

Kimi Code:kimi.com 上的《平台与模型》、入门、kimi 命令、环境变量、配置覆盖、最新动态、CLI 与桌面端更新日志、桌面端设置页,GitHub 上 MoonshotAI/kimi-code 的 README 与配置文件说明,npm 上 @moonshot-ai/kimi-code 的最新版本,均于 2026-11-10 读取。QCode:接入点与 API 格式文档、Kimi Code CLI 接入文档、qcode.cc/models 的在售型号。实测:Kimi Code CLI 2.5.2,2026-11-10。

用一把 Key 跑 Kimi Code CLI

把一把 QCode API Key 写进 Kimi Code CLI 的自定义服务商:anthropic 接 Claude,openai 接 GPT 与国产型号,openai_responses 接 GPT;按 token 计费,各模型单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79