Codex 配置

Codex 使用 OpenAI Responses API。把 Base URL 填为 https://api.avemujica.moe/v1，并在 config.toml 中设置 wire_api = "responses"。

下面的配置是精简版，只保留 AveMujicaAPI 连接所需字段。不要把本机已有的 notify、mcp_servers、plugins、marketplaces、projects、shell_environment_policy 或 oh-my-codex 相关配置复制给新用户。

准备

• 已安装 Codex CLI，或准备安装 Codex App。
• 已打开 令牌管理 页面并点击“添加令牌”，创建 AveMujicaAPI API Key。
• 已确认控制台展示的 GPT/Codex 模型 ID，且该模型支持 OpenAI Responses API。

Codex 官方入口：

• Codex 产品与 App
• Codex App 文档
• Codex CLI 文档
• Codex CLI 仓库

复制运行：macOS / Linux

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

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

在 PowerShell 中运行。脚本会安装 Codex CLI，备份已有 .codex\config.toml 和 .codex\auth.json，再写入 AveMujicaAPI provider。

$SecureKey = Read-Host "AveMujicaAPI API Key" -AsSecureString
$Bstr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($SecureKey)
$ApiKey = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($Bstr)
[Runtime.InteropServices.Marshal]::ZeroFreeBSTR($Bstr)

$Model = Read-Host "Model ID [gpt-5.5]"
if ([string]::IsNullOrWhiteSpace($Model)) {
  $Model = "gpt-5.5"
}

if ([string]::IsNullOrWhiteSpace($ApiKey)) {
  throw "API Key is required."
}

npm install -g @openai/codex

$CodexDir = Join-Path $env:USERPROFILE ".codex"
New-Item -ItemType Directory -Force -Path $CodexDir | Out-Null

$Stamp = Get-Date -Format "yyyyMMddHHmmss"
$ConfigPath = Join-Path $CodexDir "config.toml"
$AuthPath = Join-Path $CodexDir "auth.json"

if (Test-Path $ConfigPath) {
  Copy-Item $ConfigPath "$ConfigPath.bak.$Stamp"
}
if (Test-Path $AuthPath) {
  Copy-Item $AuthPath "$AuthPath.bak.$Stamp"
}

@"
model_provider = "avemujicaapi"
model = "$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"
"@ | Set-Content -Encoding UTF8 $ConfigPath

@{ OPENAI_API_KEY = $ApiKey } | ConvertTo-Json | Set-Content -Encoding UTF8 $AuthPath

codex --version

配置路径

Windows：

%userprofile%\.codex

macOS / Linux：

~/.codex

config.toml 示例

model_provider = "avemujicaapi"
model = "gpt-5.5"
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"

auth.json 示例

{
  "OPENAI_API_KEY": "<YOUR_AVEMUJICA_API_KEY>"
}

Codex App

Codex App 使用同一套本机 Codex 配置。先运行上面的脚本，或手动在 .codex 目录写好 config.toml 和 auth.json，再安装并打开 Codex App。

启动 Codex App 后，新建会话即可使用 AveMujicaAPI provider。

配置顺序：

1. 创建 .codex/config.toml，填入 model_provider = "avemujicaapi"。
2. 创建 .codex/auth.json，填入 AveMujicaAPI API Key。
3. 安装并打开 Codex App。
4. 新建会话，发送一句最小请求验证。

协议设置

保留 wire_api = "responses"。Codex 会按 OpenAI Responses API 请求 AveMujicaAPI。

可选工具

• Skills
• oh-my-codex
• oh-my-claudecode

启动验证

codex

Codex CLI 进入交互后发送一个最小请求，例如“用一句话介绍当前项目”。Codex App 则在打开后新建会话，发送同样的最小请求。

排查顺序

1. config.toml 中 provider 名称是否一致。
2. base_url 是否为 https://api.avemujica.moe/v1。
3. auth.json 是否在正确目录。
4. Codex App 中的 provider、Base URL、API Key 和模型 ID 是否与 .codex 文件一致。
5. 系统环境变量 OPENAI_API_KEY、OPENAI_BASE_URL 是否覆盖。
6. 当前模型 ID 是否为控制台展示的 GPT/Codex 模型。