Linux 从零接入

开始前

先完成 创建密钥，准备完整密钥。Ubuntu 桌面可按 Ctrl + Alt + T 打开终端；远程服务器则在自己的 SSH 终端操作。

1. 准备安装工具

Ubuntu / Debian 用户执行：

sudo apt-get update
sudo apt-get install -y curl unzip nano git

Fedora 用户执行：

sudo dnf install -y curl unzip nano git

输入 sudo 密码时屏幕通常不会显示星号，输入完成后按回车即可。其他发行版使用自己的软件包管理器安装这些工具。

2. 安装 Node.js，再通过 npm 安装 Codex

已有 Node.js LTS 和 npm 的用户，可以直接执行本节最后的 npm 安装命令。没有安装时，先打开 Node.js 官方下载页 ↗，选择 Linux；下面使用 fnm 官方 Node.js 版本管理器 ↗ 安装 LTS 版本。

curl -fsSL https://fnm.vercel.app/install | bash

安装结束后关闭终端并重新打开，再执行：

fnm install --lts
fnm use --lts
node -v
npm -v

显示 Node.js 和 npm 的版本号后，通过 npm 安装 Codex：

npm install -g @openai/codex
codex --version

3. 创建配置文件

mkdir -p "$HOME/.codex"
nano "$HOME/.codex/config.toml"

在打开的文字编辑器里粘贴下面内容：

model = "gpt-6.1-sol"
model_provider = "easycode"

[model_providers.easycode]
name = "EasyCode"
base_url = "https://easycodesi.com/v1"
wire_api = "responses"
env_key = "EASYCODE_API_KEY"
requires_openai_auth = false
supports_websockets = false

按 Ctrl + O 保存，按回车确认文件名，再按 Ctrl + X 退出。已有配置请先备份，合并同名项，避免重复写入。

4. 设置并保存密钥

先换成自己的完整密钥，再在当前终端执行：

export EASYCODE_API_KEY="sk-替换为你的密钥"

Ubuntu / Debian 默认 Bash 用户可运行 nano ~/.bashrc，在末尾追加同一行，按 Ctrl+O、回车、Ctrl+X 保存。使用 Zsh 时追加到 ~/.zshrc。这样下一次开终端就不用重新填写。

5. 启动并测试

mkdir -p "$HOME/easycode-demo"
cd "$HOME/easycode-demo"
codex

确认首次的目录信任提示后，在对话框输入：

请只回复：连接成功

6. 以后怎么用

新开终端，进入要处理的项目文件夹后运行 codex。提示缺少密钥时回到第 4 步检查；安装后找不到命令时，先检查 node -v 和 npm -v，再重开终端执行 npm install -g @openai/codex。