环境变量参考
按配置、凭据、数据、界面和实验能力查找 OpenCode 环境开关。
下表来自官方 CLI 环境变量目录。除明确标出的默认值外，此页不推断未设置时的数值或行为；实验开关可能变动或移除。
配置与服务端
| 变量 | 类型 | 用途 |
|---|---|---|
OPENCODE_CONFIG | string | 配置文件路径 |
OPENCODE_TUI_CONFIG | string | TUI 配置路径 |
OPENCODE_CONFIG_DIR | string | 自定义配置目录 |
OPENCODE_CONFIG_CONTENT | string | 内联 JSON 配置 |
OPENCODE_PERMISSION | string | 内联 JSON 权限配置 |
OPENCODE_SERVER_PASSWORD | string | 为 serve/web 启用 Basic Auth |
OPENCODE_SERVER_USERNAME | string | Basic Auth 用户名，默认 opencode |
OPENCODE_CLIENT | string | 客户端标识，默认 cli |
OPENCODE_MODELS_URL | string | 自定义模型配置获取 URL |
变量的存在不代表覆盖所有组织策略，配置合并顺序见配置文件与层级。提供商专用认证变量见提供商入口，不在这份通用 CLI 清单中逐一列出。
数据、更新与兼容
以下变量除最后一项外均为 boolean：
| 变量 | 用途 |
|---|---|
OPENCODE_AUTO_SHARE | 自动分享会话 |
OPENCODE_DISABLE_AUTOUPDATE | 关闭自动更新检查 |
OPENCODE_DISABLE_PRUNE | 关闭旧数据清理 |
OPENCODE_DISABLE_AUTOCOMPACT | 关闭上下文自动压缩 |
OPENCODE_DISABLE_DEFAULT_PLUGINS | 禁用默认插件 |
OPENCODE_DISABLE_LSP_DOWNLOAD | 禁用 LSP 自动下载 |
OPENCODE_DISABLE_MODELS_FETCH | 禁止从远程来源获取模型 |
OPENCODE_DISABLE_CLAUDE_CODE | 禁用 .claude 提示与 Skills 兼容读取 |
OPENCODE_DISABLE_CLAUDE_CODE_PROMPT | 禁用读取 ~/.claude/CLAUDE.md |
OPENCODE_DISABLE_CLAUDE_CODE_SKILLS | 禁用 .claude/skills 加载 |
OPENCODE_FAKE_VCS | string，测试使用的模拟 VCS 提供商 |
OPENCODE_DISABLE_PRUNE 与 OPENCODE_DISABLE_AUTOCOMPACT 是两类不同开关，不应合并解释为“永久保留全部模型上下文”。分享开关的影响见会话分享。
终端与工具
| 变量 | 类型 | 用途 |
|---|---|---|
OPENCODE_GIT_BASH_PATH | string | Windows Git Bash 可执行文件路径 |
OPENCODE_DISABLE_TERMINAL_TITLE | boolean | 关闭终端标题自动更新 |
OPENCODE_DISABLE_MOUSE | boolean | 关闭 TUI 鼠标捕获 |
OPENCODE_ENABLE_EXPERIMENTAL_MODELS | boolean | 启用实验模型 |
OPENCODE_ENABLE_EXA | boolean | 启用 Exa 网页搜索工具 |
OPENCODE_ENABLE_PARALLEL | boolean | 启用 Parallel 网页搜索工具 |
实验能力
下面是官方列出的实验变量，未声明稳定接口或长期兼容。除两个 number 项外均为 boolean。
| 变量 | 用途 |
|---|---|
OPENCODE_EXPERIMENTAL | 实验功能总开关 |
OPENCODE_EXPERIMENTAL_ICON_DISCOVERY | 图标发现 |
OPENCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT | 禁用 TUI 选中即复制 |
OPENCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS | number，bash 默认超时，单位毫秒 |
OPENCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX | number，LLM 最大输出 token |
OPENCODE_EXPERIMENTAL_FILEWATCHER | 对整个目录启用文件监控 |
OPENCODE_EXPERIMENTAL_DISABLE_FILEWATCHER | 禁用文件监控 |
OPENCODE_EXPERIMENTAL_OXFMT | oxfmt formatter |
OPENCODE_EXPERIMENTAL_LSP_TOOL | LSP 工具 |
OPENCODE_EXPERIMENTAL_LSP_TY | Python 的 TY LSP |
OPENCODE_EXPERIMENTAL_EXA | Exa 实验能力 |
OPENCODE_EXPERIMENTAL_PARALLEL | 并行网页搜索执行 |
OPENCODE_EXPERIMENTAL_PLAN_MODE | 实验 Plan mode |
OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS | 后台子智能体任务 |
OPENCODE_EXPERIMENTAL_EVENT_SYSTEM | 实验事件系统 |
OPENCODE_EXPERIMENTAL_NATIVE_LLM | 原生 LLM 请求路径 |
OPENCODE_EXPERIMENTAL_SCOUT | Scout 子智能体 |
OPENCODE_EXPERIMENTAL_WORKSPACES | workspace 支持 |
总开关是否开启某个具体子功能、互相矛盾的开关如何取舍，官方 CLI 表未逐项说明；依赖这些行为时以所用版本的官方说明为准，不能仅按变量前缀推断。