Flaq AI 智能体指南

实用指南 | 在 OpenAI Codex CLI 中使用 Flaq AI API 服务与开源 AI Agent 技能

使用 Flaq AI 的 OpenAI 兼容接口，可以快速完成 OpenAI Codex CLI 的接入配置，并在终端使用我们提供的模型服务。配置 API key 后，您可以参考指南提供的示例，选择目前支持的 GPT 模型，并完成调试验证。您还可以探索可复用的开源 Codex 技能，扩展 AI Agent 能力并支持更多工作流。

智能体指南

Claude Code/cc-api OpenAI Codex/codex-api/v1 Hermes Agent/api/v1

安装

安装 Codex CLI

安装官方 Codex CLI 包或应用，然后先确认 codex 命令可用，再继续配置 Flaq AI。如果使用 npm 安装，需要 Node.js 22 或更高版本。

安装 Codex CLI

选择适合当前系统的安装方式，然后运行下面的命令。

官方安装脚本

curl -fsSL https://chatgpt.com/codex/install.sh | sh

验证 Codex CLI

在配置 Flaq provider 之前，先确认 codex 命令已经可以使用。

验证安装

codex --version

安装 Codex CLI

选择适合当前系统的安装方式，然后运行下面的命令。

npm 全局安装

npm install -g @openai/codex

验证 Codex CLI

在配置 Flaq provider 之前，先确认 codex 命令已经可以使用。

验证安装

codex --version

配置

在 Codex CLI 中配置 Flaq AI

先选择 Flaq Codex 接口当前支持的模型，再把 Flaq 配置为 Codex 的 model provider，并通过 OPENAI_API_KEY 提供你的 Flaq API key。开源 Codex 技能涵盖编码、部署、测试、文档、创意工作及其他任务的可复用工作流。

通过 Flaq AI 运行 Codex 编码工作流时使用的默认 GPT 5.6 模型。

在当前终端会话中临时设置 OPENAI_API_KEY。这种方式不会把 API key 写入 ~/.codex/auth.json，但 Codex 仍然需要在 ~/.codex/config.toml 中配置 Flaq provider。

Codex provider 设置

创建或更新 provider 配置，并保持 wire_api 为 responses。在 Windows 上，使用 %USERPROFILE%\.codex\config.toml。

Codex provider 设置

~/.codex/config.toml

model = "gpt-5.4" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex provider 设置

~/.codex/config.toml

model = "gpt-5.5" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex provider 设置

~/.codex/config.toml

model = "gpt-5.6-sol" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex provider 设置

~/.codex/config.toml

model = "gpt-5.6-terra" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

Codex provider 设置

~/.codex/config.toml

model = "gpt-5.6-luna" model_provider = "flaq" [model_providers.flaq]name = "flaq gpt"base_url = "https://api.flaq.ai/codex-api/v1"wire_api = "responses"requires_openai_auth = true

为当前终端设置 Flaq API key

这个 export 只对当前终端会话生效，不会修改 ~/.codex/auth.json 或你的 shell profile。

为当前终端设置 Flaq API key

export OPENAI_API_KEY="Your_Flaq_Api_Key"

在当前 PowerShell 会话中临时设置 OPENAI_API_KEY。这种方式不会把 API key 写入 %USERPROFILE%\.codex\auth.json，但 Codex 仍然需要在 %USERPROFILE%\.codex\config.toml 中配置 Flaq provider。

Codex provider 设置

创建或更新 provider 配置，并保持 wire_api 为 responses。

Codex provider 设置