MXALPHA
// DOCS

接入文档

MXAlpha 同时兼容 OpenAI 与 Anthropic 接口。无论用 CLI 工具、桌面客户端，还是写代码， 只需把服务地址指向 MXAlpha、填入你的密钥即可。

// 通用参数
OpenAI 地址：https://www.mxalpha.ai/v1
Anthropic 地址：https://www.mxalpha.ai
密钥：sk-mxa-…（控制台新建）

Claude Code

Claude Code 走 Anthropic 接口，设置环境变量后直接用，模型可走旗舰档官方通道，适合生产编码：

terminal
# Claude Code（Anthropic 官方 CLI）
export ANTHROPIC_BASE_URL=https://www.mxalpha.ai
export ANTHROPIC_AUTH_TOKEN=sk-mxa-你的密钥

# 之后正常启动即可
claude

Codex

OpenAI 官方 CLI（及其它 OpenAI 兼容 CLI）：

terminal
# Codex / OpenAI 兼容 CLI
export OPENAI_BASE_URL=https://www.mxalpha.ai/v1
export OPENAI_API_KEY=sk-mxa-你的密钥

codex

Gemini / 其它 CLI

支持 OpenAI 兼容模式的 CLI 同理设置 base_url 与 key 即可：

terminal
# Gemini CLI（OpenAI 兼容模式）
export OPENAI_BASE_URL=https://www.mxalpha.ai/v1
export OPENAI_API_KEY=sk-mxa-你的密钥
# 模型填 gemini-3.5-flash 等

桌面 / 网页客户端

凡支持「自定义 OpenAI 接口」的客户端，在其设置里填 Base URL = https://www.mxalpha.ai/v1、API Key = sk-mxa-…，模型名手动填（见 模型列表）：

Cherry Studio设置 → 模型服务 → 添加（OpenAI）→ 填 API 地址与密钥
ChatBox设置 → 模型 → OpenAI API → 自定义 API Host
NextChat / LobeChat设置 → 自定义 OpenAI 接口地址 + 密钥
CursorSettings → Models → Override OpenAI Base URL
OpenWebUI设置 → 连接 → OpenAI API → 填 Base URL 与 Key

代码调用

Python（OpenAI SDK，Node.js 同理改 baseURL）：

quickstart.py
from openai import OpenAI

client = OpenAI(
    api_key="sk-mxa-你的密钥",
    base_url="https://www.mxalpha.ai/v1",
)
resp = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
curl
curl https://www.mxalpha.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-mxa-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-6","messages":[{"role":"user","content":"你好"}]}'

错误码

401API key 无效或缺失 → 检查密钥
402余额不足 → 控制台充值
429触发限流 → 降频或联系提额
502 / 503上游暂不可用 → 稍后重试，会自动切换通道

更多

计费与退款见 FAQ；模型清单见 支持模型；企业/大额采购联系 business@mxalpha.ai。