企业级配置完全指南
引言
版本说明：本文基于 OpenCode v1.2 和 Claude Code v2.1 编写，配置体系均来自官方文档及社区实践。
适用对象：技术负责人、架构师、DevOps 工程师，以及需要为团队统一 AI 编程配置的开发者。
前置知识：已了解 OpenCode 和 Claude Code 的基本使用（第5-7篇），理解 AGENTS.md / CLAUDE.md 的基本概念（第10篇）。
个人开发者用 AI 工具，配置随心所欲即可。但团队场景完全不同——当 10 个开发者各自为政，AI 产出的代码风格、质量、安全性将彻底失控。企业级配置的核心目标，是让整个团队在统一的框架下使用 AI，同时保留个人的灵活性。
本讲从配置的核心原则出发，以 OpenCode 为主体（70%），Claude Code 为对照（30%），系统讲解企业级配置的完整方案。
一、企业级配置的核心原则
1.1 三个不可妥协的原则
企业级配置不是"把个人配置复制给所有人"，而是建立在三个核心原则之上的系统工程。
原则一：一致性——全团队用同一个标准
一致性是配置的底线。没有一致性，AI 产出的代码将无法维护。一致性体现在：
- 统一的编码规范和风格约定
- 统一的模型选择和权限控制
- 统一的工具链和 MCP 配置
- 统一的文档结构和知识库入口
原则二：可维护性——配置本身也需要工程化
配置文件不是写一次就完事的，它们需要像代码一样被管理和迭代：
- 配置有版本控制，变更可追溯
- 配置有分层结构，修改影响范围可控
- 配置有审核机制，防止随意篡改
- 配置有文档说明，新人能理解每条规则的意义
原则三：安全性——AI 不能越权操作
安全性是企业的红线。配置必须能精确控制 AI 能做什么、不能做什么：
- 敏感文件禁止 AI 访问
- 危险命令需要人工审批
- 外部网络请求有白名单限制
- 模型调用有审计日志
1.2 配置分层：企业级 vs 个人级
| 层级 | 管控者 | 作用范围 | 典型内容 |
|---|---|---|---|
| 企业级 | 架构师/技术负责人 | 全组织 | 模型策略、安全红线、MCP 白名单 |
| 项目级 | 项目负责人 | 单个仓库 | 编码规范、目录结构、常用命令 |
| 模块级 | 模块负责人 | 子目录 | 模块特定规则、接口约定 |
| 个人级 | 开发者 | 本机环境 | 个人偏好、快捷键、主题 |
二、OpenCode 企业配置体系
2.1 配置层级与合并策略
OpenCode 采用 6 层配置体系，按优先级从低到高合并（OpenCode v1.0+）：
| 层级 | 来源 | 优先级 | 适用场景 |
|---|---|---|---|
| 1. Remote | .well-known/opencode 端点 | 最低 | 组织级默认配置（v1.0+） |
| 2. Global | ~/.config/opencode/opencode.json | 低 | 用户个人偏好 |
| 3. Custom Path | OPENCODE_CONFIG 环境变量指向的文件 | 中低 | 自定义配置路径 |
| 4. Project | 项目根目录 opencode.json | 中高 | 项目级配置 |
| 5. Directory | .opencode/ 子目录 | 高 | 模块级扩展 |
| 6. Inline | OPENCODE_CONFIG_CONTENT 环境变量 | 最高 | 运行时覆盖 |
合并规则：后加载的配置仅覆盖冲突的键，非冲突设置从所有配置中保留 。
企业级的配置策略是：把通用规则放在 Remote 或 Global 层，项目特有规则放在 Project 层，模块级规则放在 Directory 层。需要注意的是，OpenCode 的开源版本没有类似 Claude Code MDM 的"不可覆盖"安全层，企业如需强制安全策略，可通过 Remote 层统一下发或借助 CI 检查来保障合规。
2.2 AGENTS.md 模板设计
AGENTS.md 是 OpenCode 的项目级指令文件，相当于"给 AI 的 README"。通过 /init 命令可以自动生成初始版本 。
企业级 AGENTS.md 推荐结构：
扫码添加企业微信，找大熊掌门开通会员
添加后说明想开通的会员类型即可