快速开始

按顺序做完这几步，就能用 Codex 发出第一条请求。已经有 API Key 时，直接跳到配置部分。

先走这条线

你要完成的事	对应章节
注册并登录控制台	第一步：注册账号、第二步：登录账号
优先购买订阅卡，或少量钱包直充	第三步：购买额度
创建并复制 API Key	第四步：创建-api-key
配置 Codex CLI / Codex App	第五步：配置 CLI 工具
发起一次最小请求	最小验收

Responses / OpenAI-compatible Base URL 都填写 https://api.avemujica.moe/v1。

第一步：注册账号

入口：https://api.avemujica.moe/register

使用稳定邮箱或 OAuth 登录。注册完成后保存账号、邮箱和登录方式，后续找回账号或联系客服时会用到这些信息。

第二步：登录账号

入口：https://api.avemujica.moe/login

在常用浏览器中登录控制台。新设备、新浏览器或清理 Cookie 后需要重新登录。登录失败时，优先检查网络、邮箱、密码和第三方授权状态。

第三步：购买额度

充值入口：https://api.avemujica.moe/console/topup

先看“订阅套餐”。多数用户按天或按周使用时，订阅卡通常比钱包直充更优惠；只有临时补少量额度时，再切到“额度充值”。

订阅	价格	有效期	总额度	购买限制
天卡	10 元	24 小时	$100.00	限购 1
3 天卡	30 元	3 天	$300.00	限购 1
周卡	70 元	7 天	$700.00	限购 1
无限卡	500 元	1 天	不限	不限购

钱包直充按人民币和美元额度 1:1 入账。支持支付宝和微信支付；微信手续费较高，优先用支付宝。

充值页还会显示“我的订阅”、扣费优先级下拉框和邀请奖励。扣费优先级会影响先扣钱包还是先扣订阅额度，购买后按自己的使用习惯确认一次。邀请好友注册并充值后，可通过划转功能把奖励额度转入账户余额。

第四步：创建 API Key

打开令牌管理页面，点击“添加令牌”。

命名格式使用 用途-环境-负责人，例如：

用途	名称示例
Codex 编程	`codex-prod-alice`
本机测试	`local-test-alice`
图片调用	`image-prod-service`
生产服务端	`backend-prod-api`

创建后在“密钥”列点击复制图标，把 API Key 保存到密码管理器或安全的环境变量中，不要写入公开仓库。

要导入已有客户端时，在令牌行右侧点击“聊天”旁边的下拉扩展，再选择 Cherry Studio、AionUI、流畅阅读、CC Switch、Lobe Chat 官方示例、AI as Workspace、AMA 问天或 OpenCat。

第五步：配置 CLI 工具

先配置 Codex：

配置 Codex：Base URL 填 https://api.avemujica.moe/v1，并设置 wire_api = "responses"。Codex App 按同一页写好 .codex 配置文件后再打开。
其它支持 OpenAI-compatible provider 的工具可阅读 CLI 手动配置。
CC-Switch 配置见 CC-Switch。
配置失败时按 FAQ 对照错误码和环境变量排查。

直接配置 Codex（macOS / Linux）

复制运行后，按提示粘贴 AveMujicaAPI API Key。脚本会安装 Codex CLI，备份已有 .codex/config.toml 和 .codex/auth.json，再写入 AveMujicaAPI provider。

bash

read -r -s -p "AveMujicaAPI API Key: " AVEMUJICA_API_KEY
echo
read -r -p "Model ID [gpt-5.5]: " AVEMUJICA_MODEL
AVEMUJICA_MODEL="${AVEMUJICA_MODEL:-gpt-5.5}"

if [ -z "$AVEMUJICA_API_KEY" ]; then
  echo "API Key is required."
  exit 1
fi

npm install -g @openai/codex
mkdir -p "$HOME/.codex"

stamp="$(date +%Y%m%d%H%M%S)"
[ -f "$HOME/.codex/config.toml" ] && cp "$HOME/.codex/config.toml" "$HOME/.codex/config.toml.bak.$stamp"
[ -f "$HOME/.codex/auth.json" ] && cp "$HOME/.codex/auth.json" "$HOME/.codex/auth.json.bak.$stamp"

cat > "$HOME/.codex/config.toml" <<EOF
model_provider = "avemujicaapi"
model = "$AVEMUJICA_MODEL"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.avemujicaapi]
name = "AveMujicaAPI"
base_url = "https://api.avemujica.moe/v1"
requires_openai_auth = true
stream_idle_timeout_ms = 600000
wire_api = "responses"
EOF

cat > "$HOME/.codex/auth.json" <<EOF
{
  "OPENAI_API_KEY": "$AVEMUJICA_API_KEY"
}
EOF

codex --version

Windows PowerShell 脚本见 Codex 配置。

最小验收

能登录控制台并看到余额。
至少创建一个 AveMujicaAPI API Key。
使用 Codex CLI、Codex App 或 OpenAI-compatible 客户端发起一次最小请求并得到模型回复。
保留配置文件备份，避免后续工具覆盖。

快速开始 ​

先走这条线 ​

第一步：注册账号 ​

第二步：登录账号 ​

第三步：购买额度 ​

第四步：创建 API Key ​

第五步：配置 CLI 工具 ​

直接配置 Codex（macOS / Linux） ​

最小验收 ​