{"meta":{"title":"설정 가이드","intro":"이 가이드에서는 개인 쪽 프로젝트에서 수천 명의 사용자에게 서비스를 제공하는 프로덕션 플랫폼에 이르기까지 특정 사용 사례에 대한 Copilot SDK를 구성하는 방법을 안내합니다.","product":"GitHub Copilot","breadcrumbs":[{"href":"/ko/copilot","title":"GitHub Copilot"},{"href":"/ko/copilot/how-tos","title":"방법"},{"href":"/ko/copilot/how-tos/copilot-sdk","title":"코필로트 SDK"},{"href":"/ko/copilot/how-tos/copilot-sdk/setup","title":"Copilot SDK 설정"},{"href":"/ko/copilot/how-tos/copilot-sdk/setup/choosing-a-setup-path","title":"설정 경로 선택"}],"documentType":"article"},"body":"# 설정 가이드\n\n이 가이드에서는 개인 쪽 프로젝트에서 수천 명의 사용자에게 서비스를 제공하는 프로덕션 플랫폼에 이르기까지 특정 사용 사례에 대한 Copilot SDK를 구성하는 방법을 안내합니다.\n\n<!-- markdownlint-disable GHD046 GHD005 -->\n\n<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->\n\n## 아키텍처 개요\n\n모든 Copilot SDK 통합은 동일한 핵심 패턴을 따릅니다. 애플리케이션은 JSON-RPC를 통해 Copilot CLI와 통신하는 SDK와 통신합니다. 설정에서 변경되는 사항은 **CLI가 실행되는 위치**, **사용자가 인증하는 방법** 및 **세션 관리 방식입니다**.\n\n![다이어그램: 설명된 프로세스를 보여 주는 순서도입니다.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-0.png)\n\n아래 설정 가이드는 시나리오에 맞게 각 계층을 구성하는 데 도움이 됩니다.\n\n## 누구시죠?\n\n### 🧑 💻 아마추어\n\n개인 비서, 사이드 프로젝트 또는 실험적 앱을 빌드하고 있습니다. 코드에서 코필로트를 가져오는 가장 간단한 경로를 원합니다.\n\n**다음으로 시작합니다.**\n\n1. \\*\\*\n   [기본 설정(번들 CLI)](/ko/copilot/how-tos/copilot-sdk/setup/bundled-cli)\\*\\* - SDK에 CLI가 자동으로 포함되어 있습니다. 설치하고 이동하기만 하면\n2. \\*\\*\n   [로컬 CLI 설정](/ko/copilot/how-tos/copilot-sdk/setup/local-cli)\\*\\* - 사용자 고유의 CLI 이진 또는 실행 중인 인스턴스 사용(고급)\n\n### 🏢 내부 앱 개발자\n\n팀 또는 회사를 위한 도구를 빌드하고 있습니다. 사용자는 엔터프라이즈 GitHub 계정 또는 조직 멤버 자격으로 인증해야 하는 직원입니다.\n\n**다음으로 시작합니다.**\n\n1. \\*\\*\n   [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* - 직원이 GitHub 계정으로 로그인하도록 허용\n2. \\*\\*\n   [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)\\*\\* - 내부 서비스에서 SDK 실행\n\n**단일 서버 이상으로 스케일링하는 경우:**\n\n1. \\*\\*\n   [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\\*\\* - 다중 사용자 서버 모드에 대한 SDK 옵션 구성\n2. \\*\\*\n   [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\* - 여러 사용자 및 서비스 처리\n\n### 🚀 앱 개발자(ISV)\n\n고객을 위한 제품을 빌드하고 있습니다. GitHub 통해 또는 ID를 직접 관리하여 사용자에 대한 인증을 처리해야 합니다.\n\n**다음으로 시작합니다.**\n\n1. \\*\\*\n   [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* - 고객이 GitHub 로그인하도록 허용\n2. \\*\\*\n   [BYOK(사용자 고유의 키 가져오기)](/ko/copilot/how-tos/copilot-sdk/auth/byok)\\*\\* - 사용자 고유의 모델 키를 사용하여 ID 직접 관리\n3. \\*\\*\n   [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)\\*\\* - 서버 쪽 코드에서 제품 전원 공급\n\n**프로덕션의 경우:**\n\n1. \\*\\*\n   [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\\*\\* - 세션별 토큰 및 격리된 런타임 상태 사용 `mode: \"empty\"`\n2. \\*\\*\n   [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\* - 많은 고객에게 안정적으로 제공\n\n### 🏗️ 플랫폼 개발자\n\n다른 개발자가 빌드하는 API, 개발자 도구 또는 인프라와 같은 플랫폼에 Copilot를 포함하고 있습니다. 세션, 크기 조정 및 다중 테넌시에 대한 세분화된 제어가 필요합니다.\n\n**다음으로 시작합니다.**\n\n1. \\*\\*\n   [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)\\*\\* - 핵심 서버 쪽 통합\n2. \\*\\*\n   [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\\*\\* - SDK 수준 격리, 세션별 인증 및 공유 런타임 옵션\n3. \\*\\*\n   [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)\\*\\* - 세션 격리, 수평 크기 조정, 지속성\n\n**인증 모델에 따라:**\n\n1. \\*\\*\n   [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)\\*\\* - GitHub 인증된 사용자의 경우\n2. \\*\\*\n   [BYOK(사용자 고유의 키 가져오기)](/ko/copilot/how-tos/copilot-sdk/auth/byok)\\*\\* - 자체 관리 ID 및 모델 액세스의 경우\n\n## 의사 결정 행렬\n\n다음 표를 사용하여 수행해야 하는 작업을 기반으로 올바른 가이드를 찾을 수 있습니다.\n\n| 필요한 항목                                                                                 | 가이드 |\n| -------------------------------------------------------------------------------------- | --- |\n| 빠르게 시작                                                                                 |     |\n| [기본 설정(번들 CLI)](/ko/copilot/how-tos/copilot-sdk/setup/bundled-cli)                     |     |\n| 자체 CLI 바이너리 또는 서버 사용                                                                   |     |\n| [로컬 CLI 설정](/ko/copilot/how-tos/copilot-sdk/setup/local-cli)                           |     |\n| 사용자가 GitHub 사용하여 로그인                                                                   |     |\n| [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)                  |     |\n| 사용자 고유의 모델 키 사용(OpenAI, Azure 등)                                                       |     |\n| [BYOK(사용자 고유의 키 가져오기)](/ko/copilot/how-tos/copilot-sdk/auth/byok)                      |     |\n| 관리 ID를 사용하는 Azure BYOK(API 키 없음)                                                       |     |\n| [BYOK를 사용하는 Azure 관리 ID](/ko/copilot/how-tos/copilot-sdk/setup/azure-managed-identity) |     |\n| 서버에서 SDK 실행                                                                            |     |\n| [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)                  |     |\n| 동시 사용자에 대한 SDK 옵션 구성                                                                   |     |\n| [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)                  |     |\n| 여러 사용자 제공/수평으로 크기 조정                                                                   |     |\n| [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)                          |     |\n\n## 구성 비교\n\n![다이어그램: 설명된 프로세스를 보여 주는 순서도입니다.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-1.png)\n\n## 사전 요구 사항\n\n모든 안내서는 사용자가 다음 조건을 갖추고 있다고 가정합니다.\n\n* **다음 SDK 중 하나**가 설치되어 있어야 합니다(Node.js, Python 및 .NET SDK에는 CLI가 자동으로 포함됨):\n  * Node.js: `npm install @github/copilot-sdk`\n  * 파이썬: `pip install github-copilot-sdk`\n  * Go: `go get github.com/github/copilot-sdk/go` (별도의 CLI 설치 필요)\n  * .NET:`dotnet add package GitHub.Copilot.SDK`\n\n처음이라면 먼저 **[첫 번째 Copilot 기반 앱 빌드](/ko/copilot/how-tos/copilot-sdk/getting-started)** 부터 시작한 다음, 프로덕션 환경 구성을 위해 여기로 돌아오세요.\n\n## 다음 단계\n\n위의 [의사 결정 매트릭스](#decision-matrix) 에서 상황과 일치하는 가이드를 선택하거나 역할에 가장 가까운 가상 사용자 설명으로 시작합니다."}