About GitHub Codespaces pricing
注記: GitHub では、前もって利用ベースのコスト値に対して一時的に承認が保留となることがあります。これは、アカウントの支払方法に保留中の請求として表示されます。
GitHub Codespaces は、組織、企業、または個人アカウントのいずれかによって支払われます。 個人アカウントの Free および Pro プランには、毎月一定の使用量までの GitHub Codespaces の無料使用が含まれます。
Organizations can choose whether codespaces created from their repositories will be user-owned or organization-owned. See 組織内の codespace を誰が所有し、支払うかの選択. An organization pays for a codespace if all the following things are true.
- The organization has chosen for codespaces to be organization-owned.
- 組織が GitHub Codespaces の 0 以外の使用制限を設定しています。
- codespace は、組織のリポジトリのいずれか、または組織のリポジトリのいずれかのフォークから作成されます。 これには、パブリックとプライベートの両方のリポジトリが含まれます。
- codespace を作成するユーザーは、組織のメンバーまたはコラボレーターであり、組織はこのユーザーに対して GitHub Codespaces を有効にしています。 組織がすべてのユーザーに対して Codespaces を有効にすることを選択している場合は、すべてのメンバーとコラボレーターが含まれます。 ユーザーに対して Codespaces が有効になっていない場合でも、組織のパブリック リポジトリから codespace を作成できますが、ユーザーはこれらの codespace に対する支払いを行います。
For more information about enabling GitHub Codespaces for users, see 組織での GitHub Codespaces の有効化または無効化.
Otherwise use of GitHub Codespaces applies to the personal account of the person who created the codespace, and either consumes some of the monthly included usage for their personal account, or their account is billed according to their usage in excess of their included quotas.
The Free, Team, and Enterprise plans for organization and enterprise accounts do not include any free use of GitHub Codespaces.
Monthly included storage and core hours for personal accounts
The following storage and core hours of usage are included, free of charge, for personal accounts:
| Account plan | Storage per month | Core hours per month |
|---|---|---|
| GitHub Free for personal accounts | 15 GB-month | 120 |
| GitHub Pro | 20 GB-month | 180 |
Understanding GB-months and core hours
The included usage for personal accounts is measured in GB-months and core hours.
GB-month
The GB-month unit of storage is a time-based measurement, 1 GB-month being 1 GB of storage usage for one whole month. The disk space used by all of your codespaces and prebuilds is assessed once an hour and your current GB-month usage is recalculated. Therefore, while you have codespaces and prebuilds, your GB-month usage will increase throughout the month. For example, if the storage totals 15 GB, and remains unchanged throughout your monthly billing cycle, then you will have used 7.5 GB halfway through the month, and 15 GB at the end of the month. See About billing for storage usage later in this article.
Core hour
A "core hour" is a measure used for included compute usage. To calculate core hours, multiply the number of hours for which a codespace has been active by the multiplier in the pricing table later in this article. For the basic machine types, the multiplier is the number of processor cores in the machine that hosts the codespace. For example:
- A 2-core machine used for 1 hour equals 2 core hours
- An 8-core machine used for 1 hour equals 8 core hours
- An 8-core machine used for 2 hours equals 16 core hours
Using your included usage
You will be notified by email when you have used 75%, 90%, and 100% of your included quotas. Notifications are also displayed in a "toast" message within VS Code and the VS Code web client. You can turn off email notifications if required. See Using budgets to control spending on metered products.
When a personal account has used all of either the included storage or compute usage (whichever is reached first), and has no payment method defined, use of GitHub Codespaces will be blocked. You must set up a payment method to continue using GitHub Codespaces during the current billing month. At the beginning of the next monthly billing cycle the included usage is reset. Storage will not be billed while use of GitHub Codespaces is blocked.
You can view details of your usage for the current month at any time. See Viewing your usage of metered products.
If you are blocked from resuming a codespace and you want to continue to work on changes you have made in your codespace, you can do any of the following:
- Add a payment method and set a budget greater than $0 USD.
- Export the changes from the codespace to a branch. See ブランチへの変更のエクスポート.
- Wait for your monthly included usage to reset at the start of the next monthly billing cycle.
If you have used all of either your included storage usage or your included compute usage, and you have set up a payment method, any further use of codespaces owned by your personal account will incur charges for whichever type of usage has no remaining included quota. You will not be charged for the other type of usage until you have also used all of its included quota. See Using budgets to control spending on metered products.
許可された使用量をさらに活用するためのヒントについては、「含まれている使用量の最大限の活用」を参照してください。
Pricing for paid usage
A GitHub Codespaces instance (a "codespace") incurs charges for compute time, while it is active, and for the amount of disk space the codespace occupies, while it exists. The compute cost is proportional to the number of processor cores in the machine type you choose for your codespace, as shown in the following table. For example, the compute cost of using a codespace for an hour on a 16-core machine is eight times greater than a 2-core machine.
| Component | Machine type | Unit of measure | Included usage multiplier | Price |
|---|---|---|---|---|
| Codespaces compute | 2 core | 1 hour | 2 | $0.18 |
| Codespaces compute | 4 core | 1 hour | 4 | $0.36 |
| Codespaces compute | 8 core | 1 hour | 8 | $0.72 |
| Codespaces compute | 16 core | 1 hour | 16 | $1.44 |
| Codespaces compute | 32 core | 1 hour | 32 | $2.88 |
| Codespaces storage | Storage | 1 GB-month | Not applicable | $0.07 |
For more information about the GB-month unit of measure, see About billing for storage usage.
If you enable prebuilding of codespaces this will incur additional charges. See About billing for Codespaces prebuilds.
About your bill for GitHub Codespaces
GitHub Codespaces is billed in US dollars (USD) according to the amount of compute time and storage space your codespaces use. GitHub Codespaces のコストは、お使いのアカウントが年単位の請求になっているとしても、常に毎月請求されます。
Billing for GitHub Codespaces shares your account's existing payment method, and receipt. See 支払いサイクルについて.
If you are an organization owner, you can connect an Azure Subscription ID to your organization account to enable and pay for GitHub Codespaces usage. See Azure サブスクリプションを接続する.
About billing for compute usage
The compute usage of a codespace is the length of time for which that codespace is active multiplied by the multiplier in the pricing table for the machine type of the codespace. Total compute usage is calculated by summing the time used by all codespaces billable to a particular account. These totals are reported to the billing service every hour, and are billed monthly.
As an example, if a codespace is active for 1 hour and 15 minutes, then the compute cost will be the hourly cost of the codespace, as determined by its machine type, multiplied by 1.25.
You can control compute usage by stopping your codespaces. For information, see codespace の停止と開始. Codespaces are stopped automatically after a configurable period of inactivity. The timeout period can be configured by the user, or at the organization level. See GitHub Codespaces のタイムアウト期間を設定する and アイドル タイムアウトの期間を制限する.
About billing for storage usage
For GitHub Codespaces billing purposes, storage comprises the disk space used by all of the codespaces and prebuilds in your account. This includes any files you use in a codespace, such as cloned repositories, configuration files, data loaded to the codespace (for example as input or output of the software running in the repository), and extensions, among others. Storage is billed for all of your existing codespaces, regardless of whether they are active or inactive with the exception of blocked usage due to exhausted included usage quota or reaching your budget limit. The storage billing for a codespace ends when it is deleted. However, deleting a codespace does not reduce your used storage amount for the current billing month as this is a cumulative figure.
Storage billing for containers based on the default image
When you use the default dev container configuration, your container is built from the default Linux image for codespaces. See 開発コンテナーの概要.
Containers based on the default image are not counted as used storage, even if you add features in your dev container configuration. See devcontainer.json ファイルへの機能の追加.
If you use the default image, the storage usage for your codespace will be based on the files in your repository, and any files you subsequently add to the codespace. If you use an alternative base image, then the resulting container and all of the files in the codespace will be counted as used storage.
codespace が既定の開発コンテナー イメージから構築されたかどうかをチェックする方法については、「含まれている使用量の最大限の活用」を参照してください。
Reporting storage usage
Codespace storage is reported in GB-months. Your billing month runs from a fixed day in one month until the same day in the next month. In most cases the day of the month is determined by the day you started on your current GitHub plan. Your GB-month storage is calculated as follows. Once every hour, the storage used by all of your currently active and stopped codespaces is assessed. This figure is then divided by the number of hours in the current billing month: total storage size / hours this month. The result is added to the running total for codespace storage for the month.
For example, if you have one codespace that uses 100 GB of storage and has existed for one hour you will have used 100 / (24 * 30) = 0.1388 GB-months of storage in a 30-day month. If your use of GitHub Codespaces during a 30-day month consists of two 100 GB codespaces that both existed for three full days then there will be 24 * 3 hourly reports for the storage of these codespaces, giving a total of (24 * 3) * 200 / (24 * 30) = 20 GB-months.
For each hourly report, the storage usage for the previous hour is calculated in seconds. As a result, you won't be charged for a full hour of storage if a codespace did not exist for the full 60 minutes. At the end of the month, GitHub rounds your storage to the nearest MB.
Organization owners can:
- List the currently active and stopped codespaces for your organization. See 組織内の codespace を一覧表示する. In addition to the cost of these codespaces, the cost of GitHub Codespaces for the current month may include costs for codespaces that existed earlier in the current month but have since been deleted.
- See the total GitHub Codespaces compute and storage usage for your organization for the current month to date. See Viewing your usage of metered products.
- Configure your organization settings to manage the cost of GitHub Codespaces. See 組織での GitHub Codespaces のコストの管理.
To estimate the costs for usage-based billing, you can use the GitHub pricing calculator.
About billing for Codespaces prebuilds
プレビルドでは、リポジトリ、ブランチ、devcontainer.json 構成ファイルの特定の組み合わせに対して、codespace の主要コンポーネントが組み立てられます。 これにより、新しい codespace をすばやく作成できます。 特に複雑なリポジトリや大規模なリポジトリの場合は、プレビルドを使うことで新しい codespace をより迅速に作成できます。 See GitHub Codespaces のプレビルドについて.
GitHub Actions costs for prebuilds
Prebuilds are created and updated by running a GitHub Actions workflow on a GitHub-hosted runner. You can configure how you want prebuild updates to be automatically triggered. For information, see プレビルドの構成.
As with other workflows, while prebuild workflows are running they consume GitHub Actions minutes included with your account, if you have any, or they incur charges for GitHub Actions minutes. For more information about pricing for GitHub Actions minutes, see About billing for GitHub Actions. There is no associated Codespaces compute cost for creating or updating prebuilds.
You can track usage of prebuild workflows and storage by downloading a usage report for your account. See Viewing your usage of metered products.
Storage costs for prebuilds
In addition to GitHub Actions minutes, you will also be billed for the storage of prebuilds associated with each prebuild configuration, for a given repository and region. Storage of prebuilds is billed at the same rate as storage of codespaces.
The storage cost for a prebuild in a single region will be similar to the storage cost that will be incurred for storing a single codespace created from that prebuild. The storage cost for the generated codespace may be more than the cost for the prebuild if, for example, the updateContentCommand and postCreateCommand commands are used during codespace creation to download more files to the dev container.
The total storage costs associated with a prebuild configuration will depend on the following factors.
- The price of storage per GB (see the table earlier in this article)
- The size of the generated prebuild in GB
- The number of regions in which the prebuild is available (because a copy of the prebuild is stored in each region)
- The number of older versions of the prebuild that are retained
The storage cost for the prebuilds generated by a prebuild configuration is therefore calculated as: price per GB * size (GB) * regions * versions.
You can check how many GB-months of storage has been used by prebuilds by reviewing the current billing data for your personal or organization account. See Viewing your usage of metered products.
フォークされたリポジトリの事前ビルドを作成した場合、それらの事前ビルドのストレージ コストは、使用可能な間は、毎月含まれるストレージから減算されます。 含まれているすべてのストレージを使用し、請求を設定している場合は、パーソナル アカウントに請求されます。 これは、フォーク用に作成した Codespaces が、親リポジトリを所有する組織によって支払われる場合でも当てはまります。 See How billing is handled for forked repositories.
Controlling the cost of prebuilds
To reduce consumption of Actions minutes, you can set a prebuild to be updated only when you make a change to your dev container configuration files, or only on a custom schedule. You can also manage your storage usage by adjusting the number of previous versions of each prebuild that are retained. See プレビルドの構成.
To limit the storage costs associated with prebuilds, you can choose to create prebuilds only in selected regions, and you can specify the number of older versions of prebuilds that will be retained. See プレビルドの構成.
If you delete a prebuild configuration, all the associated prebuilds are deleted, reducing your storage consumption from that point onward. See 事前ビルドの管理.
Prebuilds can be updated multiple times during a billing month. Each update may change the size of the prebuild, which affects your storage charges. For details of how storage is calculated during a billing month, see About billing for storage usage earlier in this article.
ヒント
As with deleting codespaces, deleting prebuilds does not reduce your used storage amount for the current billing month as this is a cumulative figure.
Cost of codespaces created from prebuilds
Use of codespaces created using prebuilds is charged at the same rate as regular codespaces.
Managing your budget for GitHub Codespaces
If your account does not have a valid payment method on file, usage is blocked once you use up your quota.
By default, if you have a valid payment method on file, spending is limited to $0 USD until you set a budget. You can set and manage a budget to limit spending for a product or SKU. See Using budgets to control spending on metered products.
個人、組織、または企業のアカウントが使用制限に達した場合、そのアカウントに課金される codespace は作成も再開もできなくなります。 ただし、進行中の作業内容の変更を新しいブランチにエクスポートすることは引き続き可能です。 詳しくは、「ブランチへの変更のエクスポート」をご覧ください。
Viewing projected usage for an organization
Organization owners and billing managers can view an estimated total usage cost for GitHub Codespaces for the organization, for the current monthly billing cycle. See Viewing your usage of metered products.
The projected usage shown on the billing page for an organization is calculated based on the total cost for Codespaces compute and storage usage incurred during the previous seven days, prior to the current day. This is projected forward for the remainder of the billing month to give you an idea of how much the total cost might be for the current billing cycle.
The calculation used for this estimate is:
<cost for the previous 7 full days>/7 * <days remaining in the billing month, including the current day> + <cost already accrued in this billing month>
The projected usage does not take into account information such as whether GitHub Codespaces is still enabled, the number or size of codespaces that currently exist, or your prebuild settings. For this reason, if all of the organization's codespaces and prebuilds were deleted today, the projected usage for the billing month would still show a figure higher than the accrued usage. However, after seven days have elapsed, with no further Codespaces usage, the projected usage will be the same as the currently accrued usage.
Limiting the machine types for organization-owned codespaces
By default the machine type with the lowest valid resources is used when a codespace is created. However, users may be able to choose a machine type with more resources. They can do this either when they create a codespace, or they can change the machine type of an existing codespace. See リポジトリの codespace を作成する and codespace のマシンの種類を変更する.
If a machine type that has more resources is chosen, this will affect the per-hour charge for that codespace, as shown in the table earlier in this article.
Organization owners can create a policy to limit the choice of machine types available to users for codespaces that are billed to an organization or enterprise account. See コンピューターの種類へのアクセスを制限する.
Limiting the number of organization-owned codespaces
Organization owners can limit the number of codespaces that people can create, where the organization will be billed for the codespace. This can help to reduce storage charges for the organization. See ユーザーが作成できる組織に請求される codespace の数の制限.
How billing is handled for forked repositories
Usage of codespaces created from a forked repository will be billed to your personal account unless the upstream (or parent) repository is in an organization that has allowed you - as a member, or outside collaborator, of the organization - to use codespaces at the organization's expense.
For example, consider a member, or outside collaborator, of an organization that has allowed billing for codespaces for that user. If the user has permission to fork an organization-owned private repository, they can subsequently create and use a codespace for the new repository at the organization's expense. This is because the organization is the owner of the parent repository. Note that the organization owner can remove the user's access to the private repository, the forked repository, and therefore also the codespace. The organization owner can also delete the parent repository which will also delete the forked repository. See リポジトリのフォークポリシーを管理する.
フォークされたリポジトリの事前ビルドを作成した場合、それらの事前ビルドのストレージ コストは、使用可能な間は、毎月含まれるストレージから減算されます。 含まれているすべてのストレージを使用し、請求を設定している場合は、パーソナル アカウントに請求されます。 これは、フォーク用に作成した Codespaces が、親リポジトリを所有する組織によって支払われる場合でも当てはまります。
How billing is handled when a repository is transferred to another organization
Usage is calculated every hour. An organization pays for usage of codespaces created from any repository owned by the organization, where the organization settings permit the organization to be billed. See 組織内の codespace を誰が所有し、支払うかの選択. When a repository is transferred out of your organization, ownership and billing responsibility for any codespaces associated with that repository will change accordingly.
How billing is handled for GitHub Codespaces templates
You can get started on a new project by creating a codespace from a template. Codespaces created from templates aren't initially associated with a repository, but you can publish the codespace to a repository owned by your personal account. See テンプレートから codespace を作成する.
Any organization can maintain a template repository for use with GitHub Codespaces. As with any other repository in an organization, a codespace created from a template repository is billed to the organization if the organization allows the user creating the codespace to do so at the organization's expense. Otherwise, the codespace is billed to the user who creates the codespace.
If a user publishes a codespace created from a template, the codespace is published to a new repository owned by the user's personal account. If the codespace is currently billed to an organization, ownership and billing of the codespace transfer to the user who created the codespace.
What happens when users are removed
If a user is removed from an organization or repository, their codespaces are automatically deleted.