구성 가이드
워크플로우에 맞게 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
Example:
gemini config set api-key YOUR_API_KEYmodel
사용할 기본 모델
유형:string
기본값:
gemini-proExample:
gemini config set model gemini-protemperature
창의성 수준 (0.0에서 1.0)
유형:number
기본값:
0.7Example:
gemini config set temperature 0.7max-tokens
최대 응답 길이
유형:number
기본값:
2048Example:
gemini config set max-tokens 2048인터페이스 설정
CLI의 모양과 동작 사용자 정의
theme
CLI용 색상 테마
유형:string
기본값:
auto옵션:auto, light, dark
Example:
gemini config set theme darkoutput-format
기본 출력 형식
유형:string
기본값:
text옵션:text, markdown, json
Example:
gemini config set output-format markdownstream
스트리밍 응답 활성화
유형:boolean
기본값:
trueExample:
gemini config set stream truehistory-limit
기억할 대화 턴 수
유형:number
기본값:
10Example:
gemini config set history-limit 20환경 변수
환경 변수를 사용한 대체 구성
일반적인 환경 변수
GEMINI_API_KEY=your_api_key인증용 API 키
GEMINI_MODEL=gemini-pro사용할 기본 모델
GEMINI_CONFIG_DIR=~/.config/gemini구성 디렉토리
환경 변수 설정
Bash/Zsh:
export GEMINI_API_KEY=your_keyPowerShell:
$env:GEMINI_API_KEY="your_key".env 파일:
GEMINI_API_KEY=your_key구성 파일
구성 파일 위치 및 형식 이해
File Locations
전역 구성:
~/.config/gemini/config.json프로젝트 구성:
.gemini/config.json환경 파일:
.envExample Config File
{
"api-key": "your_api_key",
"model": "gemini-pro",
"temperature": 0.7,
"max-tokens": 2048,
"theme": "dark",
"stream": true,
"tools-enabled": true,
"safe-mode": true
}모범 사례
안전하고 효과적인 구성을 위한 권장사항
Security
- • API 키를 버전 관리에 커밋하지 마세요
- • 민감한 데이터에는 환경 변수 사용
- • 도구 실행을 위해 안전 모드 활성화
- • API 키를 정기적으로 순환
- • 도구 권한 검토 및 제한
Performance
- • 사용 사례에 따라 온도 조정
- • 적절한 토큰 제한 설정
- • 더 나은 UX를 위해 스트리밍 활성화
- • 합리적인 타임아웃 구성
- • 대화 기록 크기 제한