Gemini Code Assist 도구 사용 설정
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 문서에서는 Gemini Code Assist 도구를 사용 설정하는 방법을 설명합니다.
Google Cloud 관리자는 IDE에서 개발자를 위한 도구를 사용 설정하려면 이 단계를 완료해야 합니다.
도구에 관한 자세한 내용은 Gemini Code Assist 도구 개요를 참조하세요. IDE에서 사용할 도구를 구성하려면 Gemini Code Assist 도구 구성을 참조하세요.
시작하기 전에
- Gemini Code Assist를 설정합니다.
- Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인하기
Developer Connect API를 사용 설정합니다.
API 사용 설정
개발자 연결은 Google과 Gemini Code Assist 도구 간에 연결을 만드는 데 사용됩니다.
필요한 역할
Gemini Code Assist 도구를 사용 설정하는 데 필요한 권한을 얻으려면 관리자에게 Google Cloud 프로젝트에 대한
Gemini Code Assist 도구 관리자(
roles/cloudaicompanion.codeToolsAdmin
) 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 상세 설명은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
Google API Console에서 Gemini Code Assist 도구 페이지로 이동합니다.
도구로 이동
사용 설정하려는 도구를 찾은 다음 사용 설정을 클릭합니다. 도구 세부정보 페이지가 열립니다.
구성 섹션에서 도구의 Developer Connect 계정 커넥터를 만들 리전을 선택합니다. 사용 가능한 리전은 Developer Connect 위치에 나열되어 있습니다.
사용 설정을 클릭합니다.
도구가 사용 설정되었습니다.
IDE에서 도구를 사용하려면 계정에 연결하라는 메시지가 표시됩니다. IDE에서 이 도구를 사용하려면 연결을 클릭하고 안내에 따라 계정을 연결합니다. 도구를 사용하지 않으려면 연결 단계를 건너뛰어도 됩니다.
개발자에게 Google Cloud 프로젝트에 대한 Gemini Code Assist 도구 사용자 (roles/cloudaicompanion.codeToolsUser
) 역할을 부여합니다.
개발자는 IDE에서 이 도구를 사용할 수 있습니다. 사용자는 Gemini Code Assist 채팅에서 @TOOL_NAME
을 사용하여 도구에 프롬프트를 표시하여 사용 설정된 Gemini Code Assist 도구에 인증할 수 있습니다. 여기서 TOOL_NAME은 Gemini Code Assist 도구의 이름입니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-09-02(UTC)
[null,null,["최종 업데이트: 2025-09-02(UTC)"],[],[],null,["| **Preview**\n|\n| This product or feature is in preview. Products and features that are\n| in preview are available \"as is\".\n\nThis document describes how to enable Gemini Code Assist tools.\nGoogle Cloud administrators should complete these steps to enable tools for\ndevelopers in their IDEs.\n\nFor more information about tools, read the\n[Gemini Code Assist tools overview](/gemini-code-assist/docs/tools-agents/tools-overview). To configure tools\nfor use in your IDE, see\n[Configure Gemini Code Assist tools](/gemini-code-assist/docs/tools-agents/configure-tools-standard-enterprise).\n\nBefore you begin\n\n1. [Set up Gemini Code Assist](/gemini-code-assist/docs/set-up-gemini-standard-enterprise).\n2. [Make sure billing is enabled for your Google Cloud project](https://cloud.google.com/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project)\n3. Enable the Developer Connect API.\n\n [Enable the API](https://console.cloud.google.com//flows/enableapi?apiid=developerconnect.googleapis.com)\n\n Developer Connect is used to create connections between Google and\n Gemini Code Assist tools.\n\nRequired roles To get the permissions that you need to enable Gemini Code Assist tools, ask your administrator to grant you the [Gemini Code Assist Tools Admin](https://cloud.google.com/iam/docs/roles-permissions/cloudaicompanion#cloudaicompanion.codeToolsAdmin) (`roles/cloudaicompanion.codeToolsAdmin`) role on the Google Cloud project.\n\n\u003cbr /\u003e\n\nFor more information about granting roles, see\n[Manage access to projects, folders, and organizations](https://cloud.google.com/iam/docs/granting-changing-revoking-access).\n\nYou might also be able to get the required permissions through\n[custom roles](https://cloud.google.com/iam/docs/creating-custom-roles) or\nother [predefined roles](https://cloud.google.com/iam/docs/understanding-roles).\n\n\nEnable tools\n\n1. In the Google API Console, go to the Gemini Code Assist **Tools**\n page.\n\n\n [Go to Tools](https://console.cloud.google.com/gemini-code-assist/agents-tools)\n2. Locate the tool you want to enable and then click **Enable**. The tool\n details page opens.\n\n3. In the **Configuration** section, select a region to create your\n Developer Connect account connector in for the tool. The available\n regions are listed in\n [Developer Connect locations](https://cloud.google.com/developer-connect/docs/locations).\n\n4. Click **Enable**.\n\n The tool is enabled.\n\n You are prompted to connect to your account to use the tool in the\n IDE. If you want to use the tool in the IDE, then click **Connect** and\n follow the instructions to connect your account. You can skip the connection\n step if you don't want to use the tool.\n5. Grant your developers the\n [Gemini Code Assist Tools User](https://cloud.google.com/iam/docs/roles-permissions/cloudaicompanion#cloudaicompanion.codeToolsUser) (`roles/cloudaicompanion.codeToolsUser`) role on the Google Cloud\n project.\n\n The tool is available to developers in their IDEs. Users can authenticate to\n enabled Gemini Code Assist tools by prompting the tool in the\n Gemini Code Assist chat with `@`\u003cvar translate=\"no\"\u003eTOOL_NAME\u003c/var\u003e. Where\n \u003cvar translate=\"no\"\u003eTOOL_NAME\u003c/var\u003e is the name of the Gemini Code Assist tool.\n\nWhat's next\n\n- [Configure Gemini Code Assist tools](/gemini-code-assist/docs/tools-agents/configure-tools-standard-enterprise).\n- [Get Started with Gemini Code Assist tools](/gemini-code-assist/docs/tools-agents/get-started-with-tools-standard-enterprise)."]]