Gemini CLI 的所有配置都存储在 ~/.gemini/settings.json（全局）或 项目/.gemini/settings.json（项目级）。本页是完整字段速查表，覆盖 General、UI、Output、MCP 服务器配置等所有选项。项目级配置会覆盖全局配置。

Gemini CLI 配置参考（settings.json） #

配置文件位置 #

项目级配置优先级更高，会覆盖全局配置中的同名字段。

修改配置的方式：

• 直接编辑文件
• 在 REPL 中使用 /settings 命令（图形化设置面板）

General 通用配置 #

UI 界面配置 #

Output 输出配置 #

MCP 服务器配置 #

在 settings.json 中添加 mcpServers 块来配置 MCP 服务器：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "my-http-service": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

详见MCP 服务器接入。

实验性功能 #

{
  "experimental": {
    "autoMemory": true,
    "worktrees": true
  }
}

完整配置示例 #

{
  "general": {
    "defaultApprovalMode": "auto_edit",
    "plan": {
      "enabled": true,
      "modelRouting": true
    },
    "sessionRetention": {
      "maxAge": "14d"
    }
  },
  "ui": {
    "hideTips": true,
    "hideBanner": true,
    "compactToolOutput": true
  },
  "output": {
    "format": "text"
  },
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  },
  "context": {
    "fileName": ["GEMINI.md", "CLAUDE.md"]
  }
}

常见问题 #

Q: 修改 settings.json 后需要重启吗？

A: 大部分 UI 和 General 设置通过 /settings 实时生效；MCP 服务器配置需要 /mcp reload 或重启；实验性功能需要完全重启。

Q: auto_edit 和 default 审批模式有什么差别？

A: default 模式下每次工具调用（包括读文件、写文件、Shell 命令）都询问确认；auto_edit 自动批准文件读写操作，但 Shell 命令和危险操作仍需确认。

Q: 项目级 settings.json 是否应该提交到 git？

A: 建议提交（不含敏感信息的部分）。MCP 服务器配置中用 ${ENV_VAR} 引用环境变量，不会把 token 写入配置文件。团队共享配置有助于统一开发体验。