# 설정 가이드

이 가이드에서는 개인 쪽 프로젝트에서 수천 명의 사용자에게 서비스를 제공하는 프로덕션 플랫폼에 이르기까지 특정 사용 사례에 대한 Copilot SDK를 구성하는 방법을 안내합니다.

<!-- markdownlint-disable GHD046 GHD005 -->

<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->

## 아키텍처 개요

모든 Copilot SDK 통합은 동일한 핵심 패턴을 따릅니다. 애플리케이션은 JSON-RPC를 통해 Copilot CLI와 통신하는 SDK와 통신합니다. 설정에서 변경되는 사항은 **CLI가 실행되는 위치**, **사용자가 인증하는 방법** 및 **세션 관리 방식입니다**.

![다이어그램: 설명된 프로세스를 보여 주는 순서도입니다.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-0.png)

아래 설정 가이드는 시나리오에 맞게 각 계층을 구성하는 데 도움이 됩니다.

## 누구시죠?

### 🧑 💻 아마추어

개인 비서, 사이드 프로젝트 또는 실험적 앱을 빌드하고 있습니다. 코드에서 코필로트를 가져오는 가장 간단한 경로를 원합니다.

**다음으로 시작합니다.**

1. \*\*
   [기본 설정(번들 CLI)](/ko/copilot/how-tos/copilot-sdk/setup/bundled-cli)\*\* - SDK에 CLI가 자동으로 포함되어 있습니다. 설치하고 이동하기만 하면
2. \*\*
   [로컬 CLI 설정](/ko/copilot/how-tos/copilot-sdk/setup/local-cli)\*\* - 사용자 고유의 CLI 이진 또는 실행 중인 인스턴스 사용(고급)

### 🏢 내부 앱 개발자

팀 또는 회사를 위한 도구를 빌드하고 있습니다. 사용자는 엔터프라이즈 GitHub 계정 또는 조직 멤버 자격으로 인증해야 하는 직원입니다.

**다음으로 시작합니다.**

1. \*\*
   [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* - 직원이 GitHub 계정으로 로그인하도록 허용
2. \*\*
   [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* - 내부 서비스에서 SDK 실행

**단일 서버 이상으로 스케일링하는 경우:**

1. \*\*
   [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\* - 다중 사용자 서버 모드에 대한 SDK 옵션 구성
2. \*\*
   [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)\*\* - 여러 사용자 및 서비스 처리

### 🚀 앱 개발자(ISV)

고객을 위한 제품을 빌드하고 있습니다. GitHub 통해 또는 ID를 직접 관리하여 사용자에 대한 인증을 처리해야 합니다.

**다음으로 시작합니다.**

1. \*\*
   [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* - 고객이 GitHub 로그인하도록 허용
2. \*\*
   [BYOK(사용자 고유의 키 가져오기)](/ko/copilot/how-tos/copilot-sdk/auth/byok)\*\* - 사용자 고유의 모델 키를 사용하여 ID 직접 관리
3. \*\*
   [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* - 서버 쪽 코드에서 제품 전원 공급

**프로덕션의 경우:**

1. \*\*
   [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\* - 세션별 토큰 및 격리된 런타임 상태 사용 `mode: "empty"`
2. \*\*
   [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)\*\* - 많은 고객에게 안정적으로 제공

### 🏗️ 플랫폼 개발자

다른 개발자가 빌드하는 API, 개발자 도구 또는 인프라와 같은 플랫폼에 Copilot를 포함하고 있습니다. 세션, 크기 조정 및 다중 테넌시에 대한 세분화된 제어가 필요합니다.

**다음으로 시작합니다.**

1. \*\*
   [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)\*\* - 핵심 서버 쪽 통합
2. \*\*
   [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)\*\* - SDK 수준 격리, 세션별 인증 및 공유 런타임 옵션
3. \*\*
   [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)\*\* - 세션 격리, 수평 크기 조정, 지속성

**인증 모델에 따라:**

1. \*\*
   [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)\*\* - GitHub 인증된 사용자의 경우
2. \*\*
   [BYOK(사용자 고유의 키 가져오기)](/ko/copilot/how-tos/copilot-sdk/auth/byok)\*\* - 자체 관리 ID 및 모델 액세스의 경우

## 의사 결정 행렬

다음 표를 사용하여 수행해야 하는 작업을 기반으로 올바른 가이드를 찾을 수 있습니다.

| 필요한 항목                                                                                 | 가이드 |
| -------------------------------------------------------------------------------------- | --- |
| 빠르게 시작                                                                                 |     |
| [기본 설정(번들 CLI)](/ko/copilot/how-tos/copilot-sdk/setup/bundled-cli)                     |     |
| 자체 CLI 바이너리 또는 서버 사용                                                                   |     |
| [로컬 CLI 설정](/ko/copilot/how-tos/copilot-sdk/setup/local-cli)                           |     |
| 사용자가 GitHub 사용하여 로그인                                                                   |     |
| [GitHub OAuth 설정](/ko/copilot/how-tos/copilot-sdk/setup/github-oauth)                  |     |
| 사용자 고유의 모델 키 사용(OpenAI, Azure 등)                                                       |     |
| [BYOK(사용자 고유의 키 가져오기)](/ko/copilot/how-tos/copilot-sdk/auth/byok)                      |     |
| 관리 ID를 사용하는 Azure BYOK(API 키 없음)                                                       |     |
| [BYOK를 사용하는 Azure 관리 ID](/ko/copilot/how-tos/copilot-sdk/setup/azure-managed-identity) |     |
| 서버에서 SDK 실행                                                                            |     |
| [백 엔드 서비스 설정](/ko/copilot/how-tos/copilot-sdk/setup/backend-services)                  |     |
| 동시 사용자에 대한 SDK 옵션 구성                                                                   |     |
| [다중 테넌트 및 서버 배포](/ko/copilot/how-tos/copilot-sdk/setup/multi-tenancy)                  |     |
| 여러 사용자 제공/수평으로 크기 조정                                                                   |     |
| [확장성 및 멀티 테넌시](/ko/copilot/how-tos/copilot-sdk/setup/scaling)                          |     |

## 구성 비교

![다이어그램: 설명된 프로세스를 보여 주는 순서도입니다.](/assets/images/help/copilot/copilot-sdk/setup-choosing-a-setup-path-diagram-1.png)

## 사전 요구 사항

모든 안내서는 사용자가 다음 조건을 갖추고 있다고 가정합니다.

* **다음 SDK 중 하나**가 설치되어 있어야 합니다(Node.js, Python 및 .NET SDK에는 CLI가 자동으로 포함됨):
  * Node.js: `npm install @github/copilot-sdk`
  * 파이썬: `pip install github-copilot-sdk`
  * Go: `go get github.com/github/copilot-sdk/go` (별도의 CLI 설치 필요)
  * .NET:`dotnet add package GitHub.Copilot.SDK`

처음이라면 먼저 **[첫 번째 Copilot 기반 앱 빌드](/ko/copilot/how-tos/copilot-sdk/getting-started)** 부터 시작한 다음, 프로덕션 환경 구성을 위해 여기로 돌아오세요.

## 다음 단계

위의 [의사 결정 매트릭스](#decision-matrix) 에서 상황과 일치하는 가이드를 선택하거나 역할에 가장 가까운 가상 사용자 설명으로 시작합니다.