如何接入合聚 API从注册到第一次使用 Codex想让 AI 帮你读代码、排查问题、编写功能却卡在了安装和接口配置这一步对于第一次接触 AI 编程工具的用户来说模型名称、API Key、接口地址这些参数看起来有些复杂。其实只要按顺序完成注册、创建令牌和配置就能开始使用。这篇教程以合聚 API为例带你接入 Codex完成第一次对话。以下操作以 Windows 系统中的 Codex 命令行工具为例。1. 注册账号准备可用额度打开合聚API网站点击注册根据页面提示填写用户名、密码和邮箱完成验证后登录。进入控制台先查看账户余额。如果需要充值或兑换额度按后台指引操作即可。第一次使用可以先从小额测试开始了解效果与实际消耗后再决定后续用量。合聚 API 提供多模型接入公开模型列表包含 GPT、Claude、Gemini 等系列。对于希望尝试不同模型、把 AI 接进日常工具的用户来说一个集中的接入入口能让配置和选择更方便。本篇先完成 Codex 接入其他模型和应用可以在熟悉流程后继续探索。2. 创建调用所需的 API Key登录后进入“令牌管理”点击“添加令牌”。给令牌起一个容易识别的名称例如codex-test根据合聚公开配置文档新手可以先考虑 default 分组然后在模型广场确认该分组支持的模型。如果设置了令牌额度、有效期或模型限制请确保这些设置允许本次调用。保存后复制完整的 API Key后面配置 Codex 时会用到。API Key 是调用凭证应保存在自己的设备或密码管理器中避免放进公开截图、聊天群和代码仓库。另外令牌“不限额”表示没有单独的令牌额度上限调用仍然会消耗账户余额。3. 确认接口地址和模型名称接入 Codex需要准备好三个参数参数本篇示例Base URLhttps://www.hejuapi.com/v1API Key你在合聚后台创建的完整令牌模型名称gpt-6-astra本篇采用合聚公开 Codex 教程中的示例模型 gpt-6-astra。使用前请在模型广场确认当前可用性、所属分组和计费标准。Codex 使用 Responses 接口。配置中的 Base URL 填写到 /v1 即可不要追加 /chat/completions。后续更换模型时也需要重新核对令牌分组和模型权限。4. 安装并配置 Codex先在电脑上安装 Node.js LTS 版本。安装完成后重新打开命令提示符也就是 CMD。可以按 Win R输入 cmd再按回车。先检查 Node.js 和 npm 是否安装成功node -v npm -v如果能看到版本号继续安装 Codexnpm install -g openai/codex安装完成后执行codex --version能看到版本号说明 Codex 已安装。接下来配置接口地址和密钥。如果你已经使用过 Codex先备份现有的 config.toml 和 auth.json如果使用 CC Switch 管理配置可以在该工具中更新服务商和密钥。下面采用手动文件配置方式。在 CMD 中创建配置目录并打开配置文件if not exist %USERPROFILE%\.codex mkdir %USERPROFILE%\.codex notepad %USERPROFILE%\.codex\config.toml首次配置时将以下内容粘贴进去并保存cli_auth_credentials_store file model gpt-6-astra model_provider hejuapi [model_providers.hejuapi] name 合聚 API base_url https://www.hejuapi.com/v1 wire_api responses requires_openai_auth true如果文件中已有其他配置请按需更新避免重复填写同一个字段。然后打开身份认证文件notepad %USERPROFILE%\.codex\auth.json填入以下内容把占位文字替换为你在合聚后台复制的完整密钥{ OPENAI_API_KEY: 替换为你的合聚API完整密钥 }虽然字段名是 OPENAI_API_KEY这里填写的是合聚 API 的令牌。保存时选择“所有文件”确认文件名分别是 config.toml 和 auth.json没有额外的 .txt 后缀。这两个文件应放在同一个配置目录中如果设置过 CODEX_HOME则使用该目录。5. 启动 Codex完成第一次调用可以先创建一个空文件夹用来测试接入。在 CMD 中执行mkdir heju-codex-democd heju-codex-democodex按提示完成初始化进入对话界面后输入请用中文介绍你能如何帮助我完成编程任务。如果 Codex 返回正常回答就说明本次对话已接通。接下来可以尝试一个更具体的任务请帮我规划一个待办事项网页列出需要创建的文件和实现步骤。如果有现成项目也可以在项目目录中启动 Codex输入请阅读当前项目介绍主要文件的作用。从读代码、解释项目开始再逐步尝试排查问题、编写功能能更容易熟悉它的工作方式。你还可以输入/status查看当前模型和服务商并到合聚控制台的“使用日志”检查调用记录与消耗。如果没有成功优先检查这些地方问题 优先检查提示 codex 不是内部或外部命令 安装是否完成是否重新打开终端401 或令牌认证失败 密钥是否完整、是否失效认证文件是否正确保存模型不可用或无可用渠道 模型名称、令牌分组和模型限制余额或额度不足 账户余额、令牌配额和有效期无法连接或请求超时 Base URL、网络连接、线路状态和平台公告合聚 API 提供了一个集中选择模型和线路的入口而 Codex 则把模型能力带进了实际的编程过程。完成这次接入后你可以从一个小任务开始观察回答质量、处理效率和调用消耗再逐步融入自己的工作流程。本文配置参考合聚 Codex Windows 手动安装教程。模型、价格和可用线路可能调整请以平台最新展示为准。注册合聚 API开始你的第一次 Codex 调用
如何接入合聚 API从注册到第一次使用 Codex想让 AI 帮你读代码、排查问题、编写功能却卡在了安装和接口配置这一步对于第一次接触 AI 编程工具的用户来说模型名称、API Key、接口地址这些参数看起来有些复杂。其实只要按顺序完成注册、创建令牌和配置就能开始使用。这篇教程以合聚 API为例带你接入 Codex完成第一次对话。以下操作以 Windows 系统中的 Codex 命令行工具为例。1. 注册账号准备可用额度打开合聚API网站点击注册根据页面提示填写用户名、密码和邮箱完成验证后登录。进入控制台先查看账户余额。如果需要充值或兑换额度按后台指引操作即可。第一次使用可以先从小额测试开始了解效果与实际消耗后再决定后续用量。合聚 API 提供多模型接入公开模型列表包含 GPT、Claude、Gemini 等系列。对于希望尝试不同模型、把 AI 接进日常工具的用户来说一个集中的接入入口能让配置和选择更方便。本篇先完成 Codex 接入其他模型和应用可以在熟悉流程后继续探索。2. 创建调用所需的 API Key登录后进入“令牌管理”点击“添加令牌”。给令牌起一个容易识别的名称例如codex-test根据合聚公开配置文档新手可以先考虑 default 分组然后在模型广场确认该分组支持的模型。如果设置了令牌额度、有效期或模型限制请确保这些设置允许本次调用。保存后复制完整的 API Key后面配置 Codex 时会用到。API Key 是调用凭证应保存在自己的设备或密码管理器中避免放进公开截图、聊天群和代码仓库。另外令牌“不限额”表示没有单独的令牌额度上限调用仍然会消耗账户余额。3. 确认接口地址和模型名称接入 Codex需要准备好三个参数参数本篇示例Base URLhttps://www.hejuapi.com/v1API Key你在合聚后台创建的完整令牌模型名称gpt-6-astra本篇采用合聚公开 Codex 教程中的示例模型 gpt-6-astra。使用前请在模型广场确认当前可用性、所属分组和计费标准。Codex 使用 Responses 接口。配置中的 Base URL 填写到 /v1 即可不要追加 /chat/completions。后续更换模型时也需要重新核对令牌分组和模型权限。4. 安装并配置 Codex先在电脑上安装 Node.js LTS 版本。安装完成后重新打开命令提示符也就是 CMD。可以按 Win R输入 cmd再按回车。先检查 Node.js 和 npm 是否安装成功node -v npm -v如果能看到版本号继续安装 Codexnpm install -g openai/codex安装完成后执行codex --version能看到版本号说明 Codex 已安装。接下来配置接口地址和密钥。如果你已经使用过 Codex先备份现有的 config.toml 和 auth.json如果使用 CC Switch 管理配置可以在该工具中更新服务商和密钥。下面采用手动文件配置方式。在 CMD 中创建配置目录并打开配置文件if not exist %USERPROFILE%\.codex mkdir %USERPROFILE%\.codex notepad %USERPROFILE%\.codex\config.toml首次配置时将以下内容粘贴进去并保存cli_auth_credentials_store file model gpt-6-astra model_provider hejuapi [model_providers.hejuapi] name 合聚 API base_url https://www.hejuapi.com/v1 wire_api responses requires_openai_auth true如果文件中已有其他配置请按需更新避免重复填写同一个字段。然后打开身份认证文件notepad %USERPROFILE%\.codex\auth.json填入以下内容把占位文字替换为你在合聚后台复制的完整密钥{ OPENAI_API_KEY: 替换为你的合聚API完整密钥 }虽然字段名是 OPENAI_API_KEY这里填写的是合聚 API 的令牌。保存时选择“所有文件”确认文件名分别是 config.toml 和 auth.json没有额外的 .txt 后缀。这两个文件应放在同一个配置目录中如果设置过 CODEX_HOME则使用该目录。5. 启动 Codex完成第一次调用可以先创建一个空文件夹用来测试接入。在 CMD 中执行mkdir heju-codex-democd heju-codex-democodex按提示完成初始化进入对话界面后输入请用中文介绍你能如何帮助我完成编程任务。如果 Codex 返回正常回答就说明本次对话已接通。接下来可以尝试一个更具体的任务请帮我规划一个待办事项网页列出需要创建的文件和实现步骤。如果有现成项目也可以在项目目录中启动 Codex输入请阅读当前项目介绍主要文件的作用。从读代码、解释项目开始再逐步尝试排查问题、编写功能能更容易熟悉它的工作方式。你还可以输入/status查看当前模型和服务商并到合聚控制台的“使用日志”检查调用记录与消耗。如果没有成功优先检查这些地方问题 优先检查提示 codex 不是内部或外部命令 安装是否完成是否重新打开终端401 或令牌认证失败 密钥是否完整、是否失效认证文件是否正确保存模型不可用或无可用渠道 模型名称、令牌分组和模型限制余额或额度不足 账户余额、令牌配额和有效期无法连接或请求超时 Base URL、网络连接、线路状态和平台公告合聚 API 提供了一个集中选择模型和线路的入口而 Codex 则把模型能力带进了实际的编程过程。完成这次接入后你可以从一个小任务开始观察回答质量、处理效率和调用消耗再逐步融入自己的工作流程。本文配置参考合聚 Codex Windows 手动安装教程。模型、价格和可用线路可能调整请以平台最新展示为准。注册合聚 API开始你的第一次 Codex 调用
