快速开始

完成以下步骤后，即可使用 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

注册页需要填写用户名、密码、确认密码、邮箱和邮箱验证码。当前注册流程使用邮箱验证码；第三方登录入口暂未提供。

第二步：登录账号

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

登录页使用用户名或邮箱加密码登录，按钮文案是 继续。页面会加载 Cloudflare 人机验证；验证完成后再提交。新设备、新浏览器或清理 Cookie 后需要重新登录。

第三步：购买额度

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

建议优先查看“订阅套餐”。按天或按周集中使用时，订阅卡通常比直接额度充值更划算；临时补少量额度时，再切到“额度充值”。直接充值时，1 元 可获得 $1 钱包额度。

订阅卡片会展示套餐名、价格、有效期、总额度、购买限制和 立即订阅 按钮。充值页套餐示例包括 ¥70 / $105 的周卡、¥30 / $45 的 3 天卡和 ¥10 / $15 的天卡；实际价格和额度以控制台显示为准。

额度充值页支持支付宝和微信支付，并提供 $10、$20、$50、$100、$200、$500 等额度卡片。直接充值时，例如充值 ¥10 会获得 $10 钱包额度；最终金额以页面和收银台显示为准。

充值页还会显示“我的订阅”、扣费优先级下拉框和兑换码充值。订阅通常适合短期集中用量，直充适合临时补少量余额。

第四步：创建 API Key

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

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

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

创建后在“密钥”列点击复制图标，将 API Key 保存到密码管理器或安全的环境变量中。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。脚本外层会调用 bash，因此 macOS 默认 zsh 也可以直接粘贴运行。脚本会安装 Codex CLI，备份已有 .codex/config.toml 和 .codex/auth.json，再写入 AveMujicaAPI provider。

bash

bash <<'AVEMUJICA_CODEX_SETUP'
set -e

if [ ! -r /dev/tty ]; then
  echo "This setup needs an interactive terminal."
  exit 1
fi

printf "AveMujicaAPI API Key: " > /dev/tty
IFS= read -r -s AVEMUJICA_API_KEY < /dev/tty
printf "\n" > /dev/tty

printf "Model ID [gpt-5.5]: " > /dev/tty
IFS= read -r AVEMUJICA_MODEL < /dev/tty
AVEMUJICA_MODEL="${AVEMUJICA_MODEL:-gpt-5.5}"

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

case "$AVEMUJICA_MODEL" in
  *\"*|*\\*)
    echo "Model ID contains unsupported characters."
    exit 1
    ;;
esac

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

AVEMUJICA_API_KEY="$AVEMUJICA_API_KEY" node <<'EOF' > "$HOME/.codex/auth.json"
const key = process.env.AVEMUJICA_API_KEY;
process.stdout.write(JSON.stringify({ OPENAI_API_KEY: key }, null, 2) + "\n");
EOF
chmod 600 "$HOME/.codex/auth.json"
unset AVEMUJICA_API_KEY

codex --version
AVEMUJICA_CODEX_SETUP

Windows PowerShell 脚本见 Codex 配置。

最小验收

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

快速开始 ​

配置路径 ​

第一步：注册账号 ​

第二步：登录账号 ​

第三步：购买额度 ​

第四步：创建 API Key ​

第五步：配置 CLI 工具 ​

直接配置 Codex（macOS / Linux） ​

最小验收 ​