Flaq AI 智能體指南

使用 Flaq AI API 服務與開源 AI Agent 技能設定 OpenAI Codex CLI 的實用指南

使用 Flaq AI 的 OpenAI 相容端點，你可以快速將 OpenAI Codex CLI 設定為連接 Flaq，並從終端機存取我們的模型服務。設定 API 金鑰後，依照本指南中的範例選擇目前支援的 GPT 模型並驗證設定。你也可以探索可重複使用的開源 Codex 技能，擴充 AI Agent 功能並支援更多工作流程。

智能體指南

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

安裝

安裝 Codex CLI

安裝官方 Codex CLI 套件或應用程式，然後在設定 Flaq AI 前，確認 codex 指令可以使用。使用 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 金鑰。開源 Codex 技能涵蓋程式開發、部署、測試、文件、創意工作及其他任務的可重複使用工作流程。

透過 Flaq AI 執行 Codex 程式開發工作流程時使用的預設 GPT 5.6 模型。

在目前終端機工作階段使用臨時 OPENAI_API_KEY。這能讓你的 API 金鑰不寫入 ~/.codex/auth.json，但 Codex 仍需要 ~/.codex/config.toml 中的 Flaq provider 項目。

Codex provider 設定

建立或更新 provider config，並保持 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 金鑰

此 export 只會套用到目前的終端機工作階段。它不會修改 ~/.codex/auth.json 或你的 shell profile。

為此終端機設定 Flaq API 金鑰

export OPENAI_API_KEY="Your_Flaq_Api_Key"

在目前 PowerShell 工作階段使用臨時 OPENAI_API_KEY。這能讓你的 API 金鑰不寫入 %USERPROFILE%\.codex\auth.json，但 Codex 仍需要 %USERPROFILE%\.codex\config.toml 中的 Flaq provider 項目。

Codex provider 設定

建立或更新 provider config，並保持 wire_api 設為 responses。

Codex provider 設定