Kimi Code
Kimi Code CLI 是 Moonshot AI 的终端编程 Agent。把 ApiGo 注册为 Kimi provider 后,Kimi Code 即可使用你的 ApiGo Key、kimi-k3 模型、工作空间限额与调用日志。
前置条件
- 已安装 Kimi Code CLI
- 已在 工作空间 → API Keys 创建 ApiGo API 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_mode 为 auto;如需逐项确认则使用 manual |
| Call Logs 没有请求 | 确认 provider 使用 https://api.apigo.ai/v1,且 /model 显示 K3 |
