JPwise-docs

Appearance

Kimi Code 使用手册 ​

Kimi Code 是 Moonshot AI（月之暗面）推出的 AI 编程助手，基于 Kimi K2.5 万亿参数多模态大模型。本手册聚焦 VS Code 插件 使用方式，同时介绍通过 Claude Code 插件 兼容调用 Kimi 模型的方法。

目录 ​

  1. 注册与账号
  2. 使用方式一：Kimi Code VS Code 插件
  3. 使用方式二：Claude Code 插件兼容模式
  4. 聊天面板与交互
  5. 文件引用与多模态输入
  6. 斜杠命令
  7. 快捷键
  8. 文件变更与 Diff 管理
  9. 深度思考模式
  10. MCP 扩展
  11. 项目配置
  12. 操作确认与安全
  13. 订阅套餐
  14. 常见问题

1. 注册与账号 ​

1.1 注册方式 ​

Kimi Code 使用 Kimi 统一账号体系，通过官网订阅 Coding Plan 即可使用：

方式入口说明
官网注册https://www.kimi.com/code访问官网，选择 Coding Plan 套餐后完成注册/登录

1.2 注册流程 ​

  1. 访问 https://www.kimi.com/code
  2. 点击"开始使用"或选择订阅套餐
  3. 使用 手机号 注册（支持中国大陆手机号），或使用已有 Kimi 账号登录
  4. 完成手机验证码验证
  5. 选择合适的 Coding Plan 套餐（新用户可选 4.9 元 7 天试用）
  6. 支付完成后即可使用

1.3 获取 API Key ​

登录后进入 Kimi Code 会员页面，创建专属 API Key 并保存。API Key 用于：

  • 在 Kimi Code VS Code 插件中免登录使用
  • 在 Claude Code 插件中配置 Kimi 兼容模式

1.4 账号管理 ​

  • 登录后可在控制台管理 API Key 与 授权设备
  • 设备授权有效期为 30 天，超期需重新登录

2. 使用方式一：Kimi Code VS Code 插件 ​

2.1 安装 ​

  1. 打开 VS Code
  2. 进入扩展市场（Ctrl+Shift+X）
  3. 搜索 "Kimi Code"
  4. 找到 moonshot-ai.kimi-code 插件，点击安装
  5. 安装后侧边栏出现 Kimi Code 图标

插件地址：https://marketplace.visualstudio.com/items?itemName=moonshot-ai.kimi-code

如安装后图标未显示，执行命令面板（Ctrl+Shift+P）→ Developer: Reload Window 重新加载。

2.2 登录 ​

支持两种认证方式：

方式 A：Kimi 账号登录（推荐）

  1. 点击侧边栏 Kimi Code 图标
  2. 点击"登录"按钮，自动跳转浏览器
  3. 完成 OAuth 授权后自动返回 VS Code

方式 B：API Key 模式

  1. 点击侧边栏 Kimi Code 图标
  2. 选择"跳过登录"
  3. 在插件设置中填入 API Key
  4. 保存后即可使用

可通过聊天面板的齿轮图标随时切换认证模式。

3. 使用方式二：Claude Code 插件兼容模式 ​

Kimi 提供与 Anthropic 兼容的 API 接口，可以直接在 Claude Code VS Code 插件中使用 Kimi 模型。

3.1 前置条件 ​

  • 已安装 Claude Code VS Code 插件
  • 已获取 Kimi Code API Key（格式：sk-kimi-xxxx）

3.2 配置环境变量 ​

在系统中设置以下环境变量：

Windows (PowerShell):

powershell
$env:ANTHROPIC_BASE_URL = "https://api.kimi.com/coding/"
$env:ANTHROPIC_API_KEY = "sk-kimi-你的API Key"

若需永久生效，在系统环境变量中添加：

ANTHROPIC_BASE_URL = https://api.kimi.com/coding/
ANTHROPIC_API_KEY = sk-kimi-你的API Key

方式 B：修改项目配置文件

在项目根目录下的 .claude/settings.local.json 中配置：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.kimi.com/coding/",
    "ANTHROPIC_API_KEY": "sk-kimi-你的API Key"
  }
}

3.3 ��证 ​

配置完成后重启 VS Code，打开 Claude Code 插件。此时 Claude Code 界面不变，但底层调用的是 Kimi K2.5 模型。

在 Claude Code 中输入 /status 可查看当前连接状态。

3.4 注意事项 ​

  • 环境变量 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 不要与真正的 Anthropic Key 混用
  • 模型能力由 Kimi K2.5 提供，部分 Claude 专属功能可能不适用
  • 上下文窗口为 256K（Kimi K2.5 规格）

4. 聊天面板与交互 ​

4.1 打开聊天面板 ​

以下操作均适用于 Kimi Code 插件：

  • 点击侧边栏的 Kimi Code 图标
  • 或使用命令面板（Ctrl+Shift+P）搜索 "Kimi Code"

4.2 自然语言对话 ​

在聊天面板中直接输入自然语言描述需求：

帮我写一个快速排序函数

分析这个项目的目录结构

修复 src/utils/parser.ts 中的类型错误

给这个 API 加上分页功能

4.3 核心能力 ​

能力说明
代码读写读取、编辑、创建项目中的文件
命令执行运行终端命令（需用户确认）
多模态输入支持粘贴截图、UI 设计稿，AI 根据图片生成代码
深度思考部分模型支持扩展推理，查看思考过程
Diff 视图直观展示文件变更，支持选择性接受或回退
会话管理历史会话本地存储，支持搜索和恢复

4.4 历史会话 ​

  • 聊天面板顶部的"历史下拉菜单"可浏览过往会话
  • 支持关键词搜索
  • 可加载旧会话继续对话
  • 支持删除不需要的会话

5. 文件引用与多模态输入 ​

5.1 文件引用 ​

在消息中输入 @ 触发自动补全，引用项目中的文件和目录：

语法示例说明
@文件名@app.ts引用单个文件
@文件夹/@src/handlers/引用整个文件夹
@文件:行范围@src/app.ts:10-20引用特定行范围

按 Alt+K 可快速插入当前编辑器中打开的文件���选中的代码片段。

5.2 图片和视频输入 ​

支持通过粘贴、拖拽或选择文件的方式添加多媒体附件：

类型支持格式大小限制
图片PNG、JPEG、GIF、WebP、HEIC单个 ≤ 5MB
视频MP4、WebM、MOV单个 ≤ 40MB
  • 每条消息最多附加 9 个文件
  • 总大小不超过 80MB

6. 斜杠命令 ​

在聊天面板输入 / 打开命令菜单：

命令功能
/init扫描项目结构，生成 AGENTS.md 项目文档
/compact压缩过长的上下文，释放对话空间

输入 / 后会自动弹出可用命令列表，可直接点选。

7. 快捷键 ​

快捷键功能
Ctrl/Cmd+Shift+K聚焦到 Kimi Code 输入框
Alt+K快速插入当前文件或选中代码作为引用
Ctrl/Cmd+N新建对话（需在设置中启用）
Ctrl+V粘贴文本或图片（图片自动作为附件）
@触发文件/目录路径自动补全
/打开斜杠命令菜单

8. 文件变更与 Diff 管理 ​

Kimi Code 对项目文件的所有修改都会在"文件变更"栏中追踪，提供完整的变更管理能力：

操作说明
查看 Diff每个被修改的文件都可以查看前后对比
接受变更确认并保留 AI 提出的修改
回退变更恢复文件至修改前的基准版本
批量操作一键保留或撤销所有变更

9. 深度思考模式 ​

部分模型支持扩展推理（Thinking Mode），AI 会展示其思考过程：

  • 思考步骤默认折叠显示
  • 点击可展开查看完整的推理链
  • 适用于复杂逻辑分析和架构决策

10. MCP 扩展 ​

MCP（Model Context Protocol）服务器可为 Kimi Code 扩展外部工具与服务能力。

10.1 管理入口 ​

通过聊天面板的 操作菜单 → MCP 服务器 进行管理。

10.2 传输类型 ​

类型说明示例
stdio本地命令行工具Playwright、文件处理
http远程服务Context7、GitHub API

10.3 推荐 MCP 服务器 ​

插件内置一键安装功能，推荐服务包括：

服务功能
Playwright浏览器自动化测试
Context7实时文档查询
GitHubGitHub API 访问

11. 项目配置 ​

11.1 AGENTS.md ​

在聊天面板中输入 /init，Kimi Code 会扫描项目并自动生成 AGENTS.md 文件。

该文件类似于 Claude Code 的 CLAUDE.md，用于：

  • 描述项目结构和技术栈
  • 定义开发规范和约定
  • 提供项目上下文，帮助 AI 更准确地理解代码

11.2 关键设置项 ​

在 VS Code 设置中搜索 "Kimi Code" 可配置：

设置项说明
kimi.yoloMode自动批准所有工具调用（谨慎使用）
kimi.autosave文件操作前自动保存
kimi.useCtrlEnterToSend使用 Ctrl/Cmd+Enter 发送消息
kimi.executablePath自定义 CLI 路径（可选）

12. 操作确认与安全 ​

当 AI 提议执行工具操作（如运行命令、修改文件）时，会弹出确认对话框：

选项说明
Yes仅批准当前这一次操作
Yes, for this session在当前会话中自动批准同类操作
No拒绝本次操作

启用 kimi.yoloMode 后会自动批准所有操作，仅建议在可信环境中使用。

13. 订阅套餐 ​

13.1 计费模式 ​

Kimi Code 采用 Token 计量模式：

  • 按输入/输出 Token 计费
  • 仅统计未命中缓存的 Token（命中缓存部分免费）
  • 输出速度可达 100 Tokens/s
  • 每 5 小时支持 100-500 次请求额度（视套餐等级）

13.2 套餐选择 ​

套餐说明
试用套餐4.9 元 / 7 天，适合初次体验
Andante基础月度套餐
Moderato高级月度套餐，更大额度和更高并发
3x Quota Plan永久计划，提供 3 倍配额

套餐政策更新频繁，购买前请前往 https://www.kimi.com/code 确认最新详情。

13.3 底层模型 ​

Kimi Code 使用 Kimi K2.5 模型：

  • 万亿参数级原生多模态 MoE 模型
  • 32B 激活参数
  • 256K 超长上下文支持
  • 擅长逻辑推理、代码生成和多模态理解

14. 常见问题 ​

Q: 注册需要什么条件？ ​

A: 需要一个中国大陆手机号，用于接收验证码完成注册。也可使用已有 Kimi 账号直接登录。

Q: Kimi Code 插件和通过 Claude Code 兼容方式使用有什么区别？ ​

A: Kimi Code 插件是官方原生体验，支持多模态输入、Diff 管理、MCP 扩展等完整功能。通过 Claude Code 兼容方式使用时，界面和交互方式与 Claude Code 一致，但底层调用 Kimi K2.5 模型，部分 Claude 专属功能可能不可用。

Q: 可��同时安装两个插件吗？ ​

A: 可以。Kimi Code 插件和 Claude Code 插件互不冲突，可以根据需求切换使用。

Q: 登录一直失败怎么办？ ​

A: 尝试使用 API Key 模式跳过登录，检查网络连接，或通过操作菜单重试。

Q: 发送消息无响应怎么办？ ​

A: 确认已打开工作区文件夹，通过命令面板执行 "Kimi Code: Show Logs" 查看错误日志。

Q: 连接超时怎么办？ ​

A: 默认 30 秒超时，检查网络环境后重试。

Q: 如何切换深度思考模式？ ​

A: 在聊天面板中根据模型选择对应的 Thinking Mode 选项。

参考链接 ​

资源链接
Kimi Code 官网https://www.kimi.com/code