CLIProxyAPI 接入 Flex AI
CLIProxyAPI 是一个高 Star 的开源本地代理，为 Codex、Claude Code、Gemini 等客户端提供 OpenAI、Responses、Claude 与 Gemini 兼容接口。它是本分类中额外选择的本地 API 路由工具。
为什么选择它
在与 CC Switch、Cockpit Tools 用途接近、明确支持编码 CLI 的本地代理项目中，CLIProxyAPI 是 GitHub Star 数较高且支持自定义 OpenAI-compatible 上游的代表项目。Star 数会变化，因此请以官方仓库显示为准。
认识两种 API Key
CLIProxyAPI 配置里会出现两类密钥：
| 密钥 | 用途 |
|---|---|
| Flex247 上游 Key | CLIProxyAPI 请求 https://api.noflex.work/v1 时使用 |
| 本地客户端 Key | Codex 或其他客户端访问 CLIProxyAPI 时使用 |
请为两者使用不同的值，不要把本地客户端 Key 填到 Flex247，也不要把 Flex247 Key 直接发给本地客户端。
1. 安装
从官方 Releases 下载与你的系统匹配的压缩包并解压。Windows 通常选择 windows_amd64.zip。
桌面用户也可以使用项目 README 推荐的 EasyCLIProxyAPI 图形界面；本教程使用核心 CLIProxyAPI 配置，便于审查每个路由参数。
2. 创建 config.yaml
复制官方 config.example.yaml 为 config.yaml，然后保留所需字段。下面是 Flex247 的最小安全示例：
host: "127.0.0.1"
port: 8317
api-keys:
- "replace-with-a-long-random-local-client-key"
openai-compatibility:
- name: "flex247"
base-url: "https://api.noflex.work/v1"
api-key-entries:
- api-key: "sk-your-flex247-key"
models:
- name: "gpt-5.6-luna"
alias: "gpt-5.6-luna"需要更多模型时，在 models 下继续添加，并使用模型广场显示的准确 ID：
- name: "your-second-model-id"
alias: "your-second-model-id"保持本机监听
官方示例的空 host 会监听所有网络接口。个人电脑建议明确设置为 127.0.0.1。如需局域网访问，应另外配置防火墙、强随机客户端 Key 与访问控制。
3. 启动并测试
在解压目录启动服务。
Windows PowerShell
.\cli-proxy-api.exe -config config.yamlmacOS / Linux
./cli-proxy-api -config config.yaml启动成功后，用本地客户端 Key 检查模型列表：
curl.exe http://127.0.0.1:8317/v1/models `
-H "Authorization: Bearer replace-with-a-long-random-local-client-key"返回结果应包含你在 models 中配置的 ID。
4. 让 Codex 使用本地路由
先在当前终端设置本地客户端 Key：
$env:FLEX247_LOCAL_PROXY_KEY = "replace-with-a-long-random-local-client-key"然后在用户级 ~/.codex/config.toml（Windows 为 %USERPROFILE%\.codex\config.toml）添加：
model = "gpt-5.6-luna"
model_provider = "flex247_local"
[model_providers.flex247_local]
name = "Flex247 via CLIProxyAPI"
base_url = "http://127.0.0.1:8317/v1"
env_key = "FLEX247_LOCAL_PROXY_KEY"
wire_api = "responses"保持 CLIProxyAPI 运行，再从同一个终端启动 codex。请求路径为：
Codex → http://127.0.0.1:8317/v1 → CLIProxyAPI → https://api.noflex.work/v1常见问题
Invalid API key
Codex 需要的是 api-keys 下的本地客户端 Key，不是 api-key-entries 下的 Flex247 上游 Key。
unknown provider for model
确认请求模型已列在 openai-compatibility.models 中，并检查 name 与 alias 是否与 Codex 配置一致。
无法连接 127.0.0.1:8317
确认 CLIProxyAPI 进程仍在运行、config.yaml 路径正确，并检查端口是否被占用。
上游返回 404
确认 base-url 为 https://api.noflex.work/v1，不要遗漏 /v1，也不要重复成 /v1/v1。