什么是 Cursor CLI?
Cursor CLI 是 Cursor 团队开发的命令行工具,将强大的 AI 编程能力引入任何开发环境,让你在终端中享受与 Cursor IDE 相同的 AI 编程体验。
多模型支持
支持 GPT-5、Claude Sonnet 4、Gemini 等最新 AI 模型,随时切换使用最适合的模型完成编程任务。
实时交互
提供交互式和非交互式两种模式,既可以实时对话编程,也可以用于脚本自动化和 CI/CD 流程。
代码生成与审查
自动生成代码、审查安全问题、优化性能、重构代码,全方位提升开发效率。
全环境兼容
兼容 VSCode、JetBrains、Android Studio 等主流 IDE,可在任意终端环境中使用。
文件操作
支持生成新文件、修改现有文件、运行终端命令,提供完整的项目开发支持。
安全可靠
与 Cursor 订阅无缝集成,支持 API 密钥认证,确保使用安全和数据隐私。
快速安装
只需一条命令,即可在你的系统上安装 Cursor CLI
curl https://cursor.com/install -fsS | bash
运行安装命令
在终端中执行上述安装命令,自动下载并安装 Cursor CLI
验证安装
运行 cursor-agent --version 验证安装是否成功
登录认证
运行 cursor-agent login 通过浏览器完成认证
开始使用
运行 cursor-agent 启动交互式 AI 编程会话
使用示例
通过实际例子了解 Cursor CLI 的强大功能
# 启动交互式会话 cursor-agent # 在会话中与 AI 对话 > 帮我实现一个用户认证系统 > /model gpt-5 # 切换到 GPT-5 模型 > 添加 JWT 令牌支持 > /new-chat # 开始新的对话
# 直接生成代码 cursor-agent -p "生成一个 Python 快速排序算法" # 指定模型和输出格式 cursor-agent -p "优化这段代码的性能" --model gpt-5 --output-format text
# 审查 Git 变更 cursor-agent --with-diffs -p "审查这些更改的安全问题" # 生成测试用例 cursor-agent -p "为新添加的函数生成单元测试" --output-format json
核心特性
深入了解 Cursor CLI 的强大功能
智能代码生成
通过自然语言描述需求,AI 自动生成高质量代码,支持多种编程语言和框架。
cursor-agent "实现一个 REST API 服务器"
代码审查与优化
自动检测代码中的安全漏洞、性能问题和最佳实践违规,提供优化建议。
cursor-agent -p "审查代码安全性"
会话管理
支持保存和恢复对话历史,可以在不同任务间无缝切换,提高工作效率。
cursor-agent resume cursor-agent ls
自动化集成
完美集成到 CI/CD 流程中,支持自动化测试生成、文档更新和代码质量检查。
cursor-agent --api-key $KEY -p "生成测试"
应用场景
Cursor CLI 在实际开发中的典型应用
紧急 Bug 修复
在生产环境出现问题时,快速定位和修复代码缺陷,无需切换到 IDE 环境。
代码重构
将旧代码从一种语言或框架迁移到另一种,如 Python 转 Go,React 转 Vue。
学习与教学
生成示例代码帮助理解复杂概念,或快速创建教学演示材料。
DevOps 自动化
在部署脚本、监控配置和基础设施代码中集成 AI 辅助功能。
测试生成
自动为现有代码生成单元测试、集成测试和端到端测试。
文档生成
根据代码自动生成 API 文档、README 文件和技术规范文档。
常用命令
掌握这些命令,让你的 AI 编程更高效
基础命令
# 启动交互式会话 cursor-agent # 查看版本 cursor-agent --version # 登录认证 cursor-agent login # 查看帮助 cursor-agent --help
交互式命令
# 切换模型 /model gpt-5 # 开始新对话 /new-chat # 自动运行代码 /auto-run on # 退出会话 /quit
自动化命令
# 非交互模式 cursor-agent -p "生成代码" # 指定输出格式 --output-format json # 包含 Git 差异 --with-diffs # 使用 API 密钥 --api-key YOUR_KEY
会话管理
# 列出历史会话 cursor-agent ls # 恢复最近会话 cursor-agent resume # 恢复指定会话 cursor-agent --resume chat_id # 查看状态 cursor-agent status