企業設定

你可以透過裝置管理解決方案集中管理 Cursor 的特定功能,確保它符合你組織的需求。當你指定一項 Cursor 原則時,其值會覆寫使用者裝置上對應的 Cursor 設定。 設定編輯器顯示「Extensions: Allowed」設定由組織管理。 Cursor 目前提供以下可由管理員控管的功能原則:
PolicyDescriptionCursor settingAvailable since
AllowedExtensions控制可安裝哪些擴充功能。extensions.allowed1.2
AllowedTeamId控制允許登入的 Team ID。使用未獲授權 Team ID 的使用者會被強制登出。cursorAuth.allowedTeamId1.3

設定允許的擴充功能

extensions.allowed 是 Cursor 的一項設定,用來控制哪些擴充功能可以安裝。此設定接受一個 JSON 物件,鍵為發佈者名稱,值為布林值,表示是否允許該發佈者的擴充功能。 例如,將 extensions.allowed 設為 {"anysphere": true, "github": true} 會允許來自 Anysphere 與 GitHub 發佈者的擴充功能;而設為 {"anysphere": false} 則會封鎖 Anysphere 的擴充功能。 若要在組織層級集中管理允許的擴充功能,請透過你的裝置管理方案設定 AllowedExtensions 原則。此原則會覆寫使用者裝置上的 extensions.allowed 設定。該原則的值是一個 JSON 字串,用來定義允許的發佈者。 如果想更了解 Cursor 的擴充功能,請參考擴充功能文件。

設定允許的團隊 ID

Cursor 的 cursorAuth.allowedTeamId 設定用來控制哪些團隊 ID 可以登入 Cursor。這個設定接受以逗號分隔的已授權團隊 ID 清單。 例如,把 cursorAuth.allowedTeamId 設為 "1,3,7",就只允許這些特定團隊 ID 的使用者登入。 當使用者嘗試用不在允許清單內的團隊 ID 登入時:
  • 會被立即強制登出
  • 會顯示錯誤訊息
  • 應用程式會阻止進一步的驗證嘗試,直到使用有效的團隊 ID
若要集中管理組織內允許的團隊 ID,請透過你的裝置管理解決方案設定 AllowedTeamId 原則。這個原則會覆寫使用者裝置上的 cursorAuth.allowedTeamId 設定。其值為一個字串,內容是以逗號分隔的已授權團隊 ID 清單。

Windows 上的群組原則

Cursor 支援以 Windows 登錄機碼為基礎的群組原則。安裝原則定義後,系統管理員可以使用本機群組原則編輯器管理原則值。 新增原則的方法:
  1. AppData\Local\Programs\cursor\policies 複製 ADMX 與 ADML 原則檔案。
  2. 將 ADMX 檔案貼到 C:\Windows\PolicyDefinitions 資料夾,將 ADML 檔案貼到 C:\Windows\PolicyDefinitions\<your-locale>\ 資料夾。
  3. 重新啟動本機群組原則編輯器。
  4. 在本機群組原則編輯器中設定適當的原則值(例如 {"anysphere": true, "github": true} 用於 AllowedExtensions 原則)。
原則可在電腦層級與使用者層級設定;若兩者皆有設定,電腦層級優先。當設定了原則值後,該值會覆寫在任何層級(預設、使用者、工作區等)所設定的 Cursor 設定值。

在 macOS 上的設定描述檔

設定描述檔用來管理 macOS 裝置上的設定。描述檔是一個包含鍵值配對的 XML 檔案,對應到可用的政策。這些描述檔可以透過行動裝置管理(MDM)方案部署,或手動安裝。

字串型政策

以下範例示範如何設定 AllowedExtensions 政策。範例檔案中的政策值起始為空(不允許任何擴充功能)。
<key>AllowedExtensions</key>
<string></string>
<string> 標籤之間加入定義你政策的適當 JSON 字串。
<key>AllowedExtensions</key>
<string>{"anysphere": true, "github": true}</string>
對於 AllowedTeamId 政策,加入以逗號分隔的 team ID 清單:
<key>AllowedTeamId</key>
<string>1,3,7</string>
重要: 提供的 .mobileconfig 檔案會初始化該版本 Cursor 中可用的所有政策。刪除任何不需要的政策。 如果你沒有編輯或移除範例 .mobileconfig 中的某個政策,該政策就會以其預設(限制性)值強制套用。 你可以在 Finder 中按兩下 .mobileconfig 檔案,接著在「系統設定」的「一般」>「裝置管理」中啟用,來手動安裝設定描述檔。從「系統設定」移除該描述檔會同時移除在 Cursor 上套用的政策。 如需更多關於設定描述檔的資訊,請參考 Apple 的文件。

其他政策

目標是把目前的 Cursor 設定提升為政策,並盡量貼近現有設定,確保命名與行為一致。若需要制定更多政策,請到 Cursor 的 GitHub 儲存庫開一個 issue。團隊會評估該行為是否已有對應設定,或是否需要新增設定來控制預期的行為。

常見問題

Cursor 是否支援在 Linux 上使用設定檔?

目前沒有將 Linux 納入規劃。如果你想在 Linux 上使用設定檔,請到 Cursor 的 GitHub 儲存庫建立 issue,並分享你的使用情境與細節。