详细介绍如何在 Cursor编译器 中配置并使用 kimi的大模型moonshot API或者其他兼容了 OpenAI SDK的Api。
目录
一、Cursor 简介
Cursor 是一款功能强大的代码编辑器,它不仅具备基本的代码编写和调试功能,还支持多种编程语言的语法高亮、自动补全以及代码片段管理等功能。其界面简洁直观,操作便捷,能够有效提升开发者在编写代码过程中的效率和体验。此外,Cursor 还支持插件扩展,通过接入不同的 API,可以进一步拓展其功能,满足开发者多样化的开发需求。
二、Kimi 和 Moonshot API 简介
Kimi 是一个提供智能代码生成功能的平台,它借助先进的人工智能技术,能够根据用户输入的提示或代码片段,自动生成高质量的代码,大大减少了开发者从头开始编写代码的工作量。
Moonshot API 则是 Kimi 提供的一种接口服务,允许开发者将 Kimi 的智能代码生成功能集成到自己的应用程序或工具中,如 Cursor 编辑器。通过 Moonshot API,Cursor 可以与 Kimi 的智能代码生成引擎进行交互,从而为开发者提供更智能、更高效的代码编写辅助功能。
三、准备工作
1. 安装 Cursor 编辑器
从 官方网站 下载并安装适合您操作系统的 Cursor 版本。
2. 注册 Kimi 账号并获取 API 密钥
- 访问 Kimi 官网,完成注册流程。
- 在注册成功后,进入 Kimi 的开发者中心或相关设置页面,申请 Moonshot API 的密钥。
- 目前申请后会赠送15元的Moonshot API调用余额,用完以后就要充值了,也可以参考github的KIMI AI 长文本大模型逆向API(https://github.com/LLM-Red-Team/kimi-free-api) ,尝试免费调用测试接口。
- 获取 Moonshot API 的密钥,新建,如图。
复制并保存好你的秘钥,之后要用,这个秘钥只会在新建时可以查看一次,如果忘记保存或者丢失,就删除重新新建一个。
四、配置方式
-
打开 Cursor 编辑器 :启动已安装的 Cursor 应用程序。
-
进入设置页面 :在 Cursor 的菜单栏中,找到并点击 “设置” 或 “Preferences” 选项,进入设置界面。
-
找到 API 配置选项 :在设置页面中,查找选择Models选项卡。不同版本的 Cursor 可能位置会有所不同,一般会在 “高级设置” 或 “插件管理” 等部分中找到。
-
添加 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文档——计费逻辑。
-
配置API key :由于Moonshot 兼容了 OpenAI SDK,所以我们可以直接在配置Open API Key的地方配置Moonshot API。
-
首先确认Open API Key的自定义api秘钥为开启状态,点击右侧的红色按钮后,弹窗选择Enable OpenAI API Key,按钮切换为绿色开启状态即可
-
API 地址 :输入 Kimi 提供的 Moonshot API 的请求地址,通常是一个 URL 地址,如https://api.moonshot.cn/v1(具体地址以 Kimi 官方文档为准)。
-
API 密钥 :将之前获取的 Kimi Moonshot API 密钥准确无误地填写到对应的输入框中。
-
确认保存,点击SAVE。
五、使用方式
1.聊天
-
快捷键 ctrl+L 呼出Ai聊天界面
-
模型选择之前添加的moonshot-v1-8k
2.提示词 Cursor Rules
自定义规则,用于指导 Cursor 编辑器中的 AI 如何生成代码、提供建议和进行代码补全。
你可以通过两种方式来定义规则:Rules for AI
和.cursorrules
文件。
Rules for AI
是一种全局规则,适用于所有项目。你可以把它理解为 AI 的“系统级”提示词,一旦设置,就会在所有项目中生效。
- 打开 Cursor 设置:
Settings > General > Rules for AI
。 - 在规则编辑框中输入你的规则。例如,你可以要求 AI 使用特定的编程语言、遵循特定的编码风格或优先使用特定的库。具体的Rules,网上有很多。
- 保存并应用:点击保存,AI 将根据新规则调整行为。
.cursorrules
文件是针对特定项目的规则文件,它能够让你对 AI 的行为进行更精细的控制。
你可以为每个项目定义不同的规则,以满足不同的项目需求。
- 在你的项目根目录下创建一个名为
.cursorrules
的文件。 - 根据你的项目需求,在该文件中编写规则。
- 重启 Cursor 以便加载新的规则。
你可以在
.cursorrules
文件中做这些事情:
- 指定项目的技术栈:告诉AI你用的是React还是Vue。
- 项目信息:设置项目的基本信息,例如项目名称、描述、版本等。
- 统一代码风格:例如使用 ESLint 进行代码风格检查,遵循 Airbnb 规范。
- 开发流程:规定项目的开发流程、测试要求、性能优化指南等。
- 提升上下文感知能力:告诉AI项目的常用方法、架构决策或特定库,让它生成更符合项目背景的代码。
- 在团队项目中,共享一个
.cursorrules
文件,可以让所有成员获得一致的AI辅助,避免“各自为战”。
一些更便捷的方法
我们还可以通过插件来创建.cursorrules
,这些插件一般都内置了大量模板,省去了自己查找的时间。
例如: