QUICK START · 快速接入

三个步骤，开始使用。

选择你使用的工具，跟着下面操作。Codex 配置可直接复制执行，脚本会自动备份并处理配置文件。

统一 API 地址https://api.aliveai.asia/v1

创建一个 API Key

登录控制台，进入“令牌管理”，点击“添加令牌”，保存后复制 Key。

已有 Key 可直接进行下一步。这里使用的是控制台生成的令牌。

打开 PowerShell，粘贴这条命令并按 Enter。已经安装过的用户也可用它更新。

npm install --global @openai/codex

提示找不到 npm？先安装 Node.js

安装 Node.js LTS 后关闭终端，再重新打开。Windows 也可以执行：

winget install OpenJS.NodeJS.LTS

复制下面的配置脚本，粘贴到 PowerShell 并按 Enter。根据提示输入 API Key，完成后自动启动 Codex。

默认沿用站点的 gpt-5.4，也可以填写你账户可用的模型名称。

API Key 在你的终端中输入，不会发送到本页面；Windows 会将它保存到当前用户的环境变量。

查看脚本内容与下载后的运行方法

脚本只更新 AliveAI 配置；修改前会生成 .bak 备份。下载后可在终端执行下面这条命令（文件在下载文件夹时）：

在项目文件夹中打开终端，运行下面的命令，然后直接描述你要做的事。

codex --profile aliveai

例如：“检查这个项目，帮我修复登录按钮没有反应的问题。”

在控制台“令牌管理”中添加令牌，保存并复制 Key。

在客户端中添加 OpenAI 兼容服务，按下面填写。

如果客户端会自动添加 /v1，就填写 https://api.aliveai.asia。选择模型前确认客户端支持它的接口类型；Codex 编码模型使用 Responses API。

发送一句“你好”确认能收到回复，之后可在控制台查看余额和用量。

401 / API Key 无效

确认使用“令牌管理”生成的 Key，且复制完整。Windows 如需更换 Key，执行下面命令后重新配置；macOS / Linux 在下次启动时输入新的 Key。

Remove-Item Env:ALIVEAI_API_KEY -ErrorAction SilentlyContinue

模型不可用 / model not found

在模型广场确认模型名称和账户权限，将第 3 步的模型名称改为可用模型，然后重新运行配置脚本。

余额不足 / 额度用完

在控制台检查账户余额和令牌剩余额度，需要时前往充值中心。充值后重新发起请求。

Windows 提示禁止运行脚本

安装命令改为 npm.cmd install --global @openai/codex；配置完成后用 codex.cmd --profile aliveai 启动。下载的配置脚本可使用上方提供的 PowerShell 运行命令。

404 / 接口地址错误

检查 API 地址是否重复添加 /v1。Codex 的地址应为 https://api.aliveai.asia/v1，接口类型为 responses。

超时或连接中断

先查看服务状态，再检查本地网络。联系客服时提供错误信息、模型名称和发生时间即可：QQ 2863225856。