agent logout
让 CLI 退出 Cursor 账户登录,并清除本地保存的凭证。
agent logout 是 CLI 参考文档中的一个顶层命令,会将当前 CLI 安装从 Cursor 账号注销(“Sign out and clear stored authentication”)。之后本地保存的登录凭据会被清除,下次使用前需要重新执行 agent login。 关于凭据具体如何在技术上存储,官方文档并未详细说明——身份验证参考文档只提到登录后凭据会“安全地保存在本地”,并未提及 Keychain 或具体的存储变量。对于脚本和 CI 环境,也可以完全不通过交互式登录,而是通过环境变量 CURSOR_API_KEY 或参数 --api-key <key> 提供身份验证,这样一来通常也就无需注销。
✅ 什么时候用?
在共用机器上切换账号
执行 agent logout,然后用另一个账号执行 agent login
在该机器上的登录凭据不再需要使用前做干净收尾
在一台不再用于该 Cursor 账号的机器上执行 agent logout
⛔ 什么时候不该用?
只是想快速查看认证状态,不想注销
agent logout 会立即清除该安装保存的登录凭据。
更好的选择: 使用 agent status 或 agent whoami,仅查看状态
自动化脚本/CI 希望在没有交互式登录状态下运行
注销会彻底移除交互式会话,对于一次性、非交互式的调用来说没有必要。
更好的选择: 设置 CURSOR_API_KEY,或在每次调用时传入 --api-key <key>,而不是进行交互式登录/注销
来源
- Cursor 官方文档——CLI 参考:参数(Parameters) ↗ cursor.com