Gemini Code Assist 코드 맞춤설정 사용

참고: Gemini Code Assist 코드 맞춤설정은 Gemini Code Assist Enterprise에서만 사용 가능합니다. 자세한 내용은 Gemini Code Assist 지원 기능을 참조하세요.

이 문서에서는 Gemini Code Assist 코드 맞춤설정을 사용하는 방법을 설명하고 몇 가지 권장사항을 제공합니다. 이 기능을 사용하면 조직의 내부 라이브러리, 비공개 API, 코딩 스타일을 기반으로 하는 코드 추천을 받을 수 있습니다.

시작하기 전에

1. Enterprise 구독으로 Gemini Code Assist를 설정합니다.
2. Gemini Code Assist 코드 맞춤설정을 설정합니다.

코드 맞춤설정 사용 방법

다음 표에는 Gemini Code Assist 코드 맞춤설정을 사용하는 방법이 나와 있습니다.

양식	트리거 방법	메모 및 리소스
자연어 채팅	IDE의 Gemini Code Assist 채팅에 자연어 프롬프트를 입력합니다.	다음 사항을 고려하세요. 채팅 기록을 사용할 수 없습니다. 여러 단계의 쿼리를 피하세요. 특정 소스에 대한 링크를 포함하여 소스에 대한 자세한 정보를 요청할 수 있습니다. 채팅에서 메시지를 보낼 때 코드를 강조 표시하거나 선택하면 Gemini Code Assist에서 해당 코드를 사용하여 코드 맞춤설정과 채팅 품질을 개선합니다. 자세한 내용은 Gemini Code Assist와 채팅하기를 참조하세요.
코드 생성	코드 선택 여부와 관계없이 IDE의 빠른 선택 표시줄에서 Command+Enter(macOS의 경우) 또는 Control+Enter를 누릅니다.	자세한 내용은 프롬프트로 코드 생성을 참조하세요.
코드 변환	코드 선택 여부와 관계없이 IDE의 빠른 선택 표시줄에 /fix를 입력합니다.	자세한 내용은 프롬프트로 코드 생성을 참조하세요.
자동 완성	코드 맞춤설정이 자동으로 트리거되고 작성 내용을 기반으로 추천을 제공합니다.	다음 사항을 고려하세요. 코드를 완성하려면 추천을 제안하기 위한 일정 수준의 신뢰도가 필요합니다. 관련 스니펫이 검색될 수 있도록 상당량의 코드를 사용할 수 있는지 확인합니다. 코드 완성은 함수의 특정 요소를 사용하기 위해 필요한 라이브러리가 있는지 확인합니다. 자세한 내용은 코드 완성 가져오기를 참조하세요.
원격 저장소 컨텍스트	프롬프트를 @ 기호로 시작합니다. 색인이 생성된 사용 가능한 원격 저장소 목록이 표시됩니다. 목록에서 컨텍스트에 사용할 저장소를 선택합니다. 저장소 이름을 입력하여 목록을 필터링할 수도 있습니다. 저장소를 선택한 후 나머지 프롬프트를 작성합니다.	다음 사항을 고려하세요. 에이전트 모드에서는 지원되지 않습니다. 주로 특정 마이크로서비스, 라이브러리 또는 모듈과 관련된 태스크를 할 때 유용합니다. 자세한 내용은 원격 저장소 컨텍스트를 사용하여 관련성 높은 추천 받기를 참조하세요.

사용 사례 및 프롬프트 예시

다음 표에는 특정 사용 사례에서 코드 맞춤설정을 사용하는 방법에 대한 안내와 예시가 나와 있습니다.

사용 사례	시도해 볼 만한 작업
새 코드 작성	다음을 사용하여 IDE 또는 Gemini Code Assist 채팅에서 코드를 생성해 봅니다. 코드베이스에 이미 언급된 용어를 사용할 코드를 생성합니다. 함수 서명이나 TODO 주석이 있는 코드와 같은 코드를 붙여넣은 후 Gemini Code Assist에 TODO 주석을 채우거나 코드로 대체하도록 요청합니다. 맥락의 설명과 함께 주석을 추가합니다. Gemini Code Assist 채팅에서 다음 프롬프트를 작성하여 코드를 생성해 봅니다. 'DATABASE에 대한 연결이 생성되는 기본 함수를 작성하세요. 상태 점검을 포함하세요.' 'EXPLAIN_STRUCTURE 구조로 FUNCTION_OR_CLASS를 작성합니다.' 일부 코드를 생성한 후 후속 프롬프트를 사용하여 코드를 개선해 봅니다. '/fix 명령어를 사용하여 생성된 코드를 조정해 보세요(예: 구문 오류).' '누락된 가져오기를 추가하세요.' '채팅에서 생성된 코드에서 /fix를 사용해 보세요.'
코드 정리, 간소화, 리팩터링	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. '이 파일에서 IMPORTS_VARIABLES_OR_NOTE_EXPORTED_FUNCTIONS를 병합할 수 있나요?' 'FUNCTION_NAME 함수를 어떻게 간소화하나요?' 'FUNCTION_NAME_1 및 FUNCTION_NAME_2를 함수 하나에 병합할 수 있나요?' 'FUNCTION_NAME에서 일부 변수를 즉시 처리할 수 있나요?' 'FUNCTION_NAME 함수에서 변수 이름 지정을 간소화할 수 있나요?'
가독성	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. '가능한 한 적은 수의 코드 줄로 FUNCTION_NAME 함수를 작성하세요.' 'FUNCTION_NAME 함수에 주석을 추가하세요.' 'FUNCTION_NAME 함수에서 불필요한 공백을 삭제하세요.' 'FUNCTION_NAME 함수의 형식을 나머지 코드와 비슷한 방식으로 지정하세요.'
코드 검토	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. '코드를 여러 부분으로 분할하고 코드베이스를 사용하여 각 부분을 설명해 주세요.' '더 간결하고 명확하게 설명할 수 있는 변수나 키워드가 있나요?' '이 코드에 사용할 REPOSITORY_NAME_PACKAGE_MODULE 컨텍스트에서 유용한 코드를 제공할 수 있나요?' 'FUNCTION_NAME 함수에 대해 어떻게 생각하나요?'
디버깅	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. 'X를 실행하거나 Y를 추가하려고 하면 오류가 발생합니다. 이유가 무엇인가요?' 'FUNCTION_NAME 함수에서 오류를 발견할 수 있나요?' '이 오류 메시지가 표시되면 FUNCTION_NAME 함수를 어떻게 수정하나요?'
학습 및 온보딩	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. '이 코드를 여러 부분으로 분할하고 코드베이스를 사용하여 각 부분을 설명해 주세요." 'FUNCTION_NAME 함수를 호출하는 방법을 알려주세요.' 'ENVIRONMENT_NAME 환경에서 기본 함수를 실행하는 방법을 보여주세요.' '이 코드의 성능을 향상시키기 위해 할 수 있는 주요 기술적 개선사항은 무엇인가요?' '더 나은 결과를 얻고 특정 요소를 추가할 수 있는 FUNCTION_OR_CLASS_NAME 구현을 보여주세요.' (예: 'foo가 함수 이름인 foo 함수 구현을 보여주세요.')
마이그레이션	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. 'FILE_NAME를 LANGUAGE_1에서 LANGUAGE_2로 마이그레이션하는 전략을 알려주세요.' (예: Go에서 Python으로) 'REPOSITORY_NAME 저장소의 FUNCTION_NAME 함수가 사용할 때 사용할 수 있는 LANGUAGE_NAME 언어에서 상응하는 함수를 찾아주세요.' 프롬프트를 사용하여 다음과 같은 채팅 기반 또는 코드 생성 변환 워크플로를 사용해 봅니다. '이미 LANGUAGE_1로 작성된 FILENAME_COMPONENT 코드를 리팩터링하여 LANGUAGE_2로 마이그레이션하세요.' (예: Go에서 Python으로) 일부 코드를 마이그레이션한 후 다음을 시도해 봅니다. 더 작은 청크를 선택하고 /fix를 사용하여 원하는 상태로 만듭니다. 다음과 같은 프롬프트를 사용해 봅니다. '개선할 점이 있나요?' '발생할 수 있는 문제를 알려주세요.' '마이그레이션이 올바른 경우 이 코드를 어떻게 테스트하나요?'
문서 생성	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. 'X 패키지 또는 폴더의 코드를 요약하고 가장 중요한 5가지 메서드에 대한 문서를 제공해 주세요.' 'FUNCTION_OR_CLASS_NAME 문서를 생성하세요.' '핵심 정보는 유지하면서 문서를 줄여주세요.'
단위 테스트 생성	Gemini Code Assist 채팅에서 다음 프롬프트를 작성해 봅니다. 'FILENAME의 단위 테스트를 생성하세요.' 'FUNCTION_NAME 함수와 가장 관련성이 높은 테스트 사례를 추가하세요.' '가치가 크지 않다고 생각되는 테스트 사례를 삭제하세요.'

권장사항

• 관련 변수와 함수 이름 또는 코드 스니펫을 사용합니다. 이렇게 하면 코드 맞춤설정이 가장 적절한 코드 예시로 안내됩니다.
• 확장하려는 색인 저장소를 사용하고 지원 중단된 기능을 추가하지 마세요. 코드 맞춤설정은 코드베이스 전반에서 코드 스타일, 패턴, 코드 시맨틱, 지식, 구현을 확장하는 데 도움이 됩니다. 확장할 저장소의 나쁜 예시는 지원 중단된 기능, 생성된 코드, 기존 구현입니다.
• 코드 검색 사용 사례의 경우 코드 완성 대신 코드 생성 기능을 사용합니다. 'FUNCTION_NAME 정의를 사용하여 정확하게 같은 함수를 생성하세요.' 또는 '정확한 FUNCTION_NAME 구현을 생성하세요'와 같은 언어를 사용하여 프롬프트를 작성합니다.
• Gemini 문맥 인지가 개선되도록 검색하려는 코드의 파일에 있는 항목을 포함하거나 가져옵니다.
• 프롬프트당 작업 하나만 실행합니다. 예를 들어 코드를 검색하여 이 코드를 새 함수에서 구현하려면 두 프롬프트에서 다음 단계를 수행합니다.
• 코드 외의 항목이 더 필요한 사용 사례의 경우(예: 코드 설명, 마이그레이션 계획 또는 오류 설명) 맥락의 코드베이스를 사용하여 Gemini와 대화하는 챗팅용 코드 맞춤설정을 사용합니다.
• AI 모델 생성은 비결정적입니다. 응답에 만족하지 못하는 경우 같은 프롬프트를 다시 실행하면 더 나은 결과를 얻을 수 있습니다.
• 단위 테스트 생성은 일반적으로 파일을 로컬에서 연 다음 채팅에서 이 파일이나 특정 함수의 단위 테스트 생성을 요청하는 경우에 더욱 효과적으로 작동합니다.

원격 저장소 컨텍스트를 사용하여 관련성 높은 추천 받기

Gemini Code Assist가 특정 원격 저장소에 집중하도록 지시하면 상황에 맞는 관련 코드 추천을 받을 수 있습니다. 채팅에서 @ 기호를 사용하면 프롬프트의 기본 컨텍스트 소스로 사용할 저장소를 하나 이상 선택할 수 있습니다. 주로 특정 마이크로서비스, 라이브러리 또는 모듈과 관련된 태스크를 할 때 유용합니다.

원격 저장소를 컨텍스트로 사용하려면 IDE의 채팅에서 다음 단계를 따르세요.

1. 프롬프트를 @ 기호로 시작합니다. 색인이 생성된 사용 가능한 원격 저장소 목록이 표시됩니다.
2. 목록에서 컨텍스트에 사용할 저장소를 선택합니다. 저장소 이름을 입력하여 목록을 필터링할 수도 있습니다.
3. 저장소를 선택한 후 나머지 프롬프트를 작성합니다.

그러면 Gemini가 응답을 생성할 때 선택한 저장소를 우선시합니다.

프롬프트 예시

이 기능을 사용할 수 있는 몇 가지 예시는 다음과 같습니다.

• 저장소를 이해하려면 다음 단계를 따르세요.
  • "@REPOSITORY_NAME 이 저장소의 전체 구조는 어떻게 돼?"
  • "@REPOSITORY_NAME 나는 신입 팀원이야. 이 저장소의 용도와 주요 모듈을 간략하게 설명해 줄 수 있어?"
• 코드 생성 및 수정:
  • "@REPOSITORY_NAME 이 저장소에 있는 것과 비슷한 인증 함수를 구현해 줘."
  • "@REPOSITORY_NAME 선택한 저장소의 규칙을 따르도록 다음 코드를 리팩터링해 줘."
  • "@REPOSITORY_A_NAME 이 저장소의 최신 기능을 사용해 REPOSITORY_B_NAME의 코드를 개선하려면 어떻게 해야 해?"
• 테스트용:
  • "@UNIT_TEST_FILE_NAME 선택한 파일의 예시를 기반으로 MODULE의 단위 테스트를 생성해 줘."

원격 저장소를 집중적인 컨텍스트 소스로 사용하면 Gemini Code Assist에서 더 정확하고 관련성 높은 추천을 받을 수 있어 더 빠르고 효율적으로 코딩할 수 있습니다.