什么是 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
1

运行安装命令

在终端中执行上述安装命令,自动下载并安装 Cursor CLI

2

验证安装

运行 cursor-agent --version 验证安装是否成功

3

登录认证

运行 cursor-agent login 通过浏览器完成认证

4

开始使用

运行 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