面向新手的Codex配置教程

01

第一步：安装 Node.js

打开 macOS 的“终端”。
复制右侧整段脚本并执行，按提示输入电脑密码。
脚本会自动检查 Homebrew，缺失时先从清华镜像安装，再继续安装 Node.js。
等待终端输出 Node.js is ready。

安装 Homebrew 与 Node.js 均优先使用清华镜像。期间如果终端要求确认，请按提示输入 Return 或电脑密码。

export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_INSTALL_FROM_API=1
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_PIP_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"

if ! command -v brew >/dev/null 2>&1; then
  git clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git /tmp/brew-install
  /bin/bash /tmp/brew-install/install.sh
  eval "$(/opt/homebrew/bin/brew shellenv)"
fi

brew update
brew install node
node -v
npm -v
node -e "console.log('Node.js is ready')"

访问 npmmirror Node.js 镜像下载 LTS 版本的 Windows Installer。
运行安装程序，并保留“添加到 PATH”的默认设置。
安装结束后重新打开 PowerShell。
运行验证命令，确认 Node.js 可以执行脚本。

node -v
npm -v
node -e "console.log('Node.js is ready')"

打开终端。
先把系统软件源切换到国内镜像，例如清华 Ubuntu 镜像帮助或对应发行版镜像。
更新软件源并安装 Node.js 与 npm。
运行验证命令，确认 Node.js 可以执行脚本。
多项目开发时，再考虑用 nvm 管理多个版本。

sudo apt update
sudo apt install nodejs npm
node -v
npm -v
node -e "console.log('Node.js is ready')"

02

第二步：安装 Codex App

访问 codex-app-mirror releases 下载最新版安装包，并按当前系统完成安装。

打开 Codex App GitHub Releases，选择标记为 Latest 的版本。
在 Assets 中下载与系统匹配的安装包。
运行安装包并按系统提示完成安装。
安装完成后打开 Codex App，确认应用能正常启动。

Windows 如果安装 .Msix 时提示“你的系统管理员已阻止此程序”，通常是当前设备策略不允许从商店外安装 MSIX / AppX 包，或应用安装器 / AppX 部署服务被禁用。请优先尝试 Microsoft Store 官方页面；公司、学校或其他受组织策略管理的设备需要联系设备管理员放行，GitHub Release 安装包不会绕过本机安装策略。

03

第三步：安装 Codex++

访问 codex++ releases 下载最新版安装包，并按当前系统完成安装。

打开 Codex++ GitHub Releases，选择标记为 Latest 的版本。
在 Assets 中下载与系统和芯片架构匹配的安装包。
运行安装包并按系统提示完成安装。
安装完成后重新打开 Codex 或终端，再检查 Codex++ 是否正常加载。

macOS 如果提示无法打开来自互联网的应用，请在“系统设置 → 隐私与安全性”中允许打开对应应用。

04

第四步：注册账号

前往嘉合杉升AI接入系统完成注册。注册时用户名请使用真名，方便管理员识别并给予额度。本系统获得的 API Key 只能用于 Codex，不可接入龙虾或其他工具。

打开注册页面并按提示填写账号信息。
用户名填写本人真名，避免使用昵称或缩写。
提交注册后等待管理员审核并分配额度。
额度生效后，只在 Codex 中使用对应 API Key，不要接入龙虾或其他工具。

05

第五步：添加令牌

登录嘉合杉升 AI 接入系统，进入控制台。
在控制台中打开“令牌管理”。
点击“添加令牌”。
在“基本信息”中填写“名称”，名称可以随便命名。

06

第六步：保存令牌信息

复制创建令牌后生成的密钥，确认它以 sk- 开头。
回到嘉合杉升 AI 接入系统首页。
在首页复制基址，也就是后续配置需要填写的 base URL。
将 API key 和 base URL 保存到本地，后续配置 Codex 时会用到。

07

第七步：配置供应商

确认桌面上已有 Codex、Codex++ 和 Codex++ 管理工具。先关闭后台中的相关应用会话，再打开 Codex++ 管理工具，按右侧截图填写供应商配置。

确认后台中的 Codex、Codex++ 和 Codex++ 管理工具会话都已关闭。
打开 Codex++ 管理工具。
在侧边栏选择“供应商配置”。
点击“+ 添加供应商”。
按照右侧截图完成配置（图片可单击放大查看），其中 Base URL 和 Key 使用第六步保存的内容。
点击上方“保存”按钮保存配置。

08

第八步：启动配置好的 Codex

回到“供应商配置”列表。
选择并使用刚刚添加的供应商配置。
点击上方“重启 Codex++”按钮，让配置生效。
双击桌面上的 Codex++（注意不是Codex），启动已经配置好的 Codex。

面向新手的 Codex 配置教程