{"meta":{"title":"리포지토리에 대한 codespace 만들기","intro":"리포지토리의 분기에 대한 codespace를 만들어 온라인으로 개발할 수 있습니다.","product":"Codespaces","breadcrumbs":[{"href":"/ko/codespaces","title":"Codespaces"},{"href":"/ko/codespaces/developing-in-a-codespace","title":"codespace에서 개발"},{"href":"/ko/codespaces/developing-in-a-codespace/creating-a-codespace-for-a-repository","title":"리포지토리에 대한 codespace 만들기"}],"documentType":"article"},"body":"# 리포지토리에 대한 codespace 만들기\n\n리포지토리의 분기에 대한 codespace를 만들어 온라인으로 개발할 수 있습니다.\n\n## 리포지토리의 codespace 생성에 대한 정보\n\nGitHub의 Visual Studio Code에서 생성하거나 GitHub CLI을(를) 사용하여 codespace를 생성할 수 있습니다. 이 문서의 탭을 사용하여 codespace를 만드는 이러한 각 방법에 대한 지침을 표시합니다.\n\nGitHub Codespaces을(를) 개인 GitHub 계정에서 사용할 수 있으며 무료 및 Pro 플랜의 계정에 매월 무료 사용 할당량이 포함됩니다. 결제 세부 정보를 제공하고 지출 한도를 설정하여 GitHub Codespaces을(를) 월별 포함된 스토리지 및 컴퓨팅 사용량 이상으로 계속 사용할 수 있습니다. [GitHub Codespaces 청구](/ko/billing/managing-billing-for-your-products/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)을(를) 참조하세요.\n\n조직에서는 조직의 비용으로 구성원 및 외부 협력자가 codespace를 만들고 사용할 수 있습니다. 자세한 내용은 [조직에서 codespace를 소유하고 비용을 지불하는 사람 선택](/ko/codespaces/managing-codespaces-for-your-organization/choosing-who-owns-and-pays-for-codespaces-in-your-organization)을(를) 참조하세요.\n\n조직 소유 리포지토리에서 codespace를 만드는 기능은 리포지토리의 가시성과 조직 또는 상위 기업의 설정을 비롯한 여러 요인에 따라 달라집니다. 자세한 내용은 [Codespaces 만들기 및 삭제 문제 해결](/ko/codespaces/troubleshooting/troubleshooting-creation-and-deletion-of-codespaces#no-access-to-create-a-codespace)을(를) 참조하세요.\n\n새 프로젝트를 시작하는 경우 템플릿에서 codespace를 만들고 나중에 GitHub의 리포지토리에 게시할 수 있습니다. 자세한 내용은 [템플릿에서 codespace 만들기](/ko/codespaces/developing-in-a-codespace/creating-a-codespace-from-a-template)을(를) 참조하세요.\n\n리포지토리에서 codespace를 만드는 경우 codespace는 비어 있을 수 없는 특정 분기와 연결됩니다. 리포지토리 또는 분기당 둘 이상의 codespace를 만들 수 있습니다.\n\n\"내 codespaces\" 페이지에서 자신이 만든 사용 가능한 모든 codespace를 볼 수 있습니다. 이 페이지를 표시하려면 GitHub의 왼쪽 위 모서리에서 을(를) 선택한 다음 ** Codespaces**를 클릭합니다. 이렇게 하면 [github.com/codespaces](https://github.com/codespaces)로 이동합니다.\n\n### Codespace 생성 프로세스\n\nCodespace를 만드는 경우 개발 환경을 만들고 연결하기 위해 여러 단계가 수행됩니다.\n\n* 1단계: VM 및 스토리지가 codespace에 할당됩니다.\n* 2단계: 컨테이너가 생성되고 리포지토리가 복제됩니다.\n* 3단계: Codespace에 연결할 수 있습니다.\n* 4단계: Codespace에서 생성 후 설정을 계속합니다.\n\nCodespace를 만들 때 수행되는 작업에 대한 자세한 내용은 [GitHub Codespaces에 대한 심층 분석](/ko/codespaces/about-codespaces/deep-dive)을(를) 참조하세요.\n\ncodespace의 수명 주기에 대한 자세한 내용은 [codespace 수명 주기 이해](/ko/codespaces/about-codespaces/understanding-the-codespace-lifecycle)을(를) 참조하세요.\n\nCodespace에 Git 후크를 사용하려면 `devcontainer.json` 수명 주기 스크립트(예: `postCreateCommand`)를 사용하여 후크를 설정해야 합니다. 이러한 항목은 위의 4단계에서 실행됩니다. 개발 컨테이너 수명 주기 스크립트에 대한 자세한 내용은 개발 컨테이너 웹사이트의 [개발 컨테이너 사양](https://containers.dev/implementors/json_reference/#lifecycle-scripts)을 참조하세요. 리포지토리가 복제된 후 codespace에 dev 컨테이너가 생성되므로 컨테이너 이미지에서 구성된 [git 템플릿 디렉터리](https://git-scm.com/docs/git-init#_template_directory)는 codespace에 적용되지 않습니다. 따라서 후크는 codespace가 생성된 이후에 설치해야 합니다.\n\nVS Code를 사용하여 codespace에서 개발하는 동안 코드를 편집하고, 디버그하고, Git 명령을 사용할 수 있습니다. 자세한 내용은 [VS Code 설명서](https://code.visualstudio.com/docs)를 참조하세요.\n\n리포지토리 관리자는 codespace 만들기 속도를 높이기 위해 리포지토리에서 GitHub Codespaces 사전 빌드를 사용하도록 설정할 수 있습니다. 자세한 내용은 [GitHub Codespaces 사전 빌드 정보](/ko/codespaces/prebuilding-your-codespaces/about-github-codespaces-prebuilds)을(를) 참조하세요.\n\n## 리포지토리에 대한 codespace 만들기\n\n
\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n\n2. 리포지토리 이름 아래에서 현재 분기의 이름으로 레이블이 지정된 분기 드롭다운 메뉴를 선택한 다음 codespace를 만들려는 분기를 클릭합니다.\n\n ![다양한 분기를 나열하는 확장된 분기 드롭다운 메뉴의 스크린샷입니다. 분기 아이콘이 표시된 \"trunk\" 드롭다운 메뉴는 주황색 윤곽선으로 표시됩니다.](/assets/images/help/codespaces/branch-drop-down.png)\n\n3. ```\n ** Code** 단추를 클릭한 다음, **Codespaces** 탭을 클릭합니다.\n ```\n\n Codespace에 대한 비용을 지불할 사람을 알려주는 메시지가 대화 상자 하단에 표시됩니다.\n\n ![Codespace 대화 상자의 스크린샷 Codespace에 대한 비용을 지불할 사용자를 보여 주는 메시지가 진한 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/codespaces/who-will-pay.png)\n\n4. 기본 옵션을 사용하거나 고급 옵션을 구성한 후 codespace를 만듭니다.\n\n * ```\n **기본 옵션 사용**\n ```\n\n 기본 옵션을 사용하여 codespace를 만들려면 을(를) 클릭합니다.

\n\n * ```\n **고급 옵션 구성**\n ```\n\n 다른 머신 유형 또는 특정 `devcontainer.json` 파일과 같은 codespace의 고급 옵션을 구성하려면 다음을 수행합니다.\n\n 1. ```\n **Codespaces** 탭의 오른쪽 위에서 을(를) 선택하고 **옵션으로 새로 만들기**를 클릭합니다.\n ```\n\n ![\"Codespaces\" 탭의 옵션 드롭다운에서 \"옵션으로 새로 만들기\" 옵션이 강조 표시된 스크린샷](/assets/images/help/codespaces/default-machine-type.png)\n\n 2. Codespace의 옵션 페이지에 있는 드롭다운 메뉴에서 원하는 옵션을 선택합니다.\n\n ![\"분기\", \"개발 컨테이너 구성\", \"지역\" 및 \"머신 유형\"에 대한 단추가 있는 고급 옵션 페이지의 스크린샷](/assets/images/help/codespaces/advanced-options.png)\n\n 옵션 페이지에는 Codespaces 설정에서 만드는 것을 권하는 하나 이상의 비밀 이름이 표시될 수 있습니다. 자세한 내용은 [권장되는 비밀](#recommended-secrets)을 참조하세요.\n\n > \\[!NOTE]\n >\n > * 옵션 페이지를 북마크하여 이 리포지토리와 분기에 대한 codespace를 빠르게 생성할 수 있습니다.\n > *\n\n ```\n [\n ```\n\n ```\n https://github.com/codespaces/new\n ](https://github.com/codespaces/new) 페이지에서는 모든 리포지토리 및 분기에 대한 codespace를 빠르게 생성할 수 있습니다. 브라우저의 주소 표시줄에 `codespace.new`을(를) 입력하면 이 페이지로 빠르게 이동할 수 있습니다.\n ```\n\n > * 개발 컨테이너 구성 파일에 대한 자세한 내용은 [개발 컨테이너 소개](/ko/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers)을(를) 참조하세요.\n > * 머신 유형에 대한 자세한 내용은 [codespace에 대한 컴퓨터 유형 변경](/ko/codespaces/customizing-your-codespace/changing-the-machine-type-for-your-codespace#about-machine-types)을(를) 참조하세요.\n > * {데이터 재사용 가능성 코드스페이스.코드스페이스 기계 유형 가용성%}\n\n 3. ```\n **코드스페이스 만들기**를 클릭합니다.\n ```\n\n## 권장되는 비밀\n\nCodespace를 만들 때 고급 옵션 페이지에 사용자 정의된 비밀의 이름이 표시될 수 있습니다. 선택한 개발 컨테이너 구성에 권장되는 비밀이 지정된 경우에 표시됩니다. 자세한 내용은 [리포지토리에 권장되는 비밀 지정](/ko/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/specifying-recommended-secrets-for-a-repository)을(를) 참조하세요.\n\nScreenshot of the \"Create codespace\" page with four recommended secrets highlighted with a dark orange outline.\n\n이러한 개발 환경 비밀에 대한 값을 입력하라는 메시지가 표시되면 프로젝트에서 이러한 비밀에 대한 값이 필요할 가능성이 높기 때문에 해당 값을 입력하는 것을 권장합니다. 그러나 codespace를 만들기 위해 값을 제공할 필요는 없습니다. 원하는 경우 codespace 내에서 이러한 비밀을 설정할 수 있습니다.\n\n권장 비밀에 대한 값을 입력하면 새 codespace에서 비밀을 사용할 수 있습니다.\n**Codespace 만들기**를 클릭하면 Codespaces에 대한 개인 설정에도 비밀이 추가되므로 나중에 이 리포지토리에 대한 codespace를 만들 때 비밀 값을 입력할 필요가 없습니다.\n\n비밀 이름에 선택할 수 없는 체크 상자가 표시되고 입력 상자가 없는 경우는 Codespaces에 대한 개인 설정에 해당 이름의 비밀이 이미 구성되어 있고 그 개인 설정을 이 리포지토리와 연결했기 때문입니다. 해당 이름의 비밀을 만들었지만 이 리포지토리와 연결하지 않은 경우 체크 상자를 선택할 수 있으며 이를 선택하면 설정을 업데이트하여 연결을 추가할 수 있습니다.\n\n미리 선택한 비밀의 값을 변경하려면 [github.com/settings/codespaces](https://github.com/settings/codespaces)의 Codespaces에 대한 개인 설정에서 변경할 수 있습니다. 자세한 내용은 [GitHub Codespaces에 대한 계정별 비밀 관리](/ko/codespaces/managing-your-codespaces/managing-your-account-specific-secrets-for-github-codespaces)을(를) 참조하세요.\n\n
\n\n
\n\nGitHub의 계정을 GitHub Codespaces 확장에 연결한 후 새 codespace를 만들 수 있습니다. GitHub Codespaces 확장에 대한 자세한 내용은 [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=GitHub.codespaces)을(를) 참조하세요.\n\n1. VS Code의 활성 바에서 원격 탐색기 아이콘을 클릭합니다.\n\n ![작업 표시줄의 스크린샷. \"원격 탐색기\" 사이드바의 아이콘(원으로 겹쳐진 사각형)이 주황색 윤곽선으로 강조 표시됩니다.](/assets/images/help/codespaces/click-remote-explorer-icon-vscode.png)\n\n > \\[!NOTE]\n > 원격 탐색기가 작업 막대에 표시되지 않는 경우:\n >\n > 1. 명령 팔레트에 액세스합니다. 예를 들어, Shift+Command+P(Mac)/Ctrl+Shift+P(Windows/Linux)를 누릅니다.\n > 2. 유형: `details`.\n > 3. **Codespaces: 세부 정보**를 클릭합니다.\n\n2. \"원격 탐색기\" 사이드바를 마우스로 가리키고 을 클릭합니다.\n\n ![GitHub Codespaces의 \"원격 탐색기\" 사이드바 스크린샷. 더하기 기호 단추 옆에 \"새 codespace 만들기\" 도구 설명이 표시됩니다.](/assets/images/help/codespaces/create-codespace-vscode.png)\n\n3. 입력란에 개발하려는 리포지토리의 이름을 입력한 다음 선택합니다.\n\n ![텍스트 상자에 입력한 \"octo-org/he\"의 스크린샷과 이 문자열로 시작하는 4개의 리포지토리 목록입니다.](/assets/images/help/codespaces/choose-repository-vscode.png)\n\n 이후 프롬프트의 오른쪽에 codespace에 대한 비용을 지불할 사람을 알려주는 메시지가 표시됩니다.\n\n ![\"Hubwriter에서 지불한 사용량\"이라는 메시지가 있는 분기에 대한 프롬프트의 스크린샷.](/assets/images/help/codespaces/who-will-pay-vscode.png)\n\n4. 개발하려는 분기를 클릭합니다.\n\n5. 개발 컨테이너 구성 파일을 선택하라는 메시지가 표시되면 목록에서 파일을 선택합니다.\n\n6. 사용할 머신 유형을 클릭합니다.\n\n > \\[!NOTE]\n > 사용 가능한 컴퓨터 유형의 선택은 여러 가지 요인에 의해 제한될 수 있습니다. 여기에는 조직에 대해 구성된 정책 또는 리포지토리에 대한 최소 컴퓨터 유형 사양이 포함될 수 있습니다. 자세한 내용은 [컴퓨터 유형에 대한 액세스 제한](/ko/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types) 및 [codespace 머신에 대한 최소 사양 설정](/ko/codespaces/setting-up-your-project-for-codespaces/configuring-dev-containers/setting-a-minimum-specification-for-codespace-machines)을(를) 참조하세요.\n\n
\n\n
\n\n> \\[!NOTE]\n> GitHub CLI에 대한 자세한 내용은 [GitHub CLI 정보](/ko/github-cli/github-cli/about-github-cli)을(를) 참조하세요.\n\n새 codespace를 만들려면 `gh codespace create` 하위 명령을 사용합니다.\n\n```shell\ngh codespace create\n```\n\n리포지토리를 선택하라는 메시지가 표시됩니다. Codespace에 대한 비용을 지불할 사람을 알려주는 메시지가 표시됩니다. 분기, 개발 컨테이너 구성 파일(둘 이상 사용 가능한 경우) 및 머신 유형(둘 이상 사용 가능한 경우)을 선택하라는 메시지가 표시됩니다.\n\n또는 플래그를 사용하여 다음 옵션을 일부 또는 모두 지정할 수 있습니다.\n\n```shell\ngh codespace create -r OWNER/REPO -b BRANCH --devcontainer-path PATH -m MACHINE-TYPE\n```\n\n이 예에서는 `owner/repo`을(를) 리포지토리 식별자로 바꿉니다.\n`branch`을(를) codespace에서 초기에 체크 아웃할 분기 이름 또는 커밋의 전체 SHA 해시로 바꿉니다.\n`-r` 플래그 없이 `b` 플래그를 사용하면 기본 분기에서 codespace가 생성됩니다.\n\n```\n `path`을(를) 새 codespace에 사용할 개발 컨테이너 구성 파일의 경로로 바꿉니다. 이 플래그를 생략했으며 둘 이상의 개발 컨테이너 파일을 사용할 수 있는 경우 목록에서 하나를 선택하라는 메시지가 표시됩니다. 개발 컨테이너 구성 파일에 대한 자세한 내용은 [AUTOTITLE](/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers)을(를) 참조하세요.\n\n `machine-type`을(를) 사용 가능한 머신 유형의 유효한 식별자로 바꿉니다. 식별자는 `basicLinux32gb` 및 `standardLinux32gb`와 같은 문자열입니다. 사용 가능한 머신 유형은 리포지토리, 개인 계정, 위치에 따라 다릅니다. 잘못되었거나 사용할 수 없는 머신 유형을 입력하면 오류 메시지에 사용 가능한 유형이 표시됩니다. 이 플래그를 생략했으며 둘 이상의 머신 유형을 사용할 수 있는 경우 목록에서 하나를 선택하라는 메시지가 표시됩니다.\n```\n\n이 명령의 옵션에 대한 자세한 내용은 [ GitHub CLI 설명서](https://cli.github.com/manual/gh_codespace_create)를 참조하세요.\n\n
\n\n## 추가 참고 자료\n\n* [기존 Codespace 열기](/ko/codespaces/developing-in-a-codespace/opening-an-existing-codespace)\n* [codespaces의 빠른 생성 및 재개 지원](/ko/codespaces/setting-up-your-project-for-codespaces/setting-up-your-repository/facilitating-quick-creation-and-resumption-of-codespaces)\n* [Codespaces 조직을 위한 REST API 엔드포인트](/ko/rest/codespaces/organizations)"}