简体中文

环境变量

环境变量在 MiMo Code 里不是配置文件的通用 fallback，而是承担四类明确职责：定位资源、运行时开关、兼容与跳过、鉴权与端点。配置字段（如 model / permission / server.port）不会自动从同名环境变量读取，需要通过 MIMOCODE_CONFIG 或 MIMOCODE_CONFIG_CONTENT 显式注入。

布尔类变量的取值规则一致：true / 1 视为开启，false / 0 视为关闭，其他值或未设置走默认值。

资源定位

变量	类型	默认值	作用
`MIMOCODE_HOME`	string	—	单一 profile 根目录（含 `config/`、`data/`、`state/`、`cache/`），覆盖全部 XDG 基础目录，必须是绝对路径
`MIMOCODE_CONFIG`	string	—	自定义配置文件路径
`MIMOCODE_CONFIG_DIR`	string	—	自定义配置目录（结构同 `.mimocode/`）
`MIMOCODE_CONFIG_CONTENT`	string	—	内联 JSON 配置内容
`MIMOCODE_TUI_CONFIG`	string	—	自定义 TUI 配置文件路径
`MIMOCODE_PERMISSION`	string	—	内联 JSON 权限配置
`MIMOCODE_DB`	string	—	覆盖数据库文件路径
`MIMOCODE_MODELS_URL`	string	—	自定义模型清单获取 URL
`MIMOCODE_MODELS_PATH`	string	—	自定义模型清单本地路径
`MIMOCODE_GIT_BASH_PATH`	string	—	Windows 下 Git Bash 可执行文件路径

运行时开关

变量	类型	默认值	作用
`MIMOCODE_PURE`	boolean	`false`	运行时纯净模式，禁用所有插件
`MIMOCODE_AUTO_SHARE`	boolean	`false`	自动分享会话
`MIMOCODE_DISABLE_SHARE`	boolean	`false`	完全禁用分享
`MIMOCODE_DISABLE_AUTOUPDATE`	boolean	`true`	禁用自动更新检查；置 `false` 才会启用
`MIMOCODE_ALWAYS_NOTIFY_UPDATE`	boolean	`false`	即使禁用自动更新，仍通知新版本
`MIMOCODE_DISABLE_AUTOCOMPACT`	boolean	`false`	禁用自动上下文压缩
`MIMOCODE_DISABLE_PRUNE`	boolean	`false`	禁用旧数据清理
`MIMOCODE_DISABLE_TERMINAL_TITLE`	boolean	`false`	禁用自动终端标题更新
`MIMOCODE_DISABLE_MOUSE`	boolean	`false`	禁用 TUI 鼠标捕获
`MIMOCODE_DISABLE_DEFAULT_PLUGINS`	boolean	`false`	禁用默认插件
`MIMOCODE_DISABLE_LSP_DOWNLOAD`	boolean	`false`	禁用 LSP 服务器自动下载
`MIMOCODE_DISABLE_MODELS_FETCH`	boolean	`false`	禁用从远程源获取模型清单
`MIMOCODE_DISABLE_EMBEDDED_WEB_UI`	boolean	`false`	禁用内置 Web UI
`MIMOCODE_ENABLE_ANALYSIS`	boolean	`true`	遥测开关（`model_call` / `tool_call` / `agent_request`），置 `false` 关闭
`MIMOCODE_ENABLE_EXPERIMENTAL_MODELS`	boolean	`false`	启用实验性模型
`MIMOCODE_ENABLE_EXA`	boolean	`false`	启用 Exa 网络搜索工具
`MIMOCODE_ENABLE_QUESTION_TOOL`	boolean	`false`	启用 question 工具
`MIMOCODE_DISABLE_PROJECT_CONFIG`	boolean	`false`	禁止读取项目内 `.mimocode/` 配置
`MIMOCODE_DISABLE_GIT`	boolean	`false`	跳过所有 git 探测，把项目视为非 git 目录
`MIMOCODE_DISABLE_CHANNEL_DB`	boolean	`true`	所有 channel 共享一份 `mimocode.db`；置 `false` 恢复 per-channel 隔离

兼容与跳过

控制 mimocode 与 Claude Code 生态、第三方 skills 的相互可见性。

变量	类型	默认值	作用
`MIMOCODE_MIMO_ONLY`	boolean	`true`	纯 mimo 模式总开关：不继承 `.claude/`，不读 provider 环境变量，默认模型回落 `mimo-auto`
`MIMOCODE_DISABLE_PROVIDER_ENV`	boolean	`false`	单独禁用 provider 环境变量（mimo-only 模式下隐含开启）
`MIMOCODE_DISABLE_CLAUDE_CODE`	boolean	`false`	关闭 mimo-only 时显式禁用 `.claude/` 继承（prompt + skills，不含 MCP）
`MIMOCODE_DISABLE_CLAUDE_CODE_PROMPT`	boolean	`false`	单独禁用 `~/.claude/CLAUDE.md`
`MIMOCODE_DISABLE_CLAUDE_CODE_SKILLS`	boolean	`false`	单独禁用 `.claude/skills`
`MIMOCODE_DISABLE_CLAUDE_CODE_MCP`	boolean	`false`	禁用 Claude Code MCP 兼容（mimo-only 模式下仍默认开启）
`MIMOCODE_DISABLE_EXTERNAL_SKILLS`	boolean	`false`	一次性禁用所有外部 skills 源
`MIMOCODE_DISABLE_CODEX_SKILLS`	boolean	`false`	单独禁用 codex skills
`MIMOCODE_DISABLE_OPENCODE_SKILLS`	boolean	`false`	单独禁用 opencode skills
`MIMOCODE_DISABLE_COMPOSE_SKILLS`	boolean	`false`	单独禁用 compose skills

鉴权与端点

变量	类型	默认值	作用
`MIMOCODE_SERVER_PASSWORD`	string	—	为 `serve` / `web` 启用基本认证
`MIMOCODE_SERVER_USERNAME`	string	`mimocode`	基本认证用户名
`MIMOCODE_AUTH_CONTENT`	string	—	内联 JSON 凭证内容（CI 注入用）
`MIMOCODE_CONSOLE_TOKEN`	string	—	console 鉴权 token
`MIMOCODE_WORKSPACE_ID`	string	—	工作区标识
`MIMOCODE_CLIENT`	string	`cli`	客户端标识符（影响 USER_AGENT 与工具注册）

实验性

下列变量启用可能在不另行通知的情况下变更或移除的功能。MIMOCODE_EXPERIMENTAL=true 一次性打开所有实验项。

变量	类型	默认值	作用
`MIMOCODE_EXPERIMENTAL`	boolean	`false`	启用全部实验性功能
`MIMOCODE_EXPERIMENTAL_ICON_DISCOVERY`	boolean	`false`	启用图标发现
`MIMOCODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	boolean	Win 下 `true`	禁用 TUI 选中即复制
`MIMOCODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	number	—	bash 命令默认超时（毫秒）
`MIMOCODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	number	—	LLM 响应最大输出 Token
`MIMOCODE_EXPERIMENTAL_FILEWATCHER`	boolean	`false`	启用整目录文件监视
`MIMOCODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	boolean	`false`	禁用文件监视
`MIMOCODE_EXPERIMENTAL_OXFMT`	boolean	`false`	启用 oxfmt 格式化器
`MIMOCODE_EXPERIMENTAL_LSP_TOOL`	boolean	`false`	启用实验性 LSP 工具
`MIMOCODE_EXPERIMENTAL_LSP_TY`	boolean	`false`	启用 TY LSP（Python）
`MIMOCODE_EXPERIMENTAL_PLAN_MODE`	boolean	`false`	启用 Plan 模式
`MIMOCODE_EXPERIMENTAL_MARKDOWN`	boolean	`true`	Markdown 渲染；置 `false` 关闭
`MIMOCODE_EXPERIMENTAL_HTTPAPI`	boolean	`false`	启用实验性 HTTP API
`MIMOCODE_EXPERIMENTAL_WORKSPACES`	boolean	`false`	启用工作区支持

诊断与内部

下列变量主要用于性能诊断、构建测试、CI 沙箱，不建议常规使用。

变量	类型	默认值	作用
`MIMOCODE_SHOW_TTFD`	boolean	`false`	在 TUI 中显示 time-to-first-draw
`MIMOCODE_AUTO_HEAP_SNAPSHOT`	boolean	`false`	启动时自动写 heap snapshot
`MIMOCODE_SKIP_MIGRATIONS`	boolean	`false`	跳过数据库迁移
`MIMOCODE_STRICT_CONFIG_DEPS`	boolean	`false`	配置依赖严格模式
`MIMOCODE_FAST_BOOT`	boolean	`false`	快速启动（跳过部分同步检查）
`MIMOCODE_PLUGIN_META_FILE`	string	—	插件元信息输出文件
`MIMOCODE_FAKE_VCS`	string	—	模拟 VCS 提供商，仅测试用
`MIMOCODE_OUTPUT_LENGTH_CONTINUATION_LIMIT`	number	`3`	输出过长时的最大续写次数
`MIMOCODE_INVALID_OUTPUT_CONTINUATION_LIMIT`	number	`2`	无效输出时的最大续写次数

典型场景

切换 profile 根目录用于隔离测试。

1MIMOCODE_HOME=/tmp/mimocode-test mimo

临时启用自动更新（默认是禁用的）。

1MIMOCODE_DISABLE_AUTOUPDATE=false mimo

关闭遥测上报。

1MIMOCODE_ENABLE_ANALYSIS=false mimo

在 CI 中通过内联 JSON 注入配置和凭证。

1MIMOCODE_CONFIG_CONTENT='{"model":"mimo/mimo-v2.5-pro","share":"disabled"}' \
2MIMOCODE_AUTH_CONTENT='{"anthropic":{"apiKey":"sk-..."}}' \
3  mimo run "Generate release notes"

关闭 mimo-only 模式以继承 Claude Code 的 prompt 与 skills。

1MIMOCODE_MIMO_ONLY=false mimo

为 serve 启用基本认证。

1MIMOCODE_SERVER_USERNAME=alice MIMOCODE_SERVER_PASSWORD=s3cret \
2  mimo serve --port 4096

本页内容

环境变量#

资源定位#

运行时开关#

兼容与跳过#

鉴权与端点#

实验性#

诊断与内部#

典型场景#