Gemini CLI 활용 가이드

이 문서는 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의 공식 문서를 통해 확인하는 것이 좋습니다.