GeminiCLI.net

Gemini CLI로 VS Code 워크플로우를 강화하는 방법

작성자: Gemini 가이드, 게시일: 2025. 6. 25.

Visual Studio Code는 수백만 개발자가 선택하는 편집기로, 유연성과 강력한 통합 터미널로 높은 평가를 받고 있습니다. 별도의 터미널 창에서 항상 Gemini CLI를 사용할 수도 있지만, 실제 생산성 향상은 코딩 워크플로우에 직접 통합할 때 나타납니다.

이 가이드는 VS Code 내에서 Gemini CLI를 사용하여 원활하고 AI 기반의 개발 경험을 만드는 방법을 보여줍니다.

기반: 통합 터미널 사용하기

Gemini CLI를 사용하는 가장 간단한 방법은 VS Code의 통합 터미널 내에서 사용하는 것입니다. Ctrl+` (Control + 백틱)을 눌러 열 수 있습니다.

여기에서 편집기를 떠나지 않고도 CLI의 모든 파일 기반 기능을 사용할 수 있습니다.

사용 사례 1: 복잡한 파일 설명하기

레거시 코드베이스를 물려받았거나 새로운 라이브러리를 탐색하고 있습니까? 열려 있는 모든 파일에 대한 높은 수준의 설명을 받아보세요.

  1. 이해하고 싶은 파일을 엽니다 (예: src/utils/complex-logic.js).
  2. 통합 터미널에서 다음을 실행합니다:
gemini -f src/utils/complex-logic.js "이 파일의 목적과 주요 기능에 대한 높은 수준의 요약을 제공해주세요."

사용 사례 2: 현재 파일 리팩터링하기

작동은 하지만 지저분하게 느껴지는 코드가 있습니까? Gemini가 개선 사항을 제안하도록 하세요.

gemini -f src/components/old-component.jsx "이 React 컴포넌트를 훅을 포함한 현대적인 모범 사례를 사용하도록 리팩터링해주세요. 원시 업데이트된 코드만 출력해주세요."

그런 다음 출력을 복사하여 이전 코드를 대체하거나 VS Code의 diff 뷰를 사용하여 변경 사항을 비교할 수 있습니다.

궁극의 통합: VS Code 작업

명령을 수동으로 실행하는 것도 유용하지만, 진정한 강력함은 사용자 지정 VS Code "작업"을 만드는 데 있습니다. 이를 통해 단일 명령이나 키보드 단축키로 현재 활성 파일에 대해 복잡한 Gemini CLI 명령을 실행할 수 있습니다.

1단계: tasks.json 파일 생성하기

  1. Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다.
  2. "Tasks: Configure Task"를 입력하고 Enter를 누릅니다.
  3. "Create tasks.json file from template"을 선택합니다.
  4. "Others"를 선택합니다.

이렇게 하면 프로젝트의 루트 디렉토리에 .vscode/tasks.json 파일이 생성됩니다.

2단계: Gemini 작업 정의하기

새 tasks.json 파일의 내용을 다음 구성으로 바꿉니다. 이는 gemini:explain, gemini:refactor, gemini:docs라는 세 가지 유용한 작업을 정의합니다.

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "gemini:explain",
      "type": "shell",
      "command": "gemini -f ${file} \"Explain this code to me. Focus on the core logic and any potential edge cases.\"",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      },
      "group": "gemini"
    },
    {
      "label": "gemini:refactor",
      "type": "shell",
      "command": "gemini -f ${file} \"Refactor this code to improve readability, efficiency, and adherence to best practices. Only output the raw code.\"",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      },
      "group": "gemini"
    },
    {
      "label": "gemini:docs",
      "type": "shell",
      "command": "gemini -f ${file} \"Generate professional documentation for this file in Markdown format. Include a description of the file's purpose, its functions/classes, their parameters, and what they return.\"",
      "problemMatcher": [],
      "presentation": {
        "reveal": "always",
        "panel": "new"
      },
      "group": "gemini"
    }
  ]
}

핵심 마법: ${file} 변수는 편집기에서 현재 열려 있는 파일의 경로로 자동 대체되는 특수 VS Code 변수입니다.

3단계: 작업 실행하기

이제 코드를 연 상태에서 다음을 수행합니다.

  1. Ctrl+Shift+P를 눌러 명령 팔레트를 엽니다.
  2. "Tasks: Run Task"를 입력하고 Enter를 누릅니다.
  3. gemini:explain, gemini:refactor, gemini:docs의 세 가지 Gemini 작업을 볼 수 있습니다.
  4. 하나를 선택합니다. 새 터미널 패널이 열리고 활성 파일에서 명령이 실행됩니다!

시각적 가이드: 실제 작동 보기

VS Code에서 터미널을 최대한 활용하는 방법에 대한 시각적 안내를 보려면 이 훌륭한 튜토리얼을 확인하세요.

Video Tutorial: Master VS Code Terminal: PowerShell, Git Bash, and Command Line Tips for Developers

더 빠른 액세스를 위해 각 작업에 키보드 단축키를 할당할 수 있습니다.

Gemini CLI를 편집기에 직접 통합함으로써 개인 워크플로우에 맞는 강력하고 맞춤화된 심층 통합 AI 비서를 만들 수 있습니다. VS Code 작업을 만드는 것은 훌륭한 첫걸음입니다. 다음 단계는 훨씬 더 복잡한 작업을 위해 독립 실행형 셸 스크립트를 구축하는 것입니다. 궁극의 자동화 가이드: 스크립트에서 Gemini CLI 사용하기에서 방법을 배우세요. 이 동일한 원칙은 터미널에서 바로 Google Workspace 작업 자동화하기와 같이 더욱 확장될 수 있습니다.

이 기사 공유: