配置指南

自定义 Gemini CLI 以适应您的工作流程

配置命令

管理配置的基本命令

gemini config list

显示所有当前配置设置

gemini config get <key>

获取特定设置的值

gemini config set <key> <value>

设置配置值

gemini config unset <key>

删除配置设置（恢复为默认值）

gemini config reset

将所有设置重置为默认值

gemini config export

将配置导出到文件

gemini config import <file>

从文件导入配置

配置选项

按类别组织的详细设置

API 配置

配置 API 密钥和模型设置

api-key

必需

您的 Google AI API 密钥

类型:string
示例:
gemini config set api-key YOUR_API_KEY

model

要使用的默认模型

类型:string
默认值:gemini-pro
示例:
gemini config set model gemini-pro

temperature

创造性级别（0.0 到 1.0）

类型:number
默认值:0.7
示例:
gemini config set temperature 0.7

max-tokens

最大响应长度

类型:number
默认值:2048
示例:
gemini config set max-tokens 2048

界面设置

自定义 CLI 外观和行为

theme

CLI 的颜色主题

类型:string
默认值:auto
选项:auto, light, dark
示例:
gemini config set theme dark

output-format

默认输出格式

类型:string
默认值:text
选项:text, markdown, json
示例:
gemini config set output-format markdown

stream

启用流式响应

类型:boolean
默认值:true
示例:
gemini config set stream true

history-limit

要记住的对话轮数

类型:number
默认值:10
示例:
gemini config set history-limit 20

工具和扩展

配置工具和插件设置

tools-enabled

启用工具使用

类型:boolean
默认值:true
示例:
gemini config set tools-enabled true

tool-timeout

工具执行超时（秒）

类型:number
默认值:30
示例:
gemini config set tool-timeout 30

plugins-dir

自定义插件目录

类型:string
默认值:~/.gemini/plugins
示例:
gemini config set plugins-dir ~/.gemini/plugins

安全设置

安全和隐私配置

safe-mode

为工具执行启用安全模式

类型:boolean
默认值:true
示例:
gemini config set safe-mode true

log-level

日志详细级别

类型:string
默认值:info
选项:error, warn, info, debug
示例:
gemini config set log-level info

data-collection

允许匿名使用数据收集

类型:boolean
默认值:false
示例:
gemini config set data-collection false

环境变量

使用环境变量的替代配置

常用环境变量

GEMINI_API_KEY=your_api_key

用于身份验证的 API 密钥

GEMINI_MODEL=gemini-pro

要使用的默认模型

GEMINI_CONFIG_DIR=~/.config/gemini

配置目录

设置环境变量

Bash/Zsh:

export GEMINI_API_KEY=your_key

PowerShell:

$env:GEMINI_API_KEY="your_key"

.env 文件:

GEMINI_API_KEY=your_key

配置文件

了解配置文件位置和格式

文件位置

全局配置:

~/.config/gemini/config.json

项目配置:

.gemini/config.json

环境文件:

.env

示例配置文件

{
  "api-key": "your_api_key",
  "model": "gemini-pro",
  "temperature": 0.7,
  "max-tokens": 2048,
  "theme": "dark",
  "stream": true,
  "tools-enabled": true,
  "safe-mode": true
}

最佳实践

安全有效配置的建议

安全

  • • 永远不要将 API 密钥提交到版本控制
  • • 对敏感数据使用环境变量
  • • 为工具执行启用安全模式
  • • 定期轮换您的 API 密钥
  • • 审查和限制工具权限

性能

  • • 根据用例调整温度
  • • 设置适当的令牌限制
  • • 启用流式传输以获得更好的用户体验
  • • 配置合理的超时
  • • 限制对话历史大小

相关资源

探索更多配置和设置指南

安装指南使用示例故障排除