Skip to content

Agentsflare Codex 配置方案

Codex 是 OpenAI 推出的官方 CLI 编码工具,支持自然语言指令完成代码编写、调试和重构。

安装 Codex

通过 npm 全局安装:

bash
npm install -g @openai/codex

或通过 npx 直接运行(无需安装):

bash
npx @openai/codex

验证安装:

bash
codex --version

配置 Codex

Codex 通过环境变量或配置文件读取 API 设置。以下是使用 Agentsflare 代理的配置方式。

方式一:环境变量(推荐)

在终端中设置以下环境变量后启动 Codex:

bash
export OPENAI_API_KEY="你的 Agentsflare API Key"
export OPENAI_BASE_URL="https://api.agentsflare.com/v1"

然后在同一终端会话中运行:

bash
codex

方式二:配置文件

创建或修改 Codex 配置文件:

  • macOS / Linux: ~/.codex/config.yaml
  • Windows: %USERPROFILE%\.codex\config.yaml

配置文件内容:

yaml
model: gpt-5.2
api_key: "你的 Agentsflare API Key"
base_url: "https://api.agentsflare.com/v1"

API Endpoint 说明

Agentsflare 提供两个兼容 OpenAI 的 API Endpoint,可根据需求选择:

Endpoint地址适用场景
Chat Completionshttps://api.agentsflare.com/v1/chat/completions标准对话、代码生成、常规任务
Responseshttps://api.agentsflare.com/v1/responses复杂推理、工具调用、多轮上下文

配置 Chat Completions Endpoint

bash
export OPENAI_API_KEY="你的 Agentsflare API Key"
export OPENAI_BASE_URL="https://api.agentsflare.com/v1/chat/completions"

配置 Responses Endpoint

bash
export OPENAI_API_KEY="你的 Agentsflare API Key"
export OPENAI_BASE_URL="https://api.agentsflare.com/v1/responses"

常用命令

启动交互式会话:

bash
codex

直接执行单条指令:

bash
codex "把 utils.js 重构成 TypeScript"

指定模型启动:

bash
codex --model gpt-5.2

查看帮助:

bash
codex --help

验证配置

配置完成后,运行以下命令测试连接:

bash
codex "你好,请简单介绍一下自己"

如果 Codex 正常回复,说明配置正确,已通过 Agentsflare 代理成功接入 OpenAI 模型。

本文档遵循 CC BY-SA 4.0 协议。