mirror of https://github.com/aiclientproxy/proxycast.git synced 2026-10-16 07:16:36 +08:00

Files

T

## Features
- 版本升级至 0.68.0

## Fixes
- 修复 EmptyState 组件标题排版问题
- 修复"开始生成"按钮文字换行问题
- 修复加载历史对话失败问题
  - 修复 parse_message_content 保留 ContentPart 结构
  - 修复 convert_agent_message 添加 reasoning_content 处理
  - 修复 WorkspaceType::from_str 命名冲突，重命名为 parse

## Code Quality
- 修复所有 clippy 警告
  - 修复 manual_flatten 警告
  - 修复 ptr_arg 警告（使用 &Path 替代 &PathBuf）
  - 修复 manual_clamp 警告
  - 修复 match_single_binding 警告
- 所有测试通过 (174 passed)

2026-02-16 20:58:55 +08:00

2.9 KiB

Raw Blame History

title, description, navigation

title

description

navigation

Codex

OpenAI Codex OAuth Provider 配置

icon
i-heroicons-code-bracket

Codex Provider

::alert{type="info"} 本页属于进阶连接配置。若你已能正常创作，可先跳过。 ::

通过 OAuth 认证使用 OpenAI Codex 服务。

概述

Codex Provider 允许你使用 OpenAI Codex 的 OAuth 凭证访问 GPT 模型。同时，为了兼容 Codex CLI 的「API Key 登录」用户（~/.codex/auth.json 只有 api_key），ProxyCast 也支持读取 api_key 并作为 Bearer Token 使用（无需刷新）。

支持的模型

GPT-4 系列
GPT-3.5 系列
其他 Codex 支持的模型

配置

凭证池配置

credential_pool:
  codex:
    - id: "codex-main"
      token_file: "codex/oauth.json"
      disabled: false
      proxy_url: "http://proxy:8080"  # 可选

配置项说明

配置项	类型	必填	说明
id	string	✅	凭证唯一标识
token_file	string	✅	Token 文件路径（相对于 auth_dir）
disabled	boolean	❌	是否禁用此凭证
proxy_url	string	❌	单独的代理 URL

OAuth 登录

通过 UI 登录

打开 ProxyCast
进入 Provider 管理页面
找到 Codex 部分
点击"OAuth 登录"按钮
在弹出的浏览器中完成认证
认证成功后自动保存凭证

Token 文件格式

OAuth 模式（推荐用于 Codex OAuth）

{
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "expires_at": "2025-01-01T00:00:00Z",
  "token_type": "Bearer"
}

API Key 模式（兼容 Codex CLI）

{
  "api_key": "sk-xxx",
  "api_base_url": "https://api.openai.com" 
}

说明：

api_key / apiKey：必填
api_base_url / apiBaseUrl：可选；可填写 https://api.openai.com 或带 /v1 的地址（例如网关、反代、Azure 兼容地址）

Token 刷新

ProxyCast 会自动在 Token 过期前刷新：

检测到 Token 即将过期时自动刷新
刷新失败时标记凭证为无效
无效凭证会在 UI 中显示警告

使用示例

API 请求

curl http://127.0.0.1:8999/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

路由配置

将 GPT 模型路由到 Codex：

routing:
  rules:
    - pattern: "gpt-*"
      provider: "codex"
      priority: 1

多账号配置

credential_pool:
  codex:
    - id: "codex-1"
      token_file: "codex/account1.json"
    - id: "codex-2"
      token_file: "codex/account2.json"

ProxyCast 会自动在多个凭证之间负载均衡。

故障排除

Token 刷新失败

检查网络连接
确认 OAuth 授权未被撤销
尝试重新登录

凭证无效

删除旧的 Token 文件
重新进行 OAuth 登录
检查账号状态

2.9 KiB Raw Blame History Unescape Escape