OpenAI Codex · 小白一条龙教程

把 fululai API 接入 Codex CLI

Codex CLI 是 OpenAI 官方的本地 AI 编程工具：你在项目文件夹里输入 codex，它就能理解代码、解释项目、修 Bug、执行代码任务。本页带你从安装到用 fululai 跑通第一个任务。

直接开始 官方 GitHub 官方文档

Codex 是什么？ AI 编程助手

它运行在你电脑本地，可以读取当前项目，帮你解释代码、写功能、修 Bug、跑命令。

fululai 的作用 模型来源

fululai 提供 API Key、模型和余额。通过 CC Switch 或配置文件，让 Codex 走 fululai。

难度提醒

Codex 主要用终端启动。新手不用写代码，只需要复制命令、粘贴、回车。

使用工具前的准备事项

最简单：CC Switch 一键导入 fululai，然后启动 Codex

Codex 官方默认推荐 ChatGPT 登录，也支持 API Key。小白如果手动配置，容易卡在 Key、Base URL、模型名和配置文件。推荐先用 CC Switch 导入 fululai，再让 Codex 使用这套配置。

准备 A：安装 CC Switch

它像“AI 编程工具配置管家”，统一管理 fululai API。

CC Switch 教程

准备 B：创建 API Key

进入 fululai 控制台 → API 密钥，创建并复制 Key。

打开 API Key 页面

准备 C：导入到 CCS

点击 API Key 行里的「导入到 CCS」，再在 CC Switch 里激活 fululai。

之后重启终端
为什么推荐这样？
因为 Codex 的配置可能涉及 ~/.codex/config.toml、API Key 登录、模型供应商等概念。CC Switch 可以把这些复杂配置包装成“选择 fululai 并启用”。

启动 Codex：按这 4 步走

开始前：先完成上面的准备事项：安装 CC Switch → 创建 API Key → 导入到 CCS。完成后，再按下面步骤启动 Codex。
  1. 打开终端。
  2. 复制 Codex 官方安装命令，粘贴到终端，按回车。
  3. 进入你想让 AI 帮忙的项目文件夹。
  4. 运行启动命令，复制本页第一个任务模板测试。

第一步：终端是什么？

终端就是电脑里的“命令输入框”。本页命令不是让你写代码，只是把官方安装器或启动指令复制进去。

macOS

按 Command + 空格，输入「终端」或 Terminal，回车打开。

Windows

普通方式：按 Windows 键，搜索「PowerShell」或「终端 / Windows Terminal」，回车打开。
Codex 更推荐：官方文档写的是 Windows 11 通过 WSL2 使用；装过 WSL2 的用户，打开「Ubuntu」应用再复制命令。不会区分的话，先按普通方式尝试；不行再切换 WSL2。

第二步：安装 Codex CLI

官方 Quickstart 推荐两种全局安装方式：npm 或 Homebrew。安装完成后输入 codex 启动。

方式 A：npm 安装

npm install -g @openai/codex
如果提示 npm 不存在：说明你还没装 Node.js。先去下载中心或 Node.js 官网安装 Node，再重新打开终端。

方式 B：Homebrew 安装（macOS 常用）

brew install --cask codex

方式 C：GitHub Release 下载（备用）

如果你会分辨系统架构，可以从官方 Release 下载对应文件；小白优先用 npm/Homebrew。

系统通常下载说明
macOS Apple Siliconcodex-aarch64-apple-darwin.tar.gzM1/M2/M3/M4 Mac
macOS Intelcodex-x86_64-apple-darwin.tar.gz较老的 Intel Mac
Linux x86_64codex-x86_64-unknown-linux-musl.tar.gz常见 Linux 服务器/电脑
Linux arm64codex-aarch64-unknown-linux-musl.tar.gzARM Linux
打开 Codex 最新 Release
不要下载 Source code.zip
Source code 是源码，不是给小白直接安装的软件。Release 里文件很多，小白优先用 npm 或 Homebrew。

第三步：接入 fululai API

Codex 接入 fululai 本质上就是让它知道：API Key、服务地址、模型名。

API Key

你的账号通行证，长得像 sk-...。

去复制 Key

Base URL

https://api.fululai.cn/v1

推荐模型

gpt-5.5
gpt-5.5-codex

方式 A：推荐用 CC Switch

  1. 在 fululai API Key 页面点击「导入到 CCS」。
  2. 打开 CC Switch，确认 fululai 供应商已导入。
  3. 选择/激活 fululai。
  4. 关闭当前终端，重新打开，再输入 codex。

方式 B：Codex 官方 API Key 登录

官方说明：Codex 默认推荐用 ChatGPT 登录，也支持 API Key。若走 API Key，需要额外配置。新手优先用 CC Switch。

codex

启动后如果看到登录选择，优先确认 CC Switch 已经激活 fululai；如果选择 API Key，就填 fululai 的 Key，并确认服务地址/模型使用 fululai 配置。

方式 C：高级用户配置文件思路

Codex Rust CLI 使用 ~/.codex/config.toml。如果你会编辑配置文件，可以按 fululai 提供的 Codex/OpenAI 兼容配置填写模型供应商；不会就不要手动改，避免写错。

# 高级示意，不建议小白直接照抄 # ~/.codex/config.toml # model = "gpt-5.5" # model_provider = "fululai" # [model_providers.fululai] # base_url = "https://api.fululai.cn/v1" # env_key = "OPENAI_API_KEY"
安全提醒：API Key 不要发群里、不要截图外泄。页面里的示例不是你的真实 Key。

第四步：打开项目文件夹并启动 Codex

Codex 最适合在“项目文件夹”里运行。比如你有一个网站项目，就先进入那个文件夹。

项目文件夹是什么？
就是放代码、网页、配置文件的文件夹。Codex 会读取这个文件夹里的内容，帮你理解和修改。

如果你已经在项目文件夹里

codex

如果你还不知道怎么进入文件夹

可以先把项目文件夹拖进终端窗口，终端会自动出现路径。也可以先把项目放到桌面，按示例路径尝试。

cd 你的项目文件夹路径 codex

第五步：复制第一个任务模板测试

第一次不要让它直接大改代码，先让它只分析：

请先不要修改任何文件。请用小白能听懂的话检查当前项目结构，告诉我：1）这个项目可能是做什么的；2）主要文件夹分别是什么；3）如果我要做一个小改动，应该先从哪里开始。
通过标准：如果它能说清楚项目结构，说明安装、启动和模型连接基本正常。之后再让它修 Bug、改页面、写功能。

常见问题：看到这些不要慌

问题/报错是什么意思怎么解决
codex: command not foundCodex 没装好，或终端没刷新。关闭终端重新打开；仍不行就重新运行 npm/Homebrew 安装命令。
npm: command not found没有安装 Node.js。先安装 Node.js，再重新打开终端。
401 / UnauthorizedAPI Key 不对、没填或复制多了空格。回 fululai 控制台重新复制 Key，再导入/配置。
余额不足fululai 账号没有可用余额。去充值页小额充值后再试。
model not found模型名不匹配。先用 gpt-5.5 或 CC Switch 推荐模型测试。
一直让登录 ChatGPTCodex 还在走官方 ChatGPT 登录，没有读取 fululai 配置。重启终端，检查 CC Switch 是否激活；必要时重新导入 CCS 并重启终端。
Windows 不知道怎么装官方要求 Windows 11 via WSL2。先装 WSL2，或联系查看教程；不要直接乱下 Release 文件。
它要修改文件，我怕出错Codex 可以改文件，所以第一次要限制它。先用“不要修改任何文件，只分析”的任务模板。

记住 Codex 的上手路径

先装 CC Switch → 导入 fululai → 安装 Codex → 进入项目文件夹 → 输入 codex → 先让它只分析。

返回新手中心 打开下载中心