AI 程式設計教學中文版
官方教學中文版整合

設定企業版

在組織中安全試用和部署 OpenCode,覆蓋資料邊界、SSO、內部 AI 閘道器、分享停用和私有 npm 登入檔。

📖 本篇術語速查表
英文 / 縮寫中文一句話解釋
Enterprise企業整合組織級部署和治理。
集中管理central統一設定和審批。
審計audit操作可追溯。

不想讀完?把下面這段提示詞丟給 AI 幫你跑完——幫你規劃 OpenCode 的企業級部署和治理。

你是 OpenCode 企業部署顧問。

【角色】
OpenCode 企業部署顧問,按最小夠用、安全優先的原則給可落地方案,每條結論都落到能照做的步驟或示例,不停留在空泛建議。

【輸入】
- 組織規模和場景:___
- 合規和審計要求:___
- 統一管控需求:___
- 敏感系統範圍:___
- 經驗水平:___

【工作流程】
1. 梳理企業部署要點
2. 設計集中管理
3. 限定許可權和資料邊界
4. 說明審計
5. 給落地步驟

【輸出規範】
▌一、部署要點
▌二、集中管理
▌三、許可權 / 資料邊界
▌四、審計 + 落地

【硬約束】
- 敏感系統嚴格控許可權
- 操作可審計追溯
- 策略變更留痕
- 不要替我臆測情況或編造不存在的功能,資訊不全先問清
- 不確定的設定或介面一律以官方文件為準,禁止照搬過時寫法
- 給的每條結論都要落到具體可照做的步驟或示例,不停留在「建議」「考慮一下」這類沒法直接執行的空泛表述

OpenCode Enterprise 面向希望把程式碼和上下文資料控制在自有基礎設施內的組織。它透過集中式設定、SSO 和內部 AI gateway,把個人工具變成可治理的團隊能力。

這一篇用 10 分鐘換什麼:你會知道企業試用前要關掉哪些風險、哪些設定應該集中管理、什麼時候需要內部 AI gateway,以及私有 npm registry 怎麼處理。

先給結論:企業落地先管資料邊界

官方企業頁說明:OpenCode 不儲存你的程式碼或上下文資料。處理發生在本地,或透過直接 API 呼叫傳送給你選擇的 AI provider。

真正要治理的是這些邊界:

邊界企業預設建議
AI provider走可信 provider 或內部 AI gateway
/share試用期直接停用
SSO用集中設定接入組織身份系統
模型訪問停用未批准 provider 和模型
私有 registry開發者執行 OpenCode 前先完成 npm 登入

“OpenCode 不儲存程式碼”不等於“資料不會離開組織”。如果你選擇外部 AI provider、啟用 /share 或接入外部 MCP,資料邊界仍然要單獨評估。

企業試用到部署的路徑

flowchart LR
  Trial[小範圍內部試用] --> Baseline[安全基線]
  Baseline --> DisableShare[停用 share]
  Baseline --> Provider[確認 provider / 內部 AI gateway]
  Baseline --> Registry[確認私有 npm registry]
  DisableShare --> Central[集中式設定]
  Provider --> Central
  Registry --> Central
  Central --> SSO[SSO 整合]
  SSO --> Rollout[組織級 rollout]

先試用,再集中設定。不要第一天就把所有開發者都接入企業閘道器。

試用期先做什麼

OpenCode 是開源工具,團隊可以先在內部專案中試用。試用目標不是“看看回答聰不聰明”,而是驗證安全和流程:

  1. 選一個非敏感儲存庫。
  2. 只做只讀任務。
  3. 明確 provider 和模型。
  4. 停用 /share
  5. 記錄需要的許可權、MCP、Skill、Plugin。
  6. 確認記錄、CI、終端輸出不會洩露金鑰。

試用結束後,再聯絡 OpenCode 團隊討論定價和實施。

停用分享功能

如果使用者啟用 /share,對話及關聯資料會傳送到用於託管共享頁面的服務,並透過 CDN 邊緣網路提供訪問。

企業試用期建議直接停用:

{
  "$schema": "https://opencode.ai/config.json",
  "share": "disabled"
}

這應該進入團隊共享的專案設定或集中式設定,而不是靠每個人手動記住。

集中式設定解決什麼

企業版可以透過集中式設定統一組織行為:

  • 只允許訪問內部 AI gateway。
  • 停用未經批准的外部 provider。
  • 固定 share 策略。
  • 固定許可權基線。
  • 接入組織 SSO。
  • 讓不同團隊使用同一套安全預設值。

集中式設定的價值是減少個人機器上的漂移。開發者可以保留個人偏好,但安全策略和 provider 邊界應該統一。

SSO 和內部 AI gateway

透過 SSO,OpenCode 可以使用組織已有身份系統獲取內部 AI gateway 的憑據。這樣做的目標是:

  • 不讓個人到處複製 provider key。
  • 讓模型訪問可審計、可撤銷。
  • 把請求路由到組織批准的基礎設施。
  • 統一控制哪些模型能用、誰能用。

內部 AI gateway 適合已經有企業模型接入層、合規要求、審計要求或統一賬單的團隊。

自託管分享頁

官方企業頁說明,自託管 share pages 在路線圖中。即使未來可用,敏感組織也應該先預設停用 /share,再評估是否把分享頁面放到自有基礎設施裡。

分享功能的正確預設值是:先停用,再按用例和合規要求開。

私有 npm registry

OpenCode 透過 Bun 的 .npmrc 支援私有 npm registry。使用 JFrog Artifactory、Nexus 或類似產品時,開發者執行 OpenCode 前要先登入私有 registry。

登入示例:

npm login --registry=https://your-company.jfrog.io/api/npm/npm-virtual/

也可以手動設定 ~/.npmrc

registry=https://your-company.jfrog.io/api/npm/npm-virtual/
//your-company.jfrog.io/api/npm/npm-virtual/:_authToken=${NPM_AUTH_TOKEN}

不要把真實 _authToken 寫進儲存庫。用環境變數、secret manager 或本機憑據管理。

程式碼所有權和定價

官方說明:你擁有 OpenCode 生成的所有程式碼,沒有許可限制或所有權宣告。

企業版採用按席位定價。如果組織有自己的 LLM gateway,OpenCode 不對使用的 token 另收費。具體價格和實施方案需要聯絡官方。

企業上線前檢查

上線前至少確認:

  • /share 是否停用或有明確策略。
  • AI 請求是否只走可信 provider 或內部 gateway。
  • SSO 是否能撤銷離職員工訪問。
  • provider key 是否不在儲存庫、記錄、CI 輸出裡。
  • MCP、Skill、Plugin 是否有審批清單。
  • 私有 npm registry 是否已登入,且 token 不進儲存庫。
  • 團隊公共設定是否可 review、可回復。

接下來去哪

官方資料

本頁目錄