Kimi Code

Kimi Code CLI 是 Moonshot AI 的终端编程 Agent。把 ApiGo 注册为 Kimi provider 后,Kimi Code 即可使用你的 ApiGo Key、kimi-k3 模型、工作空间限额与调用日志。

前置条件

1. 安装 Kimi Code

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

打开新的终端,确认命令可用:

kimi --version

2. 配置 ApiGo

创建或编辑 ~/.kimi-code/config.toml。如果文件中已有其它 provider 或模型,请合并下面的配置,不要直接覆盖原文件。

default_model = "kimi-k3"
default_permission_mode = "auto"
default_plan_mode = false
merge_all_available_skills = true
telemetry = true

[providers."managed:apigo"]
type = "kimi"
base_url = "https://api.apigo.ai/v1"
api_key = "sk-apg-..."

[models."kimi-k3"]
provider = "managed:apigo"
model = "kimi-k3"
max_context_size = 1048576
capabilities = [ "thinking", "always_thinking", "image_in", "video_in", "tool_use" ]
display_name = "K3"
support_efforts = [ "max" ]
default_effort = "max"

这份配置已在 ApiGo 完成实测。Provider 名称 managed:apigo 是本地别名,模型配置中的 provider 必须引用同一个值。

Kimi Code 会把 api_key 以明文保存在该文件中。保存后限制文件权限:

chmod 700 ~/.kimi-code
chmod 600 ~/.kimi-code/config.toml

default_permission_mode = "auto" 会让 Agent 无需逐项询问即可执行工具操作。如果你希望每次手动批准,请改为 manual

3. 启动并验证

进入项目目录后启动 Kimi Code:

cd /path/to/your/project
kimi

使用 /model 确认当前选择的是 K3。随后发送一条短提示,或用单次命令验证:

kimi -p '只回复 APIGO_KIMI_OK,不要输出其它内容。'

配置成功时会输出:

APIGO_KIMI_OK

随后到 工作空间 → Call Logs 核对请求。

配置速查

配置项 用途
配置文件 ~/.kimi-code/config.toml 保存 Kimi Code 运行时、provider 与模型设置
Provider 类型 kimi 使用 Kimi Code 的 OpenAI 兼容 provider 实现
Provider 别名 managed:apigo 把模型配置关联到 ApiGo provider
Base URL https://api.apigo.ai/v1 ApiGo OpenAI 兼容网关前缀
模型别名与 slug kimi-k3 选择 ApiGo K3 模型
上下文长度 1048576 声明模型的 100 万 Token 上下文窗口
思考强度 max 使用该模型支持的最高思考强度

常见问题

现象 处理方式
启动时提示配置错误 运行 kimi doctor,确认文件是有效 TOML
401 / 403 更换有效的 ApiGo Key,并检查所属工作空间权限与消费上限
模型不存在 确认两个模型字段均为 kimi-k3,并核对当前 ApiGo 模型目录
Kimi Code 没有读取该文件 检查 KIMI_CODE_HOME 是否指向了其它数据目录
Kimi Code 仍询问工具授权 确认 default_permission_modeauto;如需逐项确认则使用 manual
Call Logs 没有请求 确认 provider 使用 https://api.apigo.ai/v1,且 /model 显示 K3

相关资源