AI 编程教程中文版
官方教程中文版集成

配置企业版

在组织中安全试用和部署 OpenCode,覆盖数据边界、SSO、内部 AI 网关、分享禁用和私有 npm 注册表。

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、可回滚。

接下来去哪

官方资料

本页目录