Qoder CLI 全部配置项、默认值、环境变量与文件路径全表
本页列出
JSON Schema 可用于编辑器自动补全，位于项目
settings.json 的全部配置分组、关键字段、默认值与是否需重启，以及支持的环境变量。关于配置文件的分层与合并规则，见 配置文件与生效顺序。
配置文件位置：
| 层级 | 路径 |
|---|---|
| 用户级 | ~/.qoder/settings.json |
| 项目级 | <项目>/.qoder/settings.json |
| 本地级 | <项目>/.qoder/settings.local.json |
schemas/settings.schema.json。
顶层配置项
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
mcpServers | object | {} | 是 | MCP 服务器配置。见 MCP 参考。 |
outputStyle | string | 无 | 是 | 激活的输出风格名称。兼容 general.outputStyle 写法，顶层优先。 |
language | string | 无 | 是 | AI 回复的首选语言（如 "Chinese"）。 |
vpcInstanceName | string | 无 | 是 | VPC 私有部署实例名（仅 CN 版）。 |
agent | string | 无 | 是 | 主线程使用的 Agent 名称。 |
enabledPlugins | object | {} | 是 | 插件启用状态映射（插件 ID → true/false）。见 插件。 |
hooks | object | {} | 否 | 按事件配置的 Hooks。见 Hooks 参考。 |
general（通用）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
general.preferredEditor | string | 无 | 否 | 打开文件的首选编辑器。 |
general.vimMode | boolean | false | 否 | 启用 Vim 键位。 |
general.defaultPermissionMode | enum | default | 否 | 默认权限模式：default/accept_edits/plan/auto/bypass_permissions/dont_ask。 |
general.enableAutoUpdate | boolean | true | 否 | 启用自动更新。 |
general.enableNotifications | boolean | false | 否 | 启用运行事件通知。 |
general.maxAttempts | number | 10 | 否 | 主对话模型请求的最大尝试次数（不超过 10）。 |
general.retryFetchErrors | boolean | true | 否 | 出现 fetch failed 类网络请求异常时自动重试。 |
general.fileCheckpointing.enabled | boolean | true | 是 | 启用文件检查点（代码回溯）。 |
general.plan.enabled | boolean | true | 是 | 启用 Plan 模式。 |
general.plan.directory | string | 系统临时目录 | 是 | 计划产物存放目录。 |
general.plan.modelRouting | boolean | true | 否 | Plan/实现阶段自动切换模型。 |
general.sessionRetention.enabled | boolean | true | 否 | 启用会话自动清理。 |
general.sessionRetention.maxAge | string | 30d | 否 | 自动删除早于此时长的会话。 |
general.sessionRetention.minRetention | string | 1d | 否 | 最小保留期（安全下限）。 |
output（输出）
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
output.format | enum | text | CLI 输出格式：text 或 json。 |
ui（界面）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
ui.theme | string | 无 | 否 | 颜色主题名称。 |
ui.autoThemeSwitching | boolean | true | 否 | 按终端背景自动切换明暗主题。 |
ui.terminalBackgroundPollingInterval | number | 60 | 否 | 终端背景色轮询间隔（秒）。 |
ui.customThemes | object | {} | 否 | 自定义主题定义。 |
ui.inlineThinkingMode | enum | full | 否 | 内联思考显示：off/full。 |
ui.dynamicWindowTitle | boolean | true | 否 | 用状态图标更新窗口标题。 |
ui.hideBanner | boolean | false | 否 | 隐藏启动横幅。 |
ui.hideFooter | boolean | false | 否 | 隐藏页脚。 |
ui.hideTips | boolean | false | 否 | 隐藏提示。 |
ui.showLineNumbers | boolean | true | 否 | 对话中显示行号。 |
ui.compactToolOutput | boolean | true | 否 | 紧凑显示工具输出。 |
ui.copyFullResponse | boolean | false | 否 | /copy 总是复制完整响应。 |
ui.loadingPhrases | enum | off | 否 | 加载显示：tips/witty/all/off。 |
ui.errorVerbosity | enum | low | 否 | 可恢复错误详细度：low/full。 |
ui.customWittyPhrases | string[] | [] | 否 | 自定义加载短语。 |
ui.footer.* | object | {} | 否 | 页脚项配置（items/showLabels/hideCWD/hideModelInfo 等）。 |
ui.rotatingInfoLine.enabled | boolean | true | 否 | 输入框上方轮播信息行。 |
ui.rotatingInfoLine.intervalMs | number | 4000 | 否 | 轮播间隔毫秒。 |
ui.useAlternateBuffer | boolean | false | 是 | 使用备用屏幕缓冲区。 |
ui.accessibility.screenReader | boolean | false | 是 | 屏幕阅读器模式，输出纯文本。 |
ui.showMemoryUsage | boolean | false | 否 | 在界面显示内存占用信息。 |
ui.showSpinner | boolean | true | 否 | 操作期间显示加载动画。 |
ui.terminalBuffer | boolean | true | 是 | 使用新的终端缓冲架构进行渲染。 |
ui.renderProcess | boolean | true | 是 | 启用 Ink 渲染进程。 |
ui.incrementalRendering | boolean | true | 是 | 增量渲染，减少闪烁但可能出现渲染瑕疵；仅在启用 ui.useAlternateBuffer 时支持。 |
model / modelConfigs（模型）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
model.name | string | 无 | 否 | 对话模型。 |
model.reasoningEffort | enum | 无 | 否 | 推理努力：disabled/off/none/low/medium/high/xhigh/max。 |
model.contextWindow | number | 无 | 否 | 显式上下文窗口（token）。 |
model.maxSessionTurns | number | -1 | 否 | 会话保留最大回合数，-1 不限。 |
model.summarizeToolOutput | object | 无 | 否 | 按工具设置输出摘要 token 预算。 |
modelConfigs.aliases | object | 内置 | 否 | 模型配置别名预设。 |
modelConfigs.customAliases | object | {} | 否 | 自定义别名，合并覆盖内置。 |
modelConfigs.overrides | array | [] | 否 | 按匹配条件（主键为模型或别名）应用配置覆盖，最具体的匹配生效。 |
modelConfigs.customOverrides | array | [] | 否 | 自定义覆盖，与内置 overrides 合并追加。 |
modelConfigs.customModels | array | [] | 是 | BYOK 自定义模型。见 自定义模型。 |
context（上下文）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
context.fileName | string/string[] | AGENTS.md | 否 | 载入内存的上下文文件名。 |
context.importFormat | enum | 无 | 否 | 记忆导入格式：tree/flat。 |
context.discoveryMaxDirs | number | 200 | 否 | 记忆发现的最大目录数。 |
context.memoryBoundaryMarkers | string[] | ['.git'] | 是 | 记忆向上发现的边界标记。 |
context.loadMemoryFromIncludeDirectories | boolean | false | 否 | 从额外可信目录加载记忆。 |
context.fileFiltering.respectGitIgnore | boolean | true | 是 | 搜索时遵循 .gitignore。 |
context.fileFiltering.enableRecursiveFileSearch | boolean | true | 是 | @ 引用补全时递归搜索。 |
agentsMdExcludes | string[] | [] | 是 | 按 glob 排除项目级 / 本地级记忆文件。顶层键，仅支持手工配置。 |
tools（工具）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
tools.sandbox | boolean/string/object | 无 | 是 | 沙箱执行环境。见 沙箱。 |
tools.sandboxAllowedPaths | string[] | [] | 是 | 沙箱额外可访问路径。 |
tools.sandboxNetworkAccess | boolean | false | 是 | 沙箱是否允许联网。 |
tools.shell.pager | string | cat | 否 | Shell 输出分页命令。 |
tools.shell.inactivityTimeout | number | 300 | 否 | Shell 无输出超时秒数。 |
tools.core | string[] | 无 | 是 | 内置工具白名单。 |
tools.exclude | string[] | 无 | 是 | 从发现中排除的工具名。 |
tools.useRipgrep | boolean | true | 否 | 使用 ripgrep 进行内容搜索。 |
tools.disableLLMCorrection | boolean | true | 是 | 禁用编辑工具的 LLM 纠错。 |
mcp（MCP）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
mcp.allowed | string[] | 无 | 是 | 允许的 MCP 服务器列表。 |
mcp.excluded | string[] | 无 | 是 | 排除的 MCP 服务器列表。 |
mcp.enableAllProjectMcpServers | boolean | false | 是 | 自动批准所有项目级 MCP 服务器。 |
mcp.enabledProjectMcpServers | string[] | [] | 是 | 已逐个批准的项目级 MCP 服务器名称列表。 |
mcp.lazyLoad | boolean | false | 是 | 懒加载 MCP 工具（暴露 meta 工具）。 |
security（安全）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
security.folderTrust.enabled | boolean | true | 是 | 启用文件夹信任。 |
security.toolSandboxing | boolean | false | 是 | 工具级沙箱隔离。 |
security.disableYoloMode | boolean | false | 是 | 禁用 bypass_permissions（YOLO）权限模式。 |
security.blockGitExtensions | boolean | false | 是 | 阻止从 Git 安装/加载扩展。 |
security.allowedExtensions | string[] | [] | 是 | 扩展来源正则白名单。 |
security.environmentVariableRedaction.enabled | boolean | false | 是 | 对可能含密钥的环境变量脱敏。 |
security.enableConseca | boolean | false | 是 | 启用上下文感知安全检查。 |
permissions（权限）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
permissions.allow | string[] | [] | 否 | 自动允许的权限规则列表。规则语法见 权限与目录信任。 |
permissions.ask | string[] | [] | 否 | 需询问确认的权限规则列表。 |
permissions.deny | string[] | [] | 否 | 一律拒绝的权限规则列表。 |
permissions.additionalDirectories | string[] | [] | 否 | 加入工作区上下文的额外可信目录（对应 /add-dir）。 |
permissions.trustDirectories | string[] | [] | 否 | 用户显式信任的目录；存于用户级配置，不会被项目级覆盖。 |
autoMode | object | {} | 否 | Auto 模式分类器软引导规则（allow/soft_deny/environment）。顶层键，仅从用户级与本地配置读取。 |
allowManagedPermissionRulesOnly | boolean | false | 否 | 只使用托管策略的权限规则。顶层键，主要用于组织托管策略。 |
privacy / aiCodeStatistics（隐私）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
privacy.usageStatisticsEnabled | boolean | true | 否 | 共享使用数据；关闭进入隐私模式。 |
aiCodeStatistics.enabled | boolean | true | 是 | 记录并上报 AI 生成代码统计。 |
advanced（高级）
| 配置项 | 类型 | 默认值 | 需重启 | 说明 |
|---|---|---|---|---|
advanced.autoConfigureMemory | boolean | true | 是 | 自动配置 Node.js 内存上限。 |
advanced.dnsResolutionOrder | string | 无 | 是 | DNS 解析顺序。 |
advanced.excludedEnvVars | string[] | ['DEBUG','DEBUG_MODE'] | 否 | 从项目上下文排除的环境变量。 |
agents.overrides | object | {} | 是 | 按 Agent 名覆盖其配置（启用状态、工具、模型、运行上限等）。字段见 子代理。 |
statusLine（状态栏）
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
statusLine.type | string | command | 状态栏类型。 |
statusLine.command | string | "" | 生成状态栏的 Shell 命令，经 stdin 接收会话数据 JSON。 |
statusLine.padding | number | 0 | 水平填充字符数。 |
statusLine.colors | object | {} | 内置默认状态栏各段落的自定义颜色（如 model、branch、separator）。 |
环境变量
Qoder 相关
| 环境变量 | 说明 |
|---|---|
QODER_PERSONAL_ACCESS_TOKEN | 个人访问令牌（PAT），设置后自动使用 PAT 认证。 |
QODER_CONFIG_DIR | 用户配置目录位置（默认 ~/.qoder）。 |
QODER_MODEL | 指定使用的模型。 |
QODER_WORKING_DIR | 工作目录。 |
QODER_SESSION_ID | 会话 ID。 |
QODER_SESSION_NAME | 会话名称。 |
QODER_PERMISSION_MODE | 权限模式。 |
QODER_APPEND_SYSTEM_PROMPT | 追加系统提示。 |
QODER_MCP_LAZY | 设为 1 时启用 MCP 懒加载。 |
QODER_SANDBOX | 沙箱命令或开关。 |
QODER_SANDBOX_IMAGE | 自定义沙箱镜像。 |
QODER_SANDBOX_IMAGE_DEFAULT | 默认沙箱镜像。 |
QODER_SANDBOX_PROXY_COMMAND | 沙箱内部代理命令。 |
SANDBOX | 由沙箱环境注入，用于检测是否已处于沙箱内以避免嵌套（通常无需手工设置）。 |
QODER_ASR_URL | 语音识别服务地址。 |
QODER_SUBAGENT_MODEL | 子 Agent 使用的模型。 |
QODER_MEMORY | 设为 1 启用自动记忆（仅交互式会话生效）。 |
QODER_MEMORY_USER | 设为 1 同时启用用户级自动记忆；仅在 QODER_MEMORY 已启用时生效。 |
网络代理
| 环境变量 | 说明 |
|---|---|
HTTP_PROXY / http_proxy | HTTP 请求代理地址。 |
HTTPS_PROXY / https_proxy | HTTPS 请求代理地址。 |
NO_PROXY / no_proxy | 不走代理的主机列表（逗号分隔）。 |
NODE_EXTRA_CA_CERTS | 指向额外 CA 证书文件（PEM 格式）的路径。 |
SSL_CERT_FILE | 指定受信任的证书文件路径，用于自签名或企业根证书环境。 |
下一步
- 配置分层与合并规则：配置文件与生效顺序。
- 网络与代理配置：网络、代理与 VPC。
- 沙箱配置：沙箱。