跳轉到主要內容
Cursor CLI 支援兩種驗證方式:瀏覽器登入(推薦)或 API 金鑰。 使用瀏覽器流程,就能獲得最簡便的驗證體驗:
# 透過瀏覽器流程登入
cursor-agent login

# 檢查認證狀態
cursor-agent status

# 登出並清除已儲存的認證
cursor-agent logout
login 指令會開啟你的預設瀏覽器,並要求你使用 Cursor 帳號進行驗證。完成後,你的認證資訊會安全地儲存在本機。

API 金鑰驗證

在自動化、腳本,或 CI/CD 環境中,使用 API 金鑰驗證:

Step 1: 產生 API 金鑰

到 Cursor 控制台的 Integrations > User API Keys 產生一組 API 金鑰。

Step 2: 設定 API 金鑰

可以用兩種方式提供 API 金鑰: 選項 1:環境變數(建議)
export CURSOR_API_KEY=your_api_key_here
cursor-agent "實作使用者身分驗證"
選項 2:命令列參數
cursor-agent --api-key your_api_key_here "實作使用者身分驗證"

驗證狀態

查看你目前的驗證狀態:
cursor-agent status
這個指令會顯示:
  • 你是否已通過驗證
  • 你的帳號資訊
  • 目前的端點設定

疑難排解

  • 「Not authenticated」錯誤: 執行 cursor-agent login,或確認你的 API 金鑰已正確設定
  • SSL 憑證錯誤: 在開發環境使用 --insecure 參數
  • 端點問題: 使用 --endpoint 參數來指定自訂 API 端點
I