Cursor 命令行界面支持兩種身份驗證方式:通過瀏覽器登錄 (推薦) 和使用 API 密鑰。
瀏覽器身份驗證 (推薦)¶
使用瀏覽器流程,輕鬆完成身份驗證:
# 通過瀏覽器流程登錄
agent login
# 查看身份驗證狀態
agent status
# 退出登錄並清除已存儲的身份驗證信息
agent logout
login 命令會打開您的默認瀏覽器,並提示您通過 Cursor 賬戶進行認證。設置 NO_OPEN_BROWSER=1 可輸出登錄 URL,而不打開瀏覽器。完成後,您的憑據將安全地存儲在本地。
API 密鑰身份驗證¶
如需用於自動化、腳本或 CI 環境,請使用 API 密鑰身份驗證:
第 1 步:生成 API 密鑰¶
前往 Cursor Dashboard → API Keys 生成用戶 API 密鑰。
第 2 步:設置 API 密鑰¶
你可以通過以下兩種方式提供 API 密鑰:
選項 1:環境變量 (推薦)
export CURSOR_API_KEY=your_api_key_here
agent "implement user authentication"
選項 2:命令行標誌
agent --api-key your_api_key_here "implement user authentication"
身份驗證狀態¶
查看當前身份驗證狀態:
agent status
此命令將顯示:
- 您是否已通過認證
- 您的賬戶信息
- 當前端點配置
疑難排查¶
- **“未認證”錯誤:**運行
agent login,或確認已正確設置 API 密鑰 - **瀏覽器未自動打開:**運行
NO_OPEN_BROWSER=1 agent login,然後手動打開輸出的 URL