Gemini CLI, 제대로 쓰면 진짜 쓸만하다! - Claude Code와의 환상 조합 사용법 요약
Gemini CLI와 Claude Code의 비교, 그리고 아쉬움
글쓴이는 Gemini CLI를 직접 사용해본 경험을 바탕으로, 현재로서는 Claude Code에 비해 여러모로 부족하다고 느낍니다.
특히 속도가 느리고, 지시를 잘 따르지 않으며, 도구 활용 능력도 Claude에 비해 떨어진다고 평가합니다.
"솔직히 말해서, 지금 Gemini CLI는 Claude Code에 비하면 쓰레기 같아요. 느리고, 지시도 잘 안 듣고, 도구도 제대로 못 써요."
하지만 Gemini CLI만의 강점도 분명히 존재합니다. 바로 엄청나게 큰 컨텍스트 윈도우(한 번에 처리할 수 있는 정보량)입니다.
이 점은 대규모 코드베이스를 다룰 때 매우 유용하죠.
두 도구의 장점만 뽑아 쓰는 방법 제안
이런 상황에서 글쓴이는 Claude Code가 필요할 때만 Gemini CLI를 비(非)대화형 모드로 호출해서,
대규모 코드베이스 분석에만 Gemini의 장점을 활용하는 방법을 제안합니다.
"그래서 저는 CLAUDE.md에 지침을 추가해서, Claude가 대규모 코드베이스 정보를 수집할 때는 Gemini CLI를 비대화형 모드로 사용하도록 했어요.
이렇게 하면 Claude의 컨텍스트 낭비도 막고, Gemini의 시간 낭비도 줄일 수 있죠."
이렇게 하면 두 도구의 장점만 뽑아 쓸 수 있다는 것이죠!
Claude는 컨텍스트를 아끼고, Gemini는 시간 낭비 없이 대용량 분석만 담당하게 됩니다.
CLAUDE.md에 추가할 지침 예시
글쓴이는 CLAUDE.md에 아래와 같은 내용을 추가해서 Claude가 Gemini CLI를 적절히 활용하도록 했다고 설명합니다.
이 지침은 직접 명령어를 입력해도 되고, Claude가 필요할 때 알아서 실행하게 할 수도 있습니다.
"이 내용을 CLAUDE.md에 추가하거나, 약간 수정해서 넣으세요. Claude에게 Gemini를 수동으로 쓰라고 하거나,
아니면 Claude가 필요할 때 알아서 쓰게 할 수도 있습니다."
Gemini CLI 사용법 및 예시 정리
1. 대규모 코드베이스 분석 시 Gemini CLI 사용
- 컨텍스트 한계를 넘는 대규모 코드베이스나 여러 파일을 분석할 때,
Gemini CLI의 큰 컨텍스트 윈도우를 활용하라는 지침입니다. gemini -p명령어를 사용해 Google Gemini의 대용량 컨텍스트를 최대한 활용할 수 있습니다.
2. 파일/디렉토리 포함 문법
@문법을 사용해 파일이나 디렉토리를 Gemini 프롬프트에 포함시킬 수 있습니다.- 경로는 명령어를 실행하는 위치 기준으로 상대경로를 사용합니다.
3. 실전 예시
- 단일 파일 분석
gemini -p "@src/main.py 이 파일의 목적과 구조를 설명해줘" - 여러 파일 분석
gemini -p "@package.json @src/index.js 코드에서 사용된 의존성을 분석해줘" - 전체 디렉토리 분석
gemini -p "@src/ 이 코드베이스의 아키텍처를 요약해줘" - 여러 디렉토리 분석
gemini -p "@src/ @tests/ 소스코드의 테스트 커버리지를 분석해줘" - 현재 디렉토리 및 하위 디렉토리 전체 분석
gemini -p "@./ 이 프로젝트 전체를 개괄적으로 설명해줘" - 모든 파일 포함 플래그 사용
gemini --all_files -p "프로젝트 구조와 의존성을 분석해줘"
4. 구현 검증 예시
- 특정 기능 구현 여부 확인
gemini -p "@src/ @lib/ 다크 모드가 구현되어 있나요? 관련 파일과 함수도 보여줘" - 인증 구현 확인
gemini -p "@src/ @middleware/ JWT 인증이 구현되어 있나요? 모든 인증 관련 엔드포인트와 미들웨어를 나열해줘" - 특정 패턴(예: WebSocket React hook) 확인
gemini -p "@src/ WebSocket 연결을 처리하는 React hook이 있나요? 파일 경로와 함께 나열해줘" - 에러 핸들링 확인
gemini -p "@src/ @api/ 모든 API 엔드포인트에 적절한 에러 핸들링이 구현되어 있나요? try-catch 예시도 보여줘" - 속도 제한(rate limiting) 구현 확인
gemini -p "@backend/ @middleware/ API에 속도 제한이 구현되어 있나요? 구현 세부사항을 보여줘" - 캐싱 전략(예: Redis) 확인
gemini -p "@src/ @lib/ @services/ Redis 캐싱이 구현되어 있나요? 모든 캐시 관련 함수와 사용 예시를 나열해줘" - 보안 조치(예: SQL 인젝션 방지) 확인
gemini -p "@src/ @api/ SQL 인젝션 방지가 구현되어 있나요? 사용자 입력이 어떻게 정제되는지 보여줘" - 테스트 커버리지 확인
gemini -p "@src/payment/ @tests/ 결제 모듈이 충분히 테스트되었나요? 모든 테스트 케이스를 나열해줘"
Gemini CLI를 사용해야 할 때
아래와 같은 경우에는 Gemini CLI를 적극적으로 활용하는 것이 좋다고 안내합니다.
- 전체 코드베이스나 대규모 디렉토리 분석이 필요할 때
- 여러 대용량 파일을 비교할 때
- 프로젝트 전체의 패턴이나 아키텍처를 파악해야 할 때
- Claude의 컨텍스트 윈도우로는 부족할 때
- 100KB가 넘는 파일들을 다뤄야 할 때
- 특정 기능, 패턴, 보안 조치 등이 구현되어 있는지 확인할 때
- 코드베이스 전체에서 특정 코딩 패턴의 존재 여부를 확인할 때
중요한 참고사항 및 팁
@문법의 경로는 현재 작업 디렉토리 기준입니다.- CLI는 파일 내용을 직접 컨텍스트에 포함시킵니다.
- 읽기 전용 분석에는
--yolo플래그가 필요 없습니다. - Gemini의 컨텍스트 윈도우는 Claude보다 훨씬 커서, Claude로는 불가능한 대규모 코드베이스도 처리할 수 있습니다.
- 구현 여부를 확인할 때는 구체적으로 질문해야 더 정확한 결과를 얻을 수 있습니다.
"구현 여부를 확인할 때는, 무엇을 찾고 싶은지 구체적으로 질문하세요. 그래야 정확한 결과를 얻을 수 있습니다."
마무리
정리하자면, Gemini CLI는 단독으로 쓸 때는 아쉬운 점이 많지만,
Claude Code와 함께 쓰면서 대규모 코드 분석에만 적절히 활용하면
두 도구의 장점만 뽑아 쓸 수 있다는 점이 핵심입니다.
이런 식으로 CLAUDE.md에 지침을 추가해두면,
필요할 때마다 Claude가 Gemini CLI를 자동으로 활용해
더 효율적이고 강력한 코드 분석이 가능해집니다! 🚀
"이렇게 하면 두 세계의 장점을 모두 누릴 수 있습니다. Claude는 컨텍스트를 낭비하지 않고, Gemini는 당신의 시간을 낭비하지 않죠."