当前位置：首页>下载安装>Codex保姆级安装指南:下载、登录、开用一次讲透

Codex保姆级安装指南:下载、登录、开用一次讲透

2026-06-14 11:47:58

大家好，我是予贝

最近很多小白都被codex的安装卡住了，这篇文章主要讲安装。你如果卡在不知道从哪里下载，不知道 Windows 和 macOS 分别怎么装，不知道 App、插件、CLI 这三种方式该怎么下手，就直接看这篇。本文不讲太多原理，重点就是把 Codex 装上。

纯小白优先装 App。平时就在 VS Code、Cursor 这类编辑器里写代码的人，优先装插件。会终端的人，再去装 CLI。你不用一上来三个全装，先装一个最适合自己的就行。

三种方式都共享同一个本地信息和记录，可以随意切换使用

一、App 安装

如果你是第一次装 Codex，建议优先从 App 开始。它最直观，安装步骤也最简单。

一）软件安装

打开 Codex 官网：https://openai.com/zh-Hans-CN/codex/，点击下载 Windows 版

下载完成后双击运行安装程序，默认会调用微软应用商店进行下载

安装完成即可，打开 APP

二）账号登录

账号登录分两种方式，一种是使用 GPT 账号登录，官方正版，需要魔法，另一种是用 API-key 登录，可以用国内中转，会有部分功能不能使用，比如插件

如果你是小白，优先推荐第 2 种登录方式，先用起来。

1、GPT 账号登录

该方式需要全程确保网络正常

登录成功后，会提示选择一些配置，按需选择，也可以跳过

codex 的主界面如下所示，选择个性化和设置沙盒，设置成功后即可正常使用。

2、API Key 登录

我最近使用的是国内中转登录，官网：https://freemodel.dev/invite/FRE-de301aed，新用户有免费额度赠送，还会不定期赠送额度，非常适合小白体验

注册登录成功后打开 API 密钥界面，点击右上角创建密钥

创建好之后可以先复制保存到其他地方

创建 auth.json

在 C:\Users\<your-username>\.codex 路径下，删除已有的 auth.json（若有），新建一个：

YOUR_API_KEY 需要替换为上一步申请的密钥

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

创建 config.toml

在 C:\Users\<your-username>\.codex 路径下，删除已有的 config.toml（若有），新建一个：

model_provider = "freemodel"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.freemodel]
name = "freemodel"
base_url = "https://api.freemodel.dev"
wire_api = "responses"