1
下载安装 Codexy Next下载最新版安装包并完成安装；同一产品的旧版本会由安装程序自动替换。
2
登录 Codexy 账户在 App 中输入注册邮箱和密码，进入账户首页。
3
点击「一键接入」App 自动完成专用凭据和 Codex 配置，无需复制或粘贴 API Key。完成后重启 Codex，模型直接在 Codex 内选择。

一键接入不会覆盖你的原配置：App 会先自动备份 ~/.codex/config.toml，需要时可点击「恢复」恢复 OpenAI Provider。

下载 Windows 客户端下载 macOS Apple Silicon 下载 macOS Intel

手动

方式二：手动配置 Codex Desktop

已安装 Codex Desktop，或希望自行管理配置文件时使用。

Windows PowerShell

PowerShell

New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "codexy"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.codexy]
name = "Codexy"
base_url = "https://codexy.me/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8

macOS / Linux

Terminal

mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "codexy"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.codexy]
name = "Codexy"
base_url = "https://codexy.me/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF

设置 API Key

Windows

PowerShell

[Environment]::SetEnvironmentVariable(
  "OPENAI_API_KEY",
  "sk-relay-your-key",
  "User"
)

macOS / Linux

Terminal

echo 'export OPENAI_API_KEY="sk-relay-your-key"' >> ~/.zshrc
source ~/.zshrc

完成后请彻底退出 Codex Desktop 再重新打开，使新的环境变量和配置生效。

TERMINAL

连接 Codex CLI

先安装 OpenAI Codex CLI，再把模型提供商指向 Codexy。已经安装的用户可直接从第 2 步开始。

安装 Codex CLI

需要 Node.js 22 或更高版本。

Terminal / PowerShell

node --version
npm install -g @openai/codex
codex --version

配置 Codexy Provider

将下面内容保存为 ~/.codex/config.toml；Windows 对应 $HOME\.codex\config.toml。

config.toml

model_provider = "codexy"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"

[model_providers.codexy]
name = "Codexy"
base_url = "https://codexy.me/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

设置密钥并启动

将占位内容替换为控制台生成的真实 API Key。

Windows PowerShell

PowerShell

$env:OPENAI_API_KEY="sk-relay-your-key"
codex

macOS / Linux

Terminal

export OPENAI_API_KEY="sk-relay-your-key"
codex

验证成功Codex 启动后输入一条简单任务。如果控制台「用量账单」出现新的请求记录，说明接入完成。查看用量 →

CLAUDE DESKTOP

连接 Claude Desktop

推荐在 Codexy Next 的「Claude Desktop」卡片一键接入；也可以手动写入 Claude Desktop 网关配置。

方式一：Codexy Next 一键接入

1
登录 Codexy Next使用 Codexy 邮箱和密码登录，找到「Claude Desktop」卡片。
2
点击「一键接入」App 备份并更新 Claude Desktop 配置。
3
在 Desktop 内选择模型Codexy Next 会自动重启 Claude Desktop；打开后在 Desktop 内选择可用的 Claude 模型。

需要恢复时，在 Claude Desktop 卡片点击「恢复」，App 会自动重启 Desktop。

手动

方式二：手动配置 Claude Desktop

不安装 Codexy Next 时使用。脚本会先备份配置索引，再写入 Codexy 网关配置。

1
创建 API Key在控制台「API Key」页面创建 Key，替换脚本中的 sk-relay-your-key。
2
彻底退出 Claude Desktop从托盘或菜单栏退出，而不只是关闭窗口。
3
运行对应系统的脚本模型 ID 以账户可用目录为准，不可用的模型请删除对应一项。
4
重新打开 Claude Desktop在模型选择中选用 Codexy 提供的 Claude 模型。

Windows PowerShell

PowerShell

$key = "sk-relay-your-key"
$lib = "$env:LOCALAPPDATA\Claude-3p\configLibrary"
New-Item -ItemType Directory -Force -Path $lib | Out-Null
if (Test-Path "$lib\_meta.json") { Copy-Item "$lib\_meta.json" "$lib\_meta.json.codexy-backup" -Force }
$id = [guid]::NewGuid().ToString()
$models = @(
  @{ name = "claude-sonnet-5-5"; labelOverride = "claude-sonnet-5-5"; anthropicFamilyTier = "sonnet"; isFamilyDefault = $true },
  @{ name = "claude-opus-5-5"; labelOverride = "claude-opus-5-5"; anthropicFamilyTier = "opus"; isFamilyDefault = $true },
  @{ name = "claude-haiku-5-5"; labelOverride = "claude-haiku-5-5"; anthropicFamilyTier = "haiku"; isFamilyDefault = $true }
)
$config = @{
  inferenceProvider = "gateway"; inferenceCredentialKind = "static"
  inferenceGatewayBaseUrl = "https://codexy.me"; inferenceGatewayApiKey = $key
  inferenceGatewayAuthScheme = "bearer"; modelDiscoveryEnabled = $false
  inferenceModels = $models; inferenceCustomHeaders = @{ "X-Codexy-Client" = "claude-desktop" }
}
$meta = @{ appliedId = $id; entries = @(@{ id = $id; name = "Codexy" }) }
# UTF-8 without BOM
[IO.File]::WriteAllText("$lib\$id.json", ($config | ConvertTo-Json -Depth 5))
[IO.File]::WriteAllText("$lib\_meta.json", ($meta | ConvertTo-Json -Depth 5))
Write-Host "Codexy profile: $lib\$id.json"

macOS

Terminal

KEY="sk-relay-your-key"
LIB="$HOME/Library/Application Support/Claude-3p/configLibrary"
ID="$(uuidgen | tr 'A-Z' 'a-z')"
mkdir -p "$LIB"
[ -f "$LIB/_meta.json" ] && cp "$LIB/_meta.json" "$LIB/_meta.json.codexy-backup"
cat > "$LIB/$ID.json" <<EOF
{
  "inferenceProvider": "gateway",
  "inferenceCredentialKind": "static",
  "inferenceGatewayBaseUrl": "https://codexy.me",
  "inferenceGatewayApiKey": "$KEY",
  "inferenceGatewayAuthScheme": "bearer",
  "modelDiscoveryEnabled": false,
  "inferenceModels": [
    {"name": "claude-sonnet-5-5", "labelOverride": "claude-sonnet-5-5", "anthropicFamilyTier": "sonnet", "isFamilyDefault": true},
    {"name": "claude-opus-5-5", "labelOverride": "claude-opus-5-5", "anthropicFamilyTier": "opus", "isFamilyDefault": true},
    {"name": "claude-haiku-5-5", "labelOverride": "claude-haiku-5-5", "anthropicFamilyTier": "haiku", "isFamilyDefault": true}
  ],
  "inferenceCustomHeaders": {"X-Codexy-Client": "claude-desktop"}
}
EOF
printf '{"appliedId": "%s", "entries": [{"id": "%s", "name": "Codexy"}]}\n' "$ID" "$ID" > "$LIB/_meta.json"
chmod 600 "$LIB/$ID.json"
echo "Codexy profile: $LIB/$ID.json"

写入后配置索引只保留 Codexy，原有的其他第三方配置文件仍在磁盘上，恢复备份即可找回。若 Claude Desktop 已由公司策略管理（Windows 的 HKLM 策略或 macOS 配置描述文件），以策略为准，请改用 Claude Code CLI。

恢复官方配置

退出 Claude Desktop 后运行下方命令，再删除配置脚本输出的 Codexy 配置文件。

Windows

PowerShell

$lib = "$env:LOCALAPPDATA\Claude-3p\configLibrary"
if (Test-Path "$lib\_meta.json.codexy-backup") { Move-Item -Force "$lib\_meta.json.codexy-backup" "$lib\_meta.json" } else { Remove-Item "$lib\_meta.json" }

macOS

Terminal

LIB="$HOME/Library/Application Support/Claude-3p/configLibrary"
if [ -f "$LIB/_meta.json.codexy-backup" ]; then mv "$LIB/_meta.json.codexy-backup" "$LIB/_meta.json"; else rm "$LIB/_meta.json"; fi

如果之前用 Codexy Next 接入过，请先在 App 中点击「恢复」，避免两种配置冲突。

下载 Codexy Next 查看用量账单

CLAUDE CODE CLI

连接 Claude Code CLI

推荐在 Codexy Next 的「Claude Code CLI」卡片一键接入；也可以手动配置。

Codexy Next 一键接入

登录后点击「Claude Code CLI → 一键接入」，重新打开终端运行 claude。App 备份并更新 ~/.claude/settings.json；恢复时点击同一卡片的「恢复」。

手动

不使用 App：手动配置

在控制台创建 API Key，替换下方的 sk-relay-your-key。模型 ID 以账户可用目录为准；只有一个模型时，所有模型字段都填同一 ID。

1. 安装 Claude Code

Terminal / PowerShell

npm install -g @anthropic-ai/claude-code
claude --version

2. 长期使用：写入 ~/.claude/settings.json

先备份原文件；已有内容时只合并 model 和 env 字段，不要整份覆盖。Windows 上是用户目录下 .claude 文件夹中的 settings.json。

~/.claude/settings.json

{
  "model": "claude-sonnet-5-5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://codexy.me",
    "ANTHROPIC_AUTH_TOKEN": "sk-relay-your-key",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-5-5",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "0"
  }
}

settings.json 中如有 apiKeyHelper，或之前登录过 Claude 订阅，请删除 apiKeyHelper 并在 claude 中执行一次 /logout，确保使用 Codexy Key。

3. 仅当前终端临时使用

Windows

PowerShell

$env:ANTHROPIC_BASE_URL = "https://codexy.me"
$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-your-key"
$env:ANTHROPIC_MODEL = "claude-sonnet-5-5"
claude

macOS / Linux

Terminal

export ANTHROPIC_BASE_URL="https://codexy.me"
export ANTHROPIC_AUTH_TOKEN="sk-relay-your-key"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
claude

恢复官方配置：用备份还原 settings.json（或删除上述字段），再重新打开终端。

验证接入在新终端运行 claude，用 /status 检查连接。查看用量 →

CLAUDE API

Claude Messages 与 SDK

共用 Codexy API Key 和钱包。Anthropic SDK 的基础地址为 https://codexy.me。

原生 Messages API

请求发送至 POST https://codexy.me/v1/messages。支持 x-api-key 或 Authorization: Bearer 鉴权；两者同时提供时应为同一把 Codexy Key。

cURL

curl https://codexy.me/v1/messages \
  -H "x-api-key: sk-relay-your-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":512,"messages":[{"role":"user","content":"Hello"}]}'

添加 stream: true 可接收 Anthropic SSE 事件。工具调用使用 tools、tool_use 和 tool_result；续接时保留完整 Messages 历史，并回传相同 tool_use_id。

Anthropic Python SDK

SDK 基础地址填写 https://codexy.me，SDK 会自动追加 /v1/messages。填写根地址可避免重复 /v1。

Python

# pip install anthropic
from anthropic import Anthropic

client = Anthropic(
    api_key="sk-relay-your-key",
    base_url="https://codexy.me",
)
with client.messages.stream(
    model="claude-sonnet-5-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Hello"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
    message = stream.get_final_message()
print("\nUsage:", message.usage)

原生 Messages 支持客户端工具、图片和文档输入。OpenAI 兼容的 Claude Responses 与 Chat 接口用于文本对话；Claude Code 和原生工具调用请选择 Messages。

模型目录查看用量账单管理 API Keys

DEVELOPERS

API 与 OpenAI SDK

Codexy 兼容 OpenAI Responses 与 Chat Completions 接口。Base URL 固定为 https://codexy.me/v1。

Python

OpenAI SDK

安装官方 SDK 后替换 API Key 即可。

example.py

from openai import OpenAI

client = OpenAI(
    api_key="sk-relay-your-key",
    base_url="https://codexy.me/v1",
)

response = client.responses.create(
    model="gpt-5.6-sol",
    input="Confirm in one sentence that the API is connected.",
)
print(response.output_text)

cURL

Responses API

适合快速检查密钥、网络和模型是否可用。

Terminal

curl https://codexy.me/v1/responses \
  -H "Authorization: Bearer sk-relay-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.6-sol","input":"Hello"}'

Video

对话内自动生成视频

Astra、Sol、Terra、Luna 等模型均可将明确的视频生成需求调度至 MiniMax。

Terminal

curl https://codexy.me/v1/responses \
  -H "Authorization: Bearer sk-relay-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-6-astra","input":"帮我生成一段 6 秒 768p 的城市夜景视频"}'

返回结果包含视频任务 ID、查询地址和内容地址。普通问答、教程和 API 说明不会误触发生成。

Base URLhttps://codexy.me/v1

认证方式Authorization: Bearer API_KEY

推荐接口POST /v1/responses

SUPPORT

常见问题与排查

按顺序检查密钥、配置文件、环境变量和客户端进程，通常可以快速定位问题。

提示 401 或 API Key 无效

确认密钥以 sk-relay- 开头、没有多余空格，并且未过期或被吊销。完整密钥只在创建时显示一次。

修改配置后没有生效

彻底退出 Codex Desktop 或关闭当前终端，再重新打开。Windows 永久环境变量不会自动进入已经运行的进程。

Codex 仍然要求登录 OpenAI

检查 model_provider = "codexy"、wire_api = "responses" 和配置文件路径是否正确，然后重新启动客户端。

请求超时或没有模型

先检查服务状态与模型目录。模型目录可能随上游账号能力动态变化。

检查服务状态查看用量账单管理 API Keys

找回密码

设置新密码

限时充值优惠

专用账号额度

充值订单

资金变动

注销账户

把低成本 Codex API 分享给好友

达标邀请金 + 长期返利

新用户首充福利

四步获得并提现邀请金

邀请记录

提交提现申请

提现记录

连接 Codex Desktop

方式一：Codexy Next 一键接入

方式二：手动配置 Codex Desktop

Windows PowerShell

macOS / Linux

设置 API Key

连接 Codex CLI

安装 Codex CLI

配置 Codexy Provider

设置密钥并启动

连接 Claude Desktop

方式一：Codexy Next 一键接入

方式二：手动配置 Claude Desktop

Windows PowerShell

macOS

恢复官方配置

连接 Claude Code CLI

Codexy Next 一键接入

不使用 App：手动配置

1. 安装 Claude Code

2. 长期使用：写入 ~/.claude/settings.json

3. 仅当前终端临时使用

Claude Messages 与 SDK

原生 Messages API

Anthropic Python SDK

API 与 OpenAI SDK

OpenAI SDK

Responses API

对话内自动生成视频

常见问题与排查