이 문서는 Gemini CLI(Command Line Interface)를 효과적으로 사용하는 데 필요한 주요 명령어와 옵션들을 설명합니다.
1. 기본 사용법
Gemini CLI는 일반적으로 다음과 같은 구조를 가집니다:
gemini [command] [options] [arguments]
command: 수행하고자 하는 특정 작업 (예:chat,generate,config).options: 명령어의 동작을 수정하는 플래그 (예:--model,--temperature).arguments: 명령어 또는 옵션에 필요한 추가 입력 값 (예: 파일 경로, 프롬프트 텍스트).
2. 자주 사용되는 전역 옵션
명령어와 관계없이 Gemini CLI 전체에 적용될 수 있는 몇 가지 유용한 전역 옵션입니다.
--help 또는 -h (도움말 표시)
CLI의 전반적인 사용법 또는 특정 명령어의 사용법을 보여줍니다.
사용법:
- 전체 CLI 도움말:
gemini --help
- 특정 명령어 도움말 (예:
chat명령어):
gemini chat --help
--version 또는 -v (버전 정보 표시)
설치된 Gemini CLI의 버전을 확인합니다.
사용법:
gemini --version
--config <path> (설정 파일 지정)
기본 설정 파일(config.json 등) 대신 특정 경로의 설정 파일을 사용하도록 지정합니다.
사용법:
gemini --config ./my_custom_config.json chat "Hello Gemini!"
--verbose 또는 -d (상세 출력)
명령 실행 시 더 자세한 디버그 정보를 출력합니다. 문제 해결 시 유용합니다.
사용법:
gemini --verbose chat "Summarize this article."
3. 주요 명령어 및 옵션 (예시)
여기서는 가상의 chat 명령어를 예시로 들어 설명하지만, 실제 CLI의 명령어와 옵션은 다를 수 있습니다.
chat 명령어
Gemini 모델과 대화하는 명령어입니다.
사용법:
gemini chat [prompt] [options]
chat 명령어에 자주 사용되는 옵션:
--model <model_name>: 사용할 Gemini 모델을 지정합니다 (예:gemini-pro,gemini-flash).
gemini chat "What is the capital of France?" --model gemini-pro
--temperature <value>: 모델의 창의성 또는 무작위성을 조절합니다 (0.0에서 1.0 사이).
gemini chat "Write a short story about a brave knight." --temperature 0.8
--max-tokens <number>: 생성될 응답의 최대 토큰(단어) 수를 제한합니다.
gemini chat "Explain quantum physics simply." --max-tokens 100
4. 기타 유용한 팁
- 명령어 자동 완성: 쉘(Bash, Zsh 등)에 따라
gemini명령어에 대한 자동 완성 기능을 설정할 수 있습니다. - 환경 변수: 일부 설정은 환경 변수를 통해 지정될 수도 있습니다 (예:
GEMINI_API_KEY). 자세한 내용은 공식 문서를 참조하세요. - 공식 문서 참조: 가장 정확하고 최신 정보는 Gemini CLI의 공식 문서를 통해 확인하는 것이 좋습니다.
