Codex 是 OpenAI 开源的编程智能体命令行工具(CLI),在本地终端运行,支持接入 OpenAI 兼容的自定义模型服务商。
Codex 是独立的可执行程序(Rust 编写),无需预装 Node.js 等任何运行环境(用 npm 渠道安装除外)。
系统要求:macOS 12+;Ubuntu 20.04+ / Debian 10+;Windows 11;内存最低 4GB(推荐 8GB)。
安装包默认从 releases.openai.com 下载,不可用时自动回退 GitHub Releases;也支持 npm / Homebrew 渠道安装。
| 系统 | 操作 |
|---|---|
| Windows | 按 Win + R,输入 powershell,回车 |
| macOS | 打开"启动台"→"其他"→"终端"(或搜索"Terminal") |
| Linux | 直接打开系统自带的终端 |
在终端里执行以下命令(三平台命令完全相同,直接复制粘贴):
windows
• 按 Win + R,输入 powershell 回车打开终端,整段复制执行:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
• 也可以用 npm 安装(需已装 Node.js):
npm install -g @openai/codex
或到 GitHub Releases 手动下载对应系统的版本。
• 验证:关闭当前窗口,重新打开一个 PowerShell,输入下面命令:
如果显示版本号,说明安装成功。
codex --version
等待安装完成(约 5分钟)。
macOS用户改用下面这条命令(在终端中执行):
• 方式一:打开"终端",执行官方安装脚本:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
• 方式二(推荐有 Homebrew 的用户):打开"终端",执行
brew install --cask codex。
• 验证:在终端输入如下代码,显示版本号即成功。
codex --version
linux用户改用下面这条命令(在终端中执行):
# Ubuntu / Debian 等发行版
curl -fsSL https://chatgpt.com/codex/install.sh | sh
# 或用 npm 安装(需已安装 Node.js)
npm install -g @openai/codex
验证:新开一个终端窗口,输入如下代码,显示版本号即成功。输入codex启动工作台(首次运行会进入初始化引导):
codex --version
codex
若提示"无法将 codex 识别为命令",PATH 尚未生效。
Windows 关闭当前窗口新开一个 PowerShell;
macOS 执行 source /.zshrc,Linux 执行 source /.bashrc,或都直接新开一个终端窗口。
若仍不行,用 npm root -g 确认 codex 的全局安装目录(npm 渠道)是否在 PATH 中;仍异常可重新执行 2.2 对应系统的安装命令。
Codex 的模型配置统一写入 /.codex/config.toml(Windows 为 C:\Users\你的用户名\.codex\config.toml),TOML 格式(支持注释);API Key 不写进文件,通过 env_key 指定的环境变量传入,分两步配置: 方式一(推荐):编辑 config.toml; 方式二:设置 TELEAI_API_KEY 环境变量,与 config.toml 里 env_key 的名字对应。1)方式一:直接编辑 config.toml(推荐,三平台通用)配置文件位置——Windows:C:\Users\你的用户名\.codex\config.toml;
macOS / Linux:/.codex/config.toml。用记事本或 VS Code 打开该文件(不存在则新建目录与文件),写入以下内容:
model = "TeleChat3-438B-A24B"
model_provider = "teleai"
[model_providers.teleai]
name = "TeleAI"
base_url = "https://api-maas.teleai.com.cn/v1 "
env_key = "TELEAI_API_KEY"
wire_api = "responses"
保存后即写入配置文件,永久生效。
设置APIkey到环境变量:
setx TELEAI_API_KEY "把这里替换成你的API Key"
2)方式二:设置 API Key 环境变量
临时生效(当前窗口):Linux / Mac 用户在终端执行:
export TELEAI_API_KEY="把这里替换成你的API Key"
Windows 用户在 PowerShell 执行:
$env:TELEAI_API_KEY = "把这里替换成你的API Key"
永久生效:macOS / Linux 把 export 行追加到 /.zshrc 或 /.bashrc;Windows 执行 setx TELEAI_API_KEY "把这里替换成你的API Key"(写入用户环境变量,对之后新开的窗口生效)。
修改并保存后,重新运行 codex 即生效(正在运行的会话不受影响)。
统一验证:在 PowerShell / 终端执行下面命令,向星辰模型发一句话:
codex # 交互模式
codex exec "回复:配置成功" # 非交互模式
进入界面后在输入框发送"回复:配置成功",收到回复即表示配置生效(也可直接执行 codex exec 非交互验证)。
如需排查,可带调试日志运行:Linux / Mac 执行 RUST_LOG=debug codex;Windows PowerShell 先执行 $env:RUST_LOG,再运行 codex。
Codex 在终端以交互界面(TUI)运行,用完直接关窗口。
codex
换到别的项目使用时,先 cd 到那个目录再运行 codex;在输入框输入需求、回车发送即可。
第一次启动可能需要确认一些提示,按提示输入 y 回车即可。启动后你就可以直接用自然语言和它对话了。
运行效果(启动后的界面长这样):选择1,回车进入对话界面
如果你已经安装了Hermes Agent(正在用其他模型),只需修改配置文件(config.yaml)即可切换到星辰模型,无需重装。
Codex 对应配置
第一步,设置环境变量:
export TELEAI_API_KEY="把这里替换成你的API Key"
第二步:编辑 ~/.codex/config.toml(文件不存在则新建目录与文件),写入以下内容:
model = "TeleChat3-438B-A24B"
model_provider = "teleai"
[model_providers.teleai]
name = "TeleAI"
base_url = "https://api-maas.teleai.com.cn/v1 "
env_key = "TELEAI_API_KEY"
wire_api = "responses"
Codex 对应配置
第一步,设置环境变量:
$env:TELEAI_API_KEY = "把这里替换成你的API Key"
第二步:编辑 C:\Users\你的用户名\.codex\config.toml(文件不存在则新建目录与文件),写入以下内容:
model = "Xing4.1-Preview"#替换成需要的模型id
model_provider = "teleai"
[model_providers.teleai]
name = "TeleAI"
base_url = "https://api-maas.teleai.com.cn/v1"
env_key = "TELEAI_API_KEY"
wire_api = "responses" #0.80版本建议升级到最新版,或旧版的参数改成“chat”
说明:以上配置写入 Codex 配置文件(/.codex/config.toml),永久生效;环境变量只对当前窗口有效,想长期生效:macOS / Linux 把 export 行追加进 /.zshrc 或 ~/.bashrc;Windows 先执行 setx TELEAI_API_KEY "把这里替换成你的API Key",再重开 PowerShell。
Codex 在终端里以交互界面(TUI)运行,随用随开。
配置完成后,在项目目录下执行:
codex
codex 会直接在当前终端启动交互界面,在输入框输入内容、回车发送即可对话。
第一次启动可能需要确认一些提示,按提示输入 y 回车即可。启动后你就可以直接用自然语言和它对话了。
运行效果(启动 Codex 后的交互界面如下图):
(注:下方截图为 codex的运行界面,请替换为 Codex 终端的实际运行截图。)