Install ChatGPT Desktop and Open Codex

Codex Beginner Path · Step 1 of 5

• Path overview: AI Learning Paths
• Goal: finish official installation, account sign-in, and an empty-folder verification.
• Estimated time: 10 minutes.

💡 What you will complete: Download and install the ChatGPT desktop app, open Codex, and confirm that the basic setup works. Workspace selection and real tasks come in Step 2; multi-API configuration is optional.

About the app name

OpenAI has moved the former standalone Codex desktop app into the updated ChatGPT desktop app. The current path is: install ChatGPT, then open Codex inside the app. The Windows file is normally named ChatGPT Installer.exe, and the Mac package is ChatGPT.dmg; seeing the ChatGPT name is expected.

1. Quick Route

In one sentence: get the official setup working first, then consider CC Switch.

If something fails, do not change everything at once. Note the numbered step where you stopped, then find the matching item in Section 9.

2. Before Installing

Check these four items first:

• Supported operating system: Windows 10 build 17763 or later, Windows 11, or macOS 14+ on Apple silicon or an Intel processor with AVX2 support.
• Your own ChatGPT account: do not buy a shared account or ask a stranger to sign in for you.
• Your current country or region is supported by OpenAI.
• If you plan to pay, confirm the plan, purchase channel, billing account, and tax before installing instead of buying in a hurry.
• A new empty folder, such as codex-demo, that Codex can access for the first test.

As of July 31, 2026, OpenAI's help center lists Codex access for Free, Go, Plus, Pro, Business, Enterprise, and Edu. Usage limits and feature availability vary by plan and may change.

If you are comparing Pro tiers, Google Play, a China-issued credit card, or taxes, first read Subscribe to Codex with Google Play. If you are unsure, complete installation and the empty-folder check first instead of buying the highest plan just to begin a first task.

Regional availability

Mainland China is not currently listed on OpenAI's supported countries and territories page. Registration or sign-in may fail in an unsupported location, and accessing the service outside supported regions may put an account at risk. This guide covers official installation and compliant configuration only. It does not provide instructions for bypassing regional restrictions. CC Switch does not change OpenAI's supported-country list.

3. Download the Official Installer

These links were checked on July 31, 2026. Installers can change. If a direct link stops working, use the official OpenAI download page for the latest version.

Computer	Official installer	Use it when
Windows	👉 Download the ChatGPT Windows installer	Windows 10 build 17763+ or Windows 11
macOS (Apple silicon)	👉 Download ChatGPT.dmg	M1, M2, M3, M4, or later Apple silicon on macOS 14+
macOS (Intel)	👉 Download ChatGPT for Intel	Intel processor with AVX2 support on macOS 14+
Direct link fails	👉 Open the official OpenAI download page	Use the latest official installer

Use official installers only

Do not download a cracked, modified, “portable,” or file-sharing-site build. Codex can read files in folders you deliberately open. An untrusted package could steal your ChatGPT session, API keys, or local files.

After downloading, read only the section for your computer: Section 4 for Windows or Section 5 for Mac.

4. Windows Setup

4.1 Open the Installer

The Windows direct link usually downloads a small official bootstrap installer. It is not the entire application; it continues the download and installation through Microsoft's channel.

Double-click the .exe file and follow the installer.

4.2 Finish Installation

When installation finishes:

1. Open the Windows Start menu.
2. Search for ChatGPT.
3. Open the application.
4. If Windows shows a security warning, first confirm that the file came from the OpenAI/Microsoft links in this guide. Stop if the source is unclear.

4.3 If the App Is Missing

Check in this order:

1. Open Settings > Apps > Installed apps and search for ChatGPT.
2. Run the official bootstrap installer again.
3. Update Windows and Microsoft Store, then retry.
4. If it still fails, use the official OpenAI download page instead of a third-party download site.

After installation, continue with Section 6.

5. Mac Setup

5.1 Open the DMG

Double-click the .dmg file you downloaded.

5.2 Move It to Applications

Drag the Codex or ChatGPT icon into Applications.

5.3 First Launch

1. Open Finder > Applications.
2. Double-click Codex or ChatGPT.
3. If macOS asks for folder, notification, or other permissions, grant only what you actually need.

The redesigned ChatGPT desktop app requires macOS 14+ and supports both Apple silicon and Intel processors with AVX2. If you are unsure which installer to use, open Apple menu > About This Mac: M1, M2, M3, or M4 means Apple silicon; an Intel label means use the Intel installer in Section 3. Do not look for an unofficial “compatible” build if the OS or processor is unsupported.

5.4 If macOS Blocks It

If macOS says the app cannot be opened or verified:

1. Delete the current installer.
2. Download it again from the official link in this guide.
3. In Finder > Applications, right-click Codex or ChatGPT and choose Open.
4. Only after confirming the official source, use System Settings > Privacy & Security to allow it.

Do not approve an unknown DMG merely to save time. After installation, continue with Section 6.

6. Sign In and Open Codex

6.1 Use Official ChatGPT Sign-in

Open Codex or ChatGPT and choose Sign in with ChatGPT. Your browser will open the authorization page. Prefer your own official account. Do not buy shared accounts or give your credentials to a stranger.

1. Sign in to your ChatGPT account in the browser.
2. Approve the request to return to the desktop app.
3. If the browser does not switch back automatically, return to the desktop app manually.

If you see “country or region not supported,” stop re-entering your password

Country, region, or territory not supported is normally an availability check, not a password error. Save the complete message, then go directly to Section 9.8. Do not keep retrying, rapidly switch networks, or buy an account advertised as guaranteed to sign in.

This screenshot is only a visual reference

The screenshot was captured on August 3, 2026 in an already-installed Windows 11 environment by manually opening the generic ChatGPT sign-in URL in a browser. No email address, password, or verification code was entered. It helps you recognize the OpenAI sign-in page, but it does not prove that Codex initiated the page, that authentication completed, or that the browser returned successfully to Codex. The full desktop-app-to-browser authorization round trip still requires a separate test with the account owner present.

If an error appears, do not repeatedly change settings in the main sign-in flow. Save the complete message, then use Section 9 to find the matching symptom.

6.2 Open Codex

Open Codex inside the ChatGPT desktop app. Depending on the version, the label may read Codex, Open Codex, or a similar localized name.

Continue only after the Codex interface appears.

7. Finish Your First Task

7.1 Choose a Dedicated Folder

Choose the empty folder created in Section 2, for example:

• Windows: D:\codex-demo
• Mac: ~/Documents/codex-demo

Do not start with:

• the entire Desktop;
• the entire Documents folder;
• the root of C:\;
• your Mac home folder;
• a large folder containing accounts, contracts, or customer data.

Codex is useful because it can work with project files, but broader permission also increases the scope of accidental reads or edits. An empty folder is the safest first step.

7.2 Run a Verifiable Test

Paste this request into Codex:

Do not modify any other location. Inspect the current folder. If it is empty, create README.md containing “Codex installation succeeded,” then tell me exactly what you changed.

If README.md appears, the installation, sign-in, folder permission, and basic execution path all work.

🚀 Next: Learn Workspace Boundaries

Installation is only the first step. Continue with Step 2: the Codex workspace guide → before opening real files or a large folder.

💡 CC Switch note: If you use the official ChatGPT sign-in, you can stop here. You do not need another tool. If you need to switch among multiple API services, finish this official test first and then follow the CC Switch guide instead of manually editing config.toml.

8. Do You Need CC Switch?

CC Switch is a third-party configuration manager, not an OpenAI product or a required Codex component. If you only sign in with ChatGPT, skip it.

If you regularly switch among multiple API URLs, keys, or models, use the standalone guide:

👉 Read “CC Switch Setup for Codex”

The guide covers Windows and macOS downloads, enabling Codex, keeping official sign-in, adding providers, testing connections, security, and troubleshooting.

9. Troubleshooting

9.1 Is the Small Windows Installer Normal?

Yes. The direct link is a bootstrap installer that downloads the full app through Microsoft's channel. Do not search for an unofficial “full package.”

9.2 What If Microsoft Store Cannot Find It?

Use the official Windows direct link or the OpenAI download page. Update Windows and Microsoft Store first. Do not use a cracked package or change regions to bypass official availability requirements.

9.3 Can I Install It on an Intel Mac?

Yes, if the Mac runs macOS 14+ and its Intel processor supports AVX2. Use the official Intel DMG in Section 3. If processor support is unclear, check Apple menu > About This Mac and confirm the current requirement on OpenAI’s download page.

9.4 Can Free Users Use Codex?

Yes. As of July 31, 2026, OpenAI's help center lists Free, Go, Plus, Pro, Business, Enterprise, and Edu as plans with Codex access. Limits and feature availability vary by plan, so check the latest official details.

9.5 Do Plus Users Need API Credits?

Not for normal ChatGPT sign-in. API costs apply only when you explicitly choose an API workflow. For multiple configurations, see the standalone CC Switch guide.

9.6 What If the Browser Does Not Return to the App?

Try these steps in order:

1. Confirm that browser authorization is complete.
2. Return to the ChatGPT app manually.
3. Fully quit and reopen ChatGPT.
4. Confirm that the default browser did not block the redirect.
5. Verify that the account and current location meet OpenAI's availability rules.

9.7 Can I Use Xianyu, a Chinese Resale Marketplace, If I Do Not Have a Suitable Phone Number?

Do not rush to buy a number or an account. As of August 4, 2026, OpenAI's help center says that phone verification is no longer required to create or use a ChatGPT account. Try the email, Google, or Apple sign-in options first. Phone verification may still be required for specific API-related actions, such as creating a first OpenAI API key.

Xianyu, a Chinese resale marketplace, may have listings for general setup advice, but some sellers also offer temporary SMS numbers, shared accounts, or registration services. You may pay for general guidance, but do not buy a temporary number or shared account, and do not let a seller sign in for you. The risks include:

• the number may be shared, reclaimed, or unable to receive another verification code;
• account ownership and later recovery, appeals, or billing may become difficult;
• sharing a password, SMS code, or API key can expose the account and its data.

If an official page really asks for a phone number, first confirm that the site belongs to OpenAI and determine whether you are creating a ChatGPT account or enabling an API feature. When verification is genuinely required, use a number that you control long term and that meets OpenAI's current rules. Even when buying general help on Xianyu, never provide your password, verification code, sign-in QR code, or API key.

Reference: OpenAI phone verification requirements.

9.8 What Does a 403 Region Error Mean?

If you see Token exchange failed: 403 Forbidden: Country, region, or territory not supported, the password is usually not the problem. The login server has classified the current access location as unsupported.

Common unsupported exit locations

As of August 4, 2026, these commonly encountered exit locations are not listed on OpenAI’s official supported-country page and may therefore produce the 403 message shown above:

• Common Asian exits: mainland China, Hong Kong, and Macao;
• Europe and nearby: Russia and Belarus;
• Other common locations: Iran, Syria, North Korea, Cuba, and Venezuela;
• Special case: OpenAI lists Ukraine (with certain exceptions), so availability differs in some areas.

These are beginner-friendly examples, not a complete blocklist. The underlying rule is that a regional error may appear whenever the detected exit country or territory is absent from OpenAI’s latest supported list. The message proves only that the current access source was classified as unsupported; the screenshot alone does not prove that the exit IP is in Hong Kong.

Singapore and the United States are currently on the supported list, but “switch to the United States or Singapore” should not be presented as a universal fix:

• If you are physically located in the United States, Singapore, or another supported country, disable company routing, proxies, or forwarding that incorrectly exits through Hong Kong, Macao, or another unsupported location. Keep the browser, operating system, and desktop app on a normal network that matches your real location.
• If you are not physically located in a supported country, changing the exit to the United States or Singapore does not grant official regional support and may still put the account at risk of restriction or suspension.

OpenAI’s unsupported countries and territories guidance says that access from outside its supported-country list may result in an account being blocked or suspended. This guide does not provide instructions for using a US IP, global proxy mode, VPN, region changes, or relay services to bypass those restrictions.

Choose the branch that matches your real situation:

Case A: You are physically located in an unsupported country or territory

Reinstalling the app will not solve this. There is no officially supported “change one setting and continue” fix:

1. Stop repeated sign-in attempts, rapid network switching, and repeated code requests.
2. Do not buy shared accounts, assisted sign-in, temporary phone numbers, or “dedicated routes.” They create account-ownership, billing, and data-security risks.
3. Review OpenAI's supported countries and territories. If you need help with an existing subscription or account, contact support through the chat widget at the OpenAI Help Center.

As of August 4, 2026, mainland China is not on OpenAI's supported list. Installation success does not guarantee that the official service is available locally. Always follow the latest OpenAI list.

Case B: You are physically located in a supported country but appear to be misclassified

Try these steps in order, testing only once after each step:

1. Disable proxies, VPNs, accelerators, company routing, and security-software traffic forwarding so the browser and desktop app do not exit through different countries.
2. Use a stable network that matches your real location. Prefer a home connection or your own mobile hotspot instead of switching repeatedly between routes.
3. Clear cookies and site data for chatgpt.com, openai.com, and auth.openai.com, or retry in a private/incognito window.
4. Use the same authentication method used when the account was created. For example, keep using Google if the account was created with Google instead of switching to email and password.
5. Fully quit and reopen the ChatGPT desktop app, then repeat official authorization.
6. Check OpenAI Status. If the error remains, contact OpenAI Support with the complete error, date and time with time zone, actual country or territory, operating-system and app versions, and browser name. Never send your password or verification code.

Decision rule: if the error remains reproducible on a normal network that matches your physical location, stop guessing passwords or reinstalling. Treat it as a location-classification or account-support issue.

9.9 What Other Sign-in Problems Are Common?

Read the complete error message first. Do not reinstall the app for every generic “sign-in failed” message:

Symptom	First action
Browser authorization finishes but ChatGPT does not reopen	Follow Section 9.6; return to the app manually and check whether the default browser blocked the redirect.
The sign-in method appears wrong, or a password never works	Use the same method used at registration: Google, Apple, Microsoft, or email. An account created through a social sign-in may not have a separate working password.
The page spins, stays blank, or repeats a security check	Allow cookies and JavaScript; temporarily disable ad blockers, privacy extensions, and security filters; test once in a private window or another browser.
Suspicious-login or too-many-attempts warning	Stop repeated attempts, disable VPN/proxy services, clear cookies, and use a stable network. OpenAI recommends waiting up to about one hour before retrying.
Verification email or code never arrives	Check spam, use only the newest code, and confirm the email address. Never share the code.
The account is deactivated, deleted, or suspended	Check the notice sent to the account email, then contact OpenAI Support. Do not buy a shared replacement account.
Many users suddenly cannot sign in, or you repeatedly see Something went wrong	Check OpenAI Status before clearing cache or changing browsers.

Official troubleshooting: Why can't I log in to ChatGPT? and Troubleshooting ChatGPT error messages.

9.10 Which Folder Should I Choose?

Use a new empty codex-demo folder first. Avoid the system drive, entire Desktop/Documents folders, and locations containing sensitive data.

9.11 What If Codex Cannot Modify Files?

Check that ChatGPT/Codex has permission for the selected folder and that the file is not read-only. On macOS, inspect System Settings > Privacy & Security > Files and Folders. On Windows, check folder permissions and security-software blocks.

9.12 How Do I Uninstall It?

• Windows: open Settings > Apps > Installed apps and uninstall ChatGPT.
• Mac: move ChatGPT from Applications to Trash.

10. Safety Checklist

• ChatGPT came from an official OpenAI/Microsoft link.
• The first workspace is a dedicated empty folder.
• You did not select the whole desktop, a disk root, or a folder with private files.
• You did not share a ChatGPT password or API key with anyone.
• You understand that ChatGPT plans and API usage are billed separately.
• You understand that installation does not guarantee service availability in every region.

11. Final Check

You are ready when all four items pass:

• The ChatGPT desktop app opens.
• Your ChatGPT account is authorized.
• Codex opens inside ChatGPT.
• Codex can create README.md in the dedicated folder.

🎉 Step 1 is complete: official installation → official sign-in → empty-folder test. Continue with Step 2: the Codex workspace guide. Read the optional CC Switch guide only when you need multiple API configurations.

12. Need More Help? Join the Community

If you are stuck on installation, sign-in, folder permissions, or CC Switch configuration, scan the QR code to add us on WeChat.

Send “Codex” after adding the account so we can identify your request and invite you to the AI tools community. For account security, never send your ChatGPT password, API key, or other sensitive information.

13. Official Sources

• OpenAI desktop download
• Moving to the new ChatGPT desktop app
• Codex plans and usage
• ChatGPT supported countries
• Unsupported countries and territories guidance
• Why can't I log in to ChatGPT?
• Troubleshooting ChatGPT error messages
• OpenAI Status
• ChatGPT Windows requirements
• OpenAI phone verification requirements