将 Codex 接入阿里云百炼,无需复杂的中间代理即可实现。以下是从安装到使用的完整操作步骤:

第一步:安装 Codex

  1. 确保你的电脑已安装 Node.js(建议 v18.0 或更高版本)。

  2. 在终端中执行以下命令全局安装 Codex:

    npm install -g @openai/codex
  3. 安装完成后,执行 codex --version 验证是否安装成功。

第二步:获取 API Key

前往阿里云百炼控制台,进入「API 密钥管理」页面,创建并复制你的专属 API Key(通常以 sk-... 开头)。

第三步:配置环境变量

Codex 需要通过环境变量读取 API Key。首先确认你当前的默认 Shell 类型(可通过 echo $SHELL 查看),然后执行对应的配置命令:

  • Zsh / Bash:

    echo 'export OPENAI_API_KEY="你的API_Key"' >> ~/.zshrc

    接着执行 source ~/.zshrc 使环境变量生效。

  • PowerShell (Windows):

    [System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API_Key", "User")

第四步:修改配置文件

编辑 Codex 的配置文件 ~/.codex/config.toml(若没有该目录可手动创建),填入以下配置内容(以按量计费为例):

model_provider = "Model_Studio_Token_Plan"
model = "qwen3.7-max"

[model_providers.Model_Studio_Token_Plan]
name = "Model_Studio_Token_Plan"
base_url = "https://dashscope.aliyuncs.com/compatible-mode/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

注:如果你使用的是 Token Plan 团队版,请将 base_url 替换为 https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1;如果使用的是新加坡地域,请替换为对应的新加坡域名。

第五步:启动并使用

配置完成后,重启终端并在你的项目目录下运行 codex 命令即可进入交互模式。你可以直接向它发送自然语言指令,例如:"把 utils.js 里的重复代码提取成函数",Codex 便会调用通义千问模型为你完成代码编写与重构任务。