跳转到内容
NoviaHub 文档

命令行 Agent

Kimi Code

在 Kimi Code CLI 的 config.toml 里添加 NoviaHub 作为 OpenAI 兼容服务商。

Kimi Code CLI 是 Moonshot AI（月之暗面）推出的终端 AI Agent。官方介绍：它运行在终端里，帮你完成软件开发和日常终端操作，包括读取和修改代码、运行命令、搜索文件、抓取网页，并根据反馈自主规划下一步。它用 TypeScript 编写，通过 npm 分发。

前提条件

Section titled “前提条件”
  • 有一个 NoviaHub 账户，并且已经创建了 API 密钥，见 API 密钥。
  • 账户里有余额，见 钱包与充值。

安装 Kimi Code CLI

Section titled “安装 Kimi Code CLI”

官方推荐用安装脚本，不需要事先装 Node.js：

终端窗口
curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

配置 NoviaHub

Section titled “配置 NoviaHub”

Kimi Code CLI 里的「服务商」（provider）决定用哪种协议、连到哪里；「模型」（model）是建在服务商上的别名。下面把 NoviaHub 添加为一个使用 OpenAI Chat Completions 协议的服务商。

  1. 把密钥保存到环境变量 NOVIAHUB_API_KEY。

    终端窗口
    # macOS 默认用 zsh；Linux 用 bash 的话把 ~/.zshrc 换成 ~/.bashrc
    echo 'export NOVIAHUB_API_KEY="sk-..."' >> ~/.zshrc
    source ~/.zshrc

  2. 编辑配置文件 ~/.kimi-code/config.toml。这个文件在第一次运行 kimi 时会自动创建；没有的话自己新建。加入下面的内容：

    ~/.kimi-code/config.toml
    default_model = "noviahub/deepseek-v4-flash"
    

    [providers.noviahub]
    type = "openai"
    base_url = "https://noviahub.com/v1"
    api_key_env = "NOVIAHUB_API_KEY"
    

    [models."noviahub/deepseek-v4-flash"]
    provider = "noviahub"
    model = "deepseek-v4-flash"
    max_context_size = 1000000
    配置项 作用
    default_model 新会话默认使用的模型别名，必须是下面 [models."..."] 里定义过的。文件里原来已有 default_model 的话，直接改它的值，不要写两行。
    type 协议。openai 表示 OpenAI Chat Completions。
    base_url 接口地址，要带 /v1：https://noviahub.com/v1。
    api_key_env 从哪个环境变量读取密钥。每次请求都会重新读取。
    [models."noviahub/deepseek-v4-flash"] 模型别名。名字里有 /，所以要用引号括起来。
    provider 使用哪个服务商，对应上面的 [providers.noviahub]。
    model 发给 NoviaHub 的模型 ID，必须和 NoviaHub 上的模型 ID 完全一致。
    max_context_size 必填，模型的上下文长度（tokens）。在 模型&价格 的模型详情里看「上下文」一栏；deepseek-v4-flash 在 2026-09-28 标注为 1,000,000。

  3. 检查配置文件：

    终端窗口
    kimi doctor

    它只检查 config.toml 和 tui.toml 是否有效，不会启动界面，也不会修改文件。

  4. 运行 kimi 启动。新会话会使用 default_model 指定的模型。

验证

Section titled “验证”

  1. 用非交互模式发一句话，输出会直接打印在终端里：

    终端窗口
    kimi -p "用一句话介绍你自己"

  2. 也可以运行 kimi provider list 查看已配置的服务商。

  3. 到 NoviaHub 控制台的 使用日志 查看这次调用和费用。

切换和添加模型

Section titled “切换和添加模型”
  • 添加模型：再写一段 [models."别名"]，provider 填 noviahub，model 填 NoviaHub 的模型 ID，max_context_size 填该模型的上下文长度。
  • 切换模型：在界面里运行 /model；或者启动时指定别名，例如 kimi -m noviahub/deepseek-v4-flash。
  • 选哪些模型：type = "openai" 走 Chat Completions 接口，请选择在 模型&价格 上带有「Chat」标签的模型。2026-09-28 线上的全部模型都带有这个标签。
  • 使用 Responses 接口：Kimi Code CLI 也支持 type = "openai_responses"（OpenAI Responses 接口，配置写法和 openai 相同）。只有模型详情里带「Response」标签的模型才能用这种服务商。

注意事项

Section titled “注意事项”
  • /login 只用于登录 Kimi Code 官方服务或填写 Kimi 开放平台的 API Key，不用于接入 NoviaHub。接入 NoviaHub 按上面编辑 config.toml 即可。
  • api_key 和 api_key_env 只能二选一。api_key 会把密钥明文写进配置文件，不建议使用。
  • 想把数据目录放到别处，可以设置环境变量 KIMI_CODE_HOME，这时配置文件路径变成 $KIMI_CODE_HOME/config.toml。

参考资料

Section titled “参考资料”

以下资料查阅于 2026-09-28：