Codex++ Agnes 模型配置指南

1. 概述

本指南说明如何在 Codex++ 中配置 Agnes 模型。配置完成后，你可以直接在 Codex++ 中使用 Agnes 模型进行聊天、代码生成和 Agent 任务，无需登录 GPT 账户。

2. 前置条件

在开始之前，请确保你已具备：

      1. 已下载或准备安装 Codex++。
  1. 推荐模型：agnes-2.0-flash
  2. API Base URL：https://apihub.agnes-ai.com/v1

3. 下载 Codex++

打开 Codex++ 下载页面：

https://github.com/BigPizzaV3/CodexPlusPlus

你也可以直接打开最新发布页面：

https://github.com/BigPizzaV3/CodexPlusPlus/releases/latest

下载与你的设备匹配的版本：

设备类型下载文件
Windowswindows-x64-setup.exe
Intel 芯片 Macmacos-x64.dmg
Apple 芯片 Macmacos-arm64.dmg如果你不确定你的 Mac 使用的是 Intel 芯片还是 Apple 芯片，点击左上角的 Apple 图标并选择 关于本机。

4. 安装 Codex++

下载后，正常安装 Codex++。

如果你使用 macOS 并看到以下错误：

"Codex++" is damaged and can't be opened.
打开 终端 并运行以下命令：
sudo xattr -rd com.apple.quarantine "/Applications/Codex++.app"
sudo xattr -rd com.apple.quarantine "/Applications/Codex++ 管理工具.app"
运行命令后，重新打开 Codex++ 管理工具。

5. 打开 Codex++ 管理工具

安装完成后，打开：

Codex++ Management Tool
在左侧边栏中，点击：
Provider Configuration
然后点击：
Add Provider
接下来，按照以下配置填写 Agnes 提供商信息。

6. 添加 Agnes 提供商

填写以下字段：

字段值
名称Agnes
访问模式API Only
测试模型agnes-2.0-flash
Base URLhttps://apihub.agnes-ai.com/v1
Key输入你的 Agnes API Key
上游协议Chat Completions配置示例：
Name:
Agnes
Access Mode:
API Only
Test Model:
agnes-2.0-flash
Base URL:
https://apihub.agnes-ai.com/v1
Key:
Enter your Agnes API Key
Upstream Protocol:
Chat Completions

7. 配置注意事项

请仔细检查以下内容：

  1. 只输入以 sk- 开头的 API 密钥。不要包含 Bearer。
  2. Base URL 应以 /v1 结尾。不要输入 /chat/completions。
  3. 上游协议必须为 Chat Completions。
  4. 模型名称应为：agnes-2.0-flash
  5. 完成配置后，点击：
Save

8. 启用 Agnes 提供商

保存配置后，返回提供商列表并选择：

Agnes
如果你看到以下任一按钮，点击它以启用 Agnes 提供商：

Use
In Use
Switch to This Provider
成功启用后，Agnes 将成为当前活动的提供商。

9. 启动 Codex++

返回左侧边栏，点击：

Overview然后点击：
Start Codex++
你也可以点击右上角的按钮：
Restart Codex
启动后，你可以正常使用 Codex++，请求将通过 Agnes 模型路由。

10. 验证配置

打开 Codex++ 并创建一个新会话。输入一个简单的测试消息，例如：

你好，请介绍一下你自己。
如果 Codex++ 正常响应，Agnes 模型配置成功。

11. 常见问题

1. Codex 无法正常响应怎么办？请检查以下内容：

  • 确保你是从 Codex++ 或 Codex++ 管理工具 启动 Codex，而不是打开原始的 Codex。
  • 确保 Base URL 为：https://apihub.agnes-ai.com/v1
  • 确保 Key 只包含以 sk- 开头的 API 密钥。
  • 确保上游协议为：
Chat Completions
  • 确保模型为：agnes-2.0-flash
  • 确保保存配置后已启用 Agnes 提供商。

2. 我应该如何输入 API Key？

只输入 Agnes API Key 本身，例如：

sk-xxxxxxxxxxxxxxxx
不要输入：
Bearer sk-xxxxxxxxxxxxxxxx

3. 我应该如何输入 Base URL？

正确：https://apihub.agnes-ai.com/v1错误：https://apihub.agnes-ai.com/v1/chat/completions

4. 我需要登录 GPT 账户吗？

不需要。配置完成后，你可以直接使用 Agnes 模型使用 Codex++。

12. 推荐配置摘要

提供商名称： Agnes

模式： API Only

模型： agnes-2.0-flash

Base URL： https://apihub.agnes-ai.com/v1

API Key： YOUR_AGNES_API_KEY

协议： Chat Completions

13. 完整设置摘要

  1. 下载并安装 Codex++。
  2. 打开 Codex++ 管理工具。
  3. 进入 Provider Configuration。
  4. 添加 Agnes 提供商。
  5. 输入模型、Base URL、API Key 和上游协议。
  6. 保存配置。
  7. 启用 Agnes 提供商。
  8. 启动或重启 Codex++。
  9. 创建新会话以测试 Codex++ 是否正常响应。
  10. 配置完成后，你可以在 Codex++ 中使用 Agnes 模型。