企业官网建设流程全解析

想让 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，需要准备好三个参数：

本篇采用合聚公开 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

如果能看到版本号，继续安装 Codex：

npm 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-demo
cd heju-codex-demo
codex
按提示完成初始化，进入对话界面后输入：
请用中文介绍你能如何帮助我完成编程任务。
如果 Codex 返回正常回答，就说明本次对话已接通。
接下来，可以尝试一个更具体的任务：
请帮我规划一个待办事项网页，列出需要创建的文件和实现步骤。
如果有现成项目，也可以在项目目录中启动 Codex，输入：
请阅读当前项目，介绍主要文件的作用。
从读代码、解释项目开始，再逐步尝试排查问题、编写功能，能更容易熟悉它的工作方式。
你还可以输入：
/status
查看当前模型和服务商，并到合聚控制台的“使用日志”检查调用记录与消耗。
如果没有成功，优先检查这些地方：
问题 优先检查
提示 codex 不是内部或外部命令 安装是否完成，是否重新打开终端
401 或令牌认证失败 密钥是否完整、是否失效，认证文件是否正确保存
模型不可用或无可用渠道 模型名称、令牌分组和模型限制
余额或额度不足 账户余额、令牌配额和有效期
无法连接或请求超时 Base URL、网络连接、线路状态和平台公告

合聚 API 提供了一个集中选择模型和线路的入口，而 Codex 则把模型能力带进了实际的编程过程。完成这次接入后，你可以从一个小任务开始，观察回答质量、处理效率和调用消耗，再逐步融入自己的工作流程。
本文配置参考合聚 Codex Windows 手动安装教程。模型、价格和可用线路可能调整，请以平台最新展示为准。
注册合聚 API，开始你的第一次 Codex 调用