GeminiCode: 터미널에서 실행되는 Gemini 2.5 기반 AI 프로그래밍 도우미

10.7K 00

일반 소개

GeminiCode는 개발자들이 주말 여가 시간에 개발한 터미널에서 실행되는 AI 프로그래밍 도우미입니다. Google의 쌍둥이자리 컴퓨터의 현재 디렉터리에 있는 파일을 읽고 수정하는 2.5 프로 모델입니다. 이 도구는 다음에서 영감을 받았습니다. 인류학 (명목식 형태로 사용됨) Claude 코드의 목표는 프로그래머가 명령줄에서 직접 사용할 수 있는 도우미를 제공하는 것입니다. 프로덕션 환경용 소프트웨어가 아닌 실험적인 프로젝트이며 버그가 있을 수 있으므로 사용자는 주의해서 사용해야 합니다. 개발자는 민감한 파일을 조작하지 않도록 테스트 환경이나 중요하지 않은 디렉터리에서만 사용할 것을 권장합니다.

기능 목록

파일 읽기현재 디렉토리 및 하위 디렉터리에 있는 모든 파일의 내용을 자동으로 읽습니다.
문서 수정디렉토리에서 직접 파일을 생성, 편집 또는 삭제하여 코드를 변경할 수 있습니다.
명령을 실행합니다.터미널에서 bash 명령을 실행하여 간단한 작업을 수행할 수 있습니다.
코드 생성함수 작성과 같이 사용자 입력에 따라 코드를 생성합니다.
디버깅 지원오류 메시지를 분석하고 오류 해결을 위한 제안을 제공하는 데 도움이 됩니다.

도움말 사용

GeminiCode는 터미널에 설치하여 실행해야 하는 명령줄 도구입니다. 다음은 빠르게 시작할 수 있는 자세한 단계와 지침입니다. 참고: 명시적인 권한 프롬프트 없이 현재 디렉터리에 있는 파일에 직접 액세스하므로 사용하기 전에 디렉터리가 안전한지 확인하세요.

설치 프로세스

가상 환경 만들기
터미널을 열고 다음 명령을 입력하여 다른 프로젝트와 간섭을 피하기 위해 격리된 Python 환경을 만듭니다:

python3 -m venv venv
source venv/bin/activate

두 번째 명령을 실행하면 터미널에 다음과 같이 표시됩니다. (venv)로 표시되어 환경이 성공적으로 활성화되었음을 나타냅니다.

GeminiCode 설치
가상 환경에서 입력합니다:

pip install gemini-code

그러면 PyPI에서 최신 버전이 다운로드되어 설치됩니다. 설치 과정은 일반적으로 네트워크 속도에 따라 몇 초에서 1분 정도 걸립니다.

API 키 설정
Gemini 모델을 사용하려면 Google API 키가 필요합니다. 키를 받으려면 다음을 방문하세요. https://ai.google.dev/를 클릭하고 키를 등록하고 생성합니다. 그런 다음 터미널에 키를 입력합니다:

gemini setup YOUR_GOOGLE_API_KEY

상호 호환성 YOUR_GOOGLE_API_KEY 를 입력하세요. 설정이 완료되면 도구가 모델에 연결할 수 있습니다.

세션 시작
시작하려면 다음 명령을 입력합니다:

gemini

누락된 모듈이 있다는 메시지가 표시되는 경우 questionary실행 중입니다:

pip install questionary

또는 모델 시작을 지정합니다:

gemini --model models/gemini-2.5-pro-exp-03-25

시작하면 단말기가 대화형 모드로 전환됩니다.

기본 조작

카탈로그 파일 보기
세션에 입력합니다:

What files are in this directory?

이 도구는 현재 디렉터리에 있는 다음과 같은 모든 파일을 나열합니다. main.py및readme.txt.

코드 생성
입력 방식은 비슷합니다:

Create a simple Python function that calculates the Fibonacci sequence

예를 들어 도구가 코드를 생성하여 표시합니다:

def fibonacci(n):
if n <= 1:
return n
return fibonacci(n-1) + fibonacci(n-2)

파일로 복사하거나 도구가 직접 쓰도록 할 수 있습니다.

문서 수정
입력:

Add a print statement to main.py

다음과 같이 표시됩니다. main.py추가 print("Hello")을 클릭한 다음 저장합니다. 참고: 파일을 직접 수정하는 확인 단계는 없습니다.

코드 디버깅
예를 들어 오류 메시지를 붙여넣습니다:

Help me debug this error message: NameError: name 'x' is not defined

이 도구는 변수를 분석하고 정의할 것을 권장합니다. x.

명령을 실행합니다.
입력:

Run ls command

bash 명령을 실행하고 결과를 반환합니다(지원되는 간단한 명령어만).

로그아웃(컴퓨팅)
입력:

/exit

세션이 종료되고 일반 터미널로 돌아갑니다.

사용 시 주의사항

요청 제한무료 버전의 경우 하루 25건, 티어 1의 경우 100건입니다. 초과 시 1.5 Pro 모델로 전환되지만 불안정할 수 있습니다.
보안 권장 사항테스트 디렉터리에서만 사용하고 중요한 파일을 백업하세요. 격리성을 높이기 위해 Docker와 같은 컨테이너에서 실행할 수 있습니다.
일반적인 문제: 멈추면 세션을 다시 시작하세요. 다음 도움말을 참조하세요. /help.

실험적인 프로그래밍 작업에는 적합하지만 정식 개발에는 충분히 안정적이지 않으므로 터미널에서 GeminiCode를 사용할 수 있습니다.

애플리케이션 시나리오

빠른 테스트 코드
계산기와 같은 작은 함수를 테스트 작성하려고 합니다. GeminiCode를 사용하여 테스트 디렉터리에 코드를 생성하고 실행하기 전에 수동으로 확인할 수 있습니다.
디버그 학습하기
초보 프로그래머는 이해할 수 없는 오류 메시지가 발생하면 이를 GeminiCode에 붙여넣어 간단한 설명과 변경 방법에 대한 제안을 받을 수 있습니다.
임시 파일 작업
주석을 추가하는 등 파일의 내용을 대량으로 수정해야 하는 경우. GeminiCode를 사용하여 명령을 입력하면 몇 초 만에 완료됩니다.

QA

GeminiCode는 안전한가요?
완전히 안전하지는 않습니다. 보호 메커니즘 없이 파일에서 직접 작동합니다. 중요하지 않은 디렉터리에서만 사용하고 중요한 데이터는 백업하는 것이 좋습니다.
네트워크가 필요한가요?
예, 런타임에서 Google API를 호출하려면 인터넷 연결이 필요합니다.
어떤 파일 형식이 지원되나요?
는 다음과 같은 모든 텍스트 파일을 읽을 수 있습니다. .py및.txt하지만 주로 코드용으로 설계되었습니다.
요청 한도를 초과하면 어떻게 되나요?
1.5 프로 모델은 한도를 초과하면 자동으로 사용 중지되며 기능이 제한될 수 있습니다. 다음 날을 기다리거나 계정을 업그레이드하는 것이 좋습니다.