保姆级教程：Cursor自定义API教程——接入kimi的moonshot API教程

夏日_蝉鸣
68 阅读6分钟

详细介绍如何在 Cursor编译器 中配置并使用 kimi的大模型moonshot API或者其他兼容了 OpenAI SDK的Api。

目录

  1. 一、Cursor 简介
  2. 二、Kimi 和 Moonshot API 简介
  3. 三、准备工作
    1. 安装 Cursor 编辑器
    2. 注册 Kimi 账号并获取 API 密钥
  4. 四、配置方式
  5. 五、使用方式
    1. 聊天
    2. 提示词 Cursor Rules

一、Cursor 简介

Cursor 是一款功能强大的代码编辑器，它不仅具备基本的代码编写和调试功能，还支持多种编程语言的语法高亮、自动补全以及代码片段管理等功能。其界面简洁直观，操作便捷，能够有效提升开发者在编写代码过程中的效率和体验。此外，Cursor 还支持插件扩展，通过接入不同的 API，可以进一步拓展其功能，满足开发者多样化的开发需求。

二、Kimi 和 Moonshot API 简介

Moonshot API文档

Kimi 是一个提供智能代码生成功能的平台，它借助先进的人工智能技术，能够根据用户输入的提示或代码片段，自动生成高质量的代码，大大减少了开发者从头开始编写代码的工作量。

Moonshot API 则是 Kimi 提供的一种接口服务，允许开发者将 Kimi 的智能代码生成功能集成到自己的应用程序或工具中，如 Cursor 编辑器。通过 Moonshot API，Cursor 可以与 Kimi 的智能代码生成引擎进行交互，从而为开发者提供更智能、更高效的代码编写辅助功能。

三、准备工作

1. 安装 Cursor 编辑器

从 官方网站 下载并安装适合您操作系统的 Cursor 版本。

3. 注册 Kimi 账号并获取 API 密钥

  1. 访问 Kimi 官网，完成注册流程。
  2. 在注册成功后，进入 Kimi 的开发者中心或相关设置页面，申请 Moonshot API 的密钥。

image.png 3. 目前申请后会赠送15元的Moonshot API调用余额，用完以后就要充值了，也可以参考github的KIMI AI 长文本大模型逆向API(github.com/LLM-Red-Tea…) ，尝试免费调用测试接口。

  1. 获取 Moonshot API 的密钥，新建，如图。

image.png

复制并保存好你的秘钥，之后要用，这个秘钥只会在新建时可以查看一次，如果忘记保存或者丢失，就删除重新新建一个。

image.png

四、配置方式

  1. 打开 Cursor 编辑器 ：启动已安装的 Cursor 应用程序。

  2. 进入设置页面 ：在 Cursor 的菜单栏中，找到并点击 “设置” 或 “Preferences” 选项，进入设置界面。

image.png

  1. 找到 API 配置选项 ：在设置页面中，查找选择Models选项卡。不同版本的 Cursor 可能位置会有所不同，一般会在 “高级设置” 或 “插件管理” 等部分中找到。

  2. 添加 Moonshot API 配置 ：在模型配置界面中，点击Add model新建模型，模型名称输入Moonshot API文档——字段说明中的model字段，目前是 moonshot-v1-8k,moonshot-v1-32k,moonshot-v1-128k 其一，也可以分别都输入，分别调用的是token长度为8k，32k，和128k的模型，由于价格不同，建议优先选择8k的比较便宜，如果是长文本再调用32k或128k的大模型。具体价格参考Moonshot API文档——计费逻辑。

image.png

  1. 配置API key ：由于Moonshot 兼容了 OpenAI SDK，所以我们可以直接在配置Open API Key的地方配置Moonshot API。

image.png

  • 首先确认Open API Key的自定义api秘钥为开启状态，点击右侧的红色按钮后，弹窗选择Enable OpenAI API Key,按钮切换为绿色开启状态即可

image.png

  • API 地址 ：输入 Kimi 提供的 Moonshot API 的请求地址，通常是一个 URL 地址，如api.moonshot.cn/v1（具体地址以 Kimi 官方文档为准）。

  • API 密钥 ：将之前获取的 Kimi Moonshot API 密钥准确无误地填写到对应的输入框中。

  • 确认保存，点击SAVE。

五、使用方式

1.聊天

  1. 快捷键 ctrl+L 呼出Ai聊天界面

  2. 模型选择之前添加的moonshot-v1-8k

image.png

2.提示词 Cursor Rules

自定义规则，用于指导 Cursor 编辑器中的 AI 如何生成代码、提供建议和进行代码补全。 你可以通过两种方式来定义规则：Rules for AI 和 .cursorrules 文件。

Rules for AI 是一种全局规则，适用于所有项目。你可以把它理解为 AI 的“系统级”提示词，一旦设置，就会在所有项目中生效。

  1. 打开 Cursor 设置：Settings > General > Rules for AI。
  2. 在规则编辑框中输入你的规则。例如，你可以要求 AI 使用特定的编程语言、遵循特定的编码风格或优先使用特定的库。具体的Rules，网上有很多。
  3. 保存并应用：点击保存，AI 将根据新规则调整行为。

.cursorrules 文件是针对特定项目的规则文件，它能够让你对 AI 的行为进行更精细的控制。 你可以为每个项目定义不同的规则，以满足不同的项目需求。

  1. 在你的项目根目录下创建一个名为 .cursorrules 的文件。
  2. 根据你的项目需求，在该文件中编写规则。
  3. 重启 Cursor 以便加载新的规则。

你可以在.cursorrules文件中做这些事情：

  • 指定项目的技术栈：告诉AI你用的是React还是Vue。
  • 项目信息：设置项目的基本信息，例如项目名称、描述、版本等。
  • 统一代码风格：例如使用 ESLint 进行代码风格检查，遵循 Airbnb 规范。
  • 开发流程：规定项目的开发流程、测试要求、性能优化指南等。
  • 提升上下文感知能力：告诉AI项目的常用方法、架构决策或特定库，让它生成更符合项目背景的代码。
  • 在团队项目中，共享一个.cursorrules文件，可以让所有成员获得一致的AI辅助，避免“各自为战”。

一些更便捷的方法

我们还可以通过插件来创建.cursorrules，这些插件一般都内置了大量模板，省去了自己查找的时间。 例如：

image.png

avatar
文章
阅读
粉丝