{"meta":{"title":"엔터프라이즈에서 GitHub Copilot 사용자 지정 모델 사용","intro":"원하는 사용자 지정 모델을 GitHub Copilot 사용자 고유의 LLM API 키를 사용하여 통합하고 엔터프라이즈 계정의 조직에서 사용할 수 있도록 합니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/administer-copilot","title":"Copilot 관리"},{"href":"/ko/copilot/how-tos/administer-copilot/manage-for-enterprise","title":"엔터프라이즈용 관리"},{"href":"/ko/copilot/how-tos/administer-copilot/manage-for-enterprise/enable-custom-models","title":"사용자 지정 모델 사용"}],"documentType":"article"},"body":"# 엔터프라이즈에서 GitHub Copilot 사용자 지정 모델 사용\n\n원하는 사용자 지정 모델을 GitHub Copilot 사용자 고유의 LLM API 키를 사용하여 통합하고 엔터프라이즈 계정의 조직에서 사용할 수 있도록 합니다.\n\n> \\[!NOTE]\n> 이 기능은 공개 미리 보기에서 사용 중이며 변경될 수 있습니다.\n\n사용자 고유의 API 키를 제공하여 엔터프라이즈 또는 조직에 사용자 지정 모델을 추가할 수 있습니다. 이를 통해 팀은 원하는 LLM(대규모 언어 모델) 공급자를 Copilot Chat, Copilot CLI, and IDEs사용할 수 있습니다.\n\n다음 공급자의 API 키가 지원됩니다.\n\n* 인위적\n* AWS 베드록\n* Google AI Studio\n* Microsoft 파운드리\n* OpenAI\n* OpenAI 호환 공급자\n* xAI\n\n미세 조정된 모델도 지원되지만, 미세 조정 설정에 따라 기능 및 결과 품질이 달라질 수 있습니다. 프로덕션 환경에서 사용하기 전에 모델을 테스트하고 출력을 신중하게 검토해야 합니다.\n\n> \\[!NOTE] 별도의 기능을 사용하면 사용자가 다양한 클라이언트에서 로컬로 자신의 LLM 키를 구성할 수 있습니다.\n> [GitHub Copilot 위한 고유 키 가져오기](/ko/copilot/concepts/models/bring-your-own-key)을(를) 참조하세요.\n\n## 사용자 고유의 API 키를 가져오는 이유는 무엇인가요?\n\n엔터프라이즈 소유자는 거버넌스, 데이터 보안 및 규정 준수에 대한 특정 요구 사항이 있을 수 있습니다. 사용자 고유의 API 키를 설정하면 다음을 해결할 수 있습니다.\n\n* **거버넌스 및 규정 준수:** 조직의 정책 및 규정 요구 사항을 준수하는 LLM 공급자를 선택합니다.\n* **비용 관리:** 기존 결제 방법, 계약, 크레딧 또는 협상된 요금에 맞게 조정하고 사용량 초과를 방지합니다.\n* **가시성 및 제어:** 팀이 액세스할 수 있는 모델을 관리하고 공급자의 기존 대시보드 및 청구를 통해 사용량을 모니터링합니다.\n* **유연성:** 조직에서 이미 사용하고 있는 사용자 지정 또는 특수 모델을 지원합니다.\n\n## 엔터프라이즈 계정에 키 추가\n\n> \\[!IMPORTANT] 필요한 최소 범위만 API 키에 할당하여 최소 권한 원칙을 준수하는 것이 좋습니다.\n\n키를 추가하고 하나 이상의 모델을 선택하면 귀하와 귀하의 조직 구성원은 Copilot Chat, Copilot CLI, and IDEs에서 해당 모델을 사용할 수 있습니다. 모델은 기업 이름 아래에 있는 모델 선택기 맨 아래에 표시됩니다.\n\n1. 귀하의 기업으로 이동하세요. 예를 들어 GitHub.com의 [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) 페이지에서.\n\n2. 페이지 맨 위에서 **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copilot\" aria-label=\"copilot\" role=\"img\"><path d=\"M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z\"></path><path d=\"M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z\"></path></svg> AI 컨트롤을** 클릭합니다.\n\n3. 사이드바에서 을 클릭합니다 **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copilot\" aria-label=\"copilot\" role=\"img\"><path d=\"M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z\"></path><path d=\"M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z\"></path></svg>Copilot**.\n\n4. **사용자 지정 모델 구성**을 클릭합니다.\n\n5. API 키 목록 위에서 **API 키 추가**를 클릭합니다.\n\n6. \"공급자\"에서 사용하려는 LLM 공급자를 선택합니다.\n\n7. \"이름\" 아래에 이 키의 이름을 입력합니다. 모델 선택기에서 표시됩니다.\n\n8. \"API 키\"에서 키를 입력하거나 붙여넣습니다.\n\n9. 사용 중인 공급자에 따라 모델을 선택하거나 추가합니다.\n   * OpenAI, Anthropic 또는 xAI를 사용하는 경우 API 키 텍스트 필드를 클릭하여 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-sync\" aria-label=\"Fetch new models\" role=\"img\"><path d=\"M1.705 8.005a.75.75 0 0 1 .834.656 5.5 5.5 0 0 0 9.592 2.97l-1.204-1.204a.25.25 0 0 1 .177-.427h3.646a.25.25 0 0 1 .25.25v3.646a.25.25 0 0 1-.427.177l-1.38-1.38A7.002 7.002 0 0 1 1.05 8.84a.75.75 0 0 1 .656-.834ZM8 2.5a5.487 5.487 0 0 0-4.131 1.869l1.204 1.204A.25.25 0 0 1 4.896 6H1.25A.25.25 0 0 1 1 5.75V2.104a.25.25 0 0 1 .427-.177l1.38 1.38A7.002 7.002 0 0 1 14.95 7.16a.75.75 0 0 1-1.49.178A5.5 5.5 0 0 0 8 2.5Z\"></path></svg> 키와 연결된 모델을 가져옵니다. 다음으로, \"사용 가능한 모델\"에서 사용하려는 모델을 선택합니다.\n\n     ![\"API 키 추가\" 양식의 스크린샷 \"새 모델 가져오기\" 단추는 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/copilot/byok-add.png)\n\n   * Microsoft Foundry를 사용하는 경우 \"배포 URL\" 아래의 필드에 배포 URL을 입력합니다. 그런 다음, \"사용 가능한 모델\" 아래의 필드에 모델 ID를 입력하고 클릭하여 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-check\" aria-label=\"Add model\" role=\"img\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"></path></svg> 추가합니다.\n\n     모델에 다른 배포 URL이 있는 경우 동일한 API 키에 추가할 수 없습니다. 각 배포 URL에 대해 별도의 API 키를 만듭니다.\n\n     ![\"API 키 추가\" 양식의 스크린샷 모델 텍스트 필드와 \"모델 추가\" 단추는 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/copilot/byok-add-foundry.png)\n\n10. 사용할 모델을 선택하거나 추가한 후 **\\[저장**]을 클릭합니다.\n\n## 조직에서 사용자 지정 모델의 가용성 관리\n\n추가한 모델을 엔터프라이즈 계정의 조직에서 사용할 수 있는지 여부를 선택할 수 있습니다.\n\n1. 귀하의 기업으로 이동하세요. 예를 들어 GitHub.com의 [Enterprises](https://github.com/settings/enterprises?ref_product=ghec\\&ref_type=engagement\\&ref_style=text) 페이지에서.\n2. 페이지 맨 위에서 **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copilot\" aria-label=\"copilot\" role=\"img\"><path d=\"M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z\"></path><path d=\"M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z\"></path></svg> AI 컨트롤을** 클릭합니다.\n3. 사이드바에서 을 클릭합니다 **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-copilot\" aria-label=\"copilot\" role=\"img\"><path d=\"M7.998 15.035c-4.562 0-7.873-2.914-7.998-3.749V9.338c.085-.628.677-1.686 1.588-2.065.013-.07.024-.143.036-.218.029-.183.06-.384.126-.612-.201-.508-.254-1.084-.254-1.656 0-.87.128-1.769.693-2.484.579-.733 1.494-1.124 2.724-1.261 1.206-.134 2.262.034 2.944.765.05.053.096.108.139.165.044-.057.094-.112.143-.165.682-.731 1.738-.899 2.944-.765 1.23.137 2.145.528 2.724 1.261.566.715.693 1.614.693 2.484 0 .572-.053 1.148-.254 1.656.066.228.098.429.126.612.012.076.024.148.037.218.924.385 1.522 1.471 1.591 2.095v1.872c0 .766-3.351 3.795-8.002 3.795Zm0-1.485c2.28 0 4.584-1.11 5.002-1.433V7.862l-.023-.116c-.49.21-1.075.291-1.727.291-1.146 0-2.059-.327-2.71-.991A3.222 3.222 0 0 1 8 6.303a3.24 3.24 0 0 1-.544.743c-.65.664-1.563.991-2.71.991-.652 0-1.236-.081-1.727-.291l-.023.116v4.255c.419.323 2.722 1.433 5.002 1.433ZM6.762 2.83c-.193-.206-.637-.413-1.682-.297-1.019.113-1.479.404-1.713.7-.247.312-.369.789-.369 1.554 0 .793.129 1.171.308 1.371.162.181.519.379 1.442.379.853 0 1.339-.235 1.638-.54.315-.322.527-.827.617-1.553.117-.935-.037-1.395-.241-1.614Zm4.155-.297c-1.044-.116-1.488.091-1.681.297-.204.219-.359.679-.242 1.614.091.726.303 1.231.618 1.553.299.305.784.54 1.638.54.922 0 1.28-.198 1.442-.379.179-.2.308-.578.308-1.371 0-.765-.123-1.242-.37-1.554-.233-.296-.693-.587-1.713-.7Z\"></path><path d=\"M6.25 9.037a.75.75 0 0 1 .75.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 .75-.75Zm4.25.75v1.501a.75.75 0 0 1-1.5 0V9.787a.75.75 0 0 1 1.5 0Z\"></path></svg>Copilot**.\n4. **사용자 지정 모델 구성**을 클릭합니다.\n5. API 키 목록 위에서 **모델 추가** 탭을 클릭합니다.\n6. 모델 옆에 있는 **구성**을 클릭합니다. 이미 조직이 모델에 대한 접근 권한을 보유하고 있는 경우, \"구성\" 대신 **모든 조직** 또는 **X 조직**을 클릭해야 합니다.\n7. 열리는 모달에서 **액세스** 탭을 클릭합니다.\n   > \\[!NOTE] \"Access\" 탭을 사용하려면 먼저 모델을 '활성화'로 설정해야 합니다.\n8. 조직에서 모델을 사용할 수 있는 방법을 선택합니다.\n   * 엔터프라이즈 계정의 모든 조직에서 모델을 사용할 수 있도록 하려면 **모든 조직에 대해 허용을** 선택합니다.\n   * 특정 조직에서만 모델을 사용할 수 있도록 하려면 **조직별로 선택을** 선택하고 아래에 나열된 조직을 확인하거나 선택 취소합니다.\n9. **저장**을 클릭합니다.\n\n## 추가 읽기\n\n* ```\n            조직용 설명서의 [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/enable-custom-models).\n  ```\n* [GitHub 코필로트 채팅 정보](/ko/copilot/concepts/chat)\n* [GitHub Copilot 정책에 지원되는 표면](/ko/copilot/reference/supported-surfaces-for-policies)"}