본문 바로가기
AI

나만의 무료 코드 AI 에이전트, 제미나이 CLI 활용법

by 에버리치60 2025. 6. 26.

나만의 무료 코드 AI 에이전트, 제미나이 CLI 활용법

🚀 서론: 코딩, AI와 함께라면 더 이상 어렵지 않아요!

코딩은 현대 사회에서 점점 더 중요해지고 있지만, 처음 시작하는 분들에게는 높은 벽처럼 느껴질 수 있어요. 복잡한 문법, 끝없는 에러 메시지… 정말 막막하죠? 하지만 이제는 인공지능(AI)의 도움을 받아 코딩을 더 쉽고 효율적으로 할 수 있는 시대가 왔습니다!

이 글에서는 구글에서 개발한 강력한 AI 모델인 **제미나이(Gemini)**를 터미널(명령 프롬프트)에서 직접 사용할 수 있게 해주는 도구인 **제미나이 CLI(Command Line Interface)**에 대해 알아볼 거예요. 제미나이 CLI는 코드를 짜는 것부터, 이미 짜여진 코드에서 잘못된 부분을 찾아 고치고(디버깅), 심지어 새로운 아이디어를 얻는 것까지 도와줄 수 있는 나만의 무료 AI 코딩 에이전트라고 할 수 있습니다.

이 블로그에서는 제미나이 CLI가 무엇인지, 어떻게 설치하고 사용하는지, 그리고 이 도구를 통해 여러분의 코딩 실력을 어떻게 향상시킬 수 있는지 차근차근 설명해 드릴 테니, 코딩 초보자분들도 걱정 마시고 따라와 주세요!


💡 제미나이 CLI란 무엇인가요?

제미나이 CLI는 한마디로 '텍스트로 명령을 내리면 제미나이 AI가 코딩 관련 작업을 도와주는 도구'입니다. 복잡한 그래픽 화면 없이도 컴퓨터에 직접 명령을 입력하는 방식이라 처음엔 낯설 수 있지만, 익숙해지면 훨씬 빠르고 효율적으로 작업할 수 있습니다.

제미나이 CLI는 다음과 같은 놀라운 특징들을 가지고 있어요:

  • 코드 생성: "파이썬으로 웹사이트에 방문자 수를 세는 코드를 만들어줘"라고 요청하면 제미나이가 알아서 코드를 작성해 줍니다. 처음부터 코드를 짜는 시간을 확 줄여줄 수 있죠.
  • 코드 설명: 다른 사람이 만든 코드나 오래전에 내가 만들었지만 기억나지 않는 코드를 제미나이에게 보여주면, 이 코드가 무슨 역할을 하는지 친절하게 설명해 줍니다.
  • 코드 디버깅: 코드를 실행하다가 '에러'가 발생했을 때, 에러 메시지와 함께 코드를 보여주면 제미나이가 어디가 문제인지 알려주고 수정 방법까지 제안해 줍니다. 코딩 초보자들이 가장 어려워하는 부분이죠!
  • 다양한 언어 지원: 파이썬(Python), 자바스크립트(JavaScript), 자바(Java) 등 거의 모든 프로그래밍 언어를 이해하고 다룰 수 있습니다.
  • 무료로 사용 가능: 개인적인 학습이나 프로젝트를 위해 무료로 사용할 수 있다는 점이 큰 장점입니다!

다른 AI 코딩 도구들도 많지만, 제미나이 CLI는 구글의 최신 AI 모델인 제미나이를 기반으로 한다는 점에서 매우 강력하며, 터미널 환경에서 가볍게 사용할 수 있어 개발자들에게 특히 유용합니다.


🛠️ 제미나이 CLI를 사용하는 방법: 이제 직접 해볼까요?

제미나이 CLI를 사용하기 위해 몇 가지 단계를 거쳐야 하지만, 너무 어렵게 생각하지 마세요! 제가 쉽게 설명해 드릴게요.

1. 개발 환경 설정하기 (준비물 챙기기)

제미나이 CLI를 사용하려면 몇 가지 준비물이 필요해요.

  • 구글 계정: 제미나이 AI에 접근하려면 구글 계정이 필수입니다.
  • 터미널(Terminal) 또는 명령 프롬프트(Command Prompt): 윈도우에서는 '명령 프롬프트'나 '파워쉘(PowerShell)', 맥(Mac)이나 리눅스(Linux)에서는 '터미널'이라는 프로그램이 필요해요. 보통 컴퓨터에 기본적으로 설치되어 있습니다.
  • Node.js 및 npm: 제미나이 CLI는 Node.js라는 프로그램 위에서 동작해요. Node.js를 설치하면 npm(Node Package Manager)이라는 도구도 함께 설치되는데, 이 npm을 사용해서 제미나이 CLI를 설치할 거예요. Node.js 공식 홈페이지에서 설치 파일을 다운로드받아 쉽게 설치할 수 있습니다.

2. 제미나이 CLI 설치하기

Node.js와 npm이 설치되었다면, 터미널을 열고 다음 명령어를 입력하세요.

Bash
 
npm install -g @google/gemini-cli

이 명령어는 제미나이 CLI를 전 세계적으로(globally) 설치하라는 의미입니다. 설치가 완료되면, 이제 gemini 명령어를 어디에서든 사용할 수 있게 됩니다.

 

3. API 키 설정하기 (AI와 연결하기)

제미나이 AI를 사용하려면 '열쇠'와 같은 API 키가 필요해요. 이 키를 통해 여러분의 컴퓨터가 구글의 제미나이 AI 서버와 통신할 수 있습니다.

  • 구글 AI 스튜디오(Google AI Studio) 방문: 웹 브라우저로 aistudio.google.com에 접속하여 구글 계정으로 로그인합니다.
  • API 키 발급: 왼쪽 메뉴에서 'Get API key' 또는 'Create API key' 버튼을 클릭하여 새 API 키를 생성합니다. 이 키는 절대 다른 사람에게 보여주면 안 돼요! 비밀번호처럼 소중히 다뤄야 합니다.
  • 제미나이 CLI에 API 키 설정: 터미널에서 다음 명령어를 입력하고, 발급받은 API 키를 붙여넣으세요.이제 제미나이 CLI가 여러분의 API 키를 기억하고 AI와 연결할 준비가 끝났습니다! 
    gemini configure
    
  • Bash
     

4. 제미나이 CLI로 코딩 시작하기! (예시)

이제 제미나이 CLI를 사용할 준비가 되었어요. 터미널에서 gemini 명령어를 입력하고 그 뒤에 여러분이 원하는 내용을 질문하면 됩니다.

예시 1: 간단한 파이썬 코드 요청하기

Bash
 
gemini generate code "파이썬으로 1부터 10까지 더하는 함수를 만들어줘"

제미나이는 다음과 유사한 코드를 생성해 줄 거예요.

Python
 
def sum_one_to_ten():
    """1부터 10까지의 숫자를 더하는 함수"""
    total = 0
    for i in range(1, 11):
        total += i
    return total

# 함수 호출 및 결과 출력
result = sum_one_to_ten()
print(f"1부터 10까지의 합: {result}") # 출력: 1부터 10까지의 합: 55

예시 2: 자바스크립트 코드 설명 요청하기

특정 파일을 설명하려면, 다음과 같이 입력할 수 있습니다.

Bash
 
gemini explain code [파일명]

예를 들어, script.js라는 파일에 아래와 같은 내용이 있다고 가정해 봅시다.

JavaScript
 
// script.js
function greet(name) {
  return "Hello, " + name + "!";
}
console.log(greet("World"));

터미널에서 gemini explain code script.js라고 입력하면, 제미나이는 이 코드가 무엇을 하는지 설명해 줄 거예요.

예시 3: 코드 디버깅 요청하기

에러가 나는 코드가 있다면, 에러 메시지와 함께 제미나이에게 물어볼 수 있어요.

Bash
 
gemini debug code "TypeError: Cannot read property 'map' of undefined" --file my_buggy_script.js

my_buggy_script.js 파일에서 map 함수 관련 에러가 났을 때, 제미나이가 어떤 부분이 문제이고 어떻게 고쳐야 할지 조언해 줄 겁니다.

팁과 요령:

  • 명확하게 질문하기: AI는 여러분이 질문을 명확하게 할수록 더 좋은 답변을 줍니다. 원하는 프로그래밍 언어, 기능, 그리고 제약 사항 등을 자세히 알려주세요.
  • 반복적으로 질문하기: 원하는 결과가 나오지 않으면 질문을 바꿔서 다시 시도해 보세요. 마치 사람과 대화하듯이 여러 번 시도하는 것이 좋습니다.
  • --help 사용하기: 어떤 명령어를 어떻게 써야 할지 모르겠다면, gemini --help 또는 gemini generate --help처럼 --help를 붙여서 도움말을 볼 수 있습니다.


📈 제미나이 CLI를 최대한 활용하는 방법

제미나이 CLI는 단순히 코드를 만들어주는 것을 넘어, 여러분의 코딩 실력을 한 단계 업그레이드하는 데 도움을 줄 수 있습니다.

  • 새로운 개념 학습: 특정 개념(예: "파이썬의 데코레이터가 뭔가요?")에 대해 질문하고 예제 코드를 요청하여 빠르게 학습할 수 있습니다.
  • 코드 리팩토링(더 깔끔하게 만들기): 작성한 코드를 제미나이에게 보여주면서 "이 코드를 더 효율적이거나 읽기 좋게 개선해 줄 수 있을까?"라고 물어볼 수 있습니다.
  • 테스트 코드 작성: 특정 함수나 기능이 제대로 작동하는지 확인하는 '테스트 코드'를 제미나이에게 요청하여 개발 시간을 단축할 수 있습니다.
  • 다른 도구와의 연동: 제미나이 CLI로 생성된 코드를 복사하여 여러분이 사용하는 통합 개발 환경(IDE)이나 코드 편집기(VS Code 등)에 붙여넣어 바로 사용할 수 있습니다.

실제 활용 예시:

프로젝트를 만들다가 로그인 기능을 추가해야 할 때, "Node.js와 Express를 사용해서 간단한 사용자 로그인 및 회원가입 API를 만들어줘. 비밀번호는 안전하게 해시(hash)해야 해."라고 요청하면, 제미나이가 기본적인 API 구조와 코드 스니펫을 제공해 줄 겁니다. 여러분은 이 코드를 바탕으로 살을 붙여나가기만 하면 되죠.

 


🎉 결론: 나만의 AI 조수와 함께 코딩의 재미를 느껴보세요!

 

지금까지 제미나이 CLI가 무엇인지, 그리고 어떻게 설치하고 활용하는지 알아보았습니다. 제미나이 CLI는 코딩 초보자들에게는 든든한 조수 역할을, 숙련된 개발자들에게는 아이디어를 얻거나 반복적인 작업을 줄여주는 효율적인 도구가 될 수 있습니다.

물론, AI가 모든 것을 완벽하게 해주는 것은 아닙니다. AI가 생성한 코드를 이해하고 검토하는 능력은 여전히 여러분의 몫입니다. 하지만 제미나이 CLI를 활용하면 코딩 학습의 장벽을 낮추고, 더 빠르게 결과물을 만들어내며, 문제 해결 능력을 향상시키는 데 큰 도움을 받을 수 있을 거예요.

이제 망설이지 말고, 제미나이 CLI를 여러분의 개발 환경에 설치하고 직접 경험해 보세요! 코딩이 더 이상 어렵고 지루한 일이 아니라, 창의적이고 재미있는 활동이 될 수 있음을 느끼실 겁니다.

 

 

  • 제미나이 CLI GitHub 페이지 (영문): npm install -g @google/gemini-cli 명령을 찾은 곳에서 더 많은 정보를 얻을 수 있습니다.
  • 💡 Gemini CLI의 무료 사용 제한은?현재 1분당 6회, 하루에 1천회까지 무료로 사용할 수 있습니다