Codex 使用教程 (macOS / Linux)

1. 安装 Codex

打开 Terminal，运行以下命令全局安装 Codex CLI：

npm install -g @openai/codex@latest

安装完成后可验证版本：

codex --version

2. 设置环境变量

为了让 Codex 连接到镜像服务，需要设置环境变量。

方式一：临时设置（当前会话有效）

export OPENAI_API_KEY="您的 KiCode API Key"

方式二：永久设置（bash）

echo 'export OPENAI_API_KEY="您的 KiCode API Key"' >> ~/.bashrc
source ~/.bashrc

方式三：永久设置（zsh）

echo 'export OPENAI_API_KEY="您的 KiCode API Key"' >> ~/.zshrc
source ~/.zshrc

3. 配置 Codex

运行以下命令创建配置文件，跳过登录流程：

mkdir -p ~/.codex && cat <<'EOF' > ~/.codex/config.toml
model_provider = "kicode"

[model_providers.kicode]
name = "kicode"
base_url = "https://kicode.chat/api/codex/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
requires_openai_auth = false
EOF

如果之前执行过 codex login，请先清理本地登录态，避免继续携带 OpenAI JWT：

rm -f ~/.codex/auth.json

4. 开始使用 Codex

进入你的项目目录，然后启动 Codex CLI：

cd your-project-folder
codex