mcpField
M
muapi-chat-agents

muapi-chat-agents

github.com/samuraigptAgent 工作流865 次安装4 周前更新
代码仓库

关于 muapi-chat-agents

这是一份配置指南，说明如何通过原生 Anthropic Messages 和 OpenAI Responses 协议，让 Claude Code 与 Codex CLI 使用 Muapi。内容涵盖端点配置、模型查询、认证和故障排查。

主要功能

  1. 01配置 Claude Code 和 Codex CLI
  2. 02使用原生 Agent 协议
  3. 03通过端点查询模型
  4. 04使用 Muapi API 密钥认证
  5. 05排查常见配置错误

适用场景

  1. 01将 Claude Code 连接到 Muapi
  2. 02将 Muapi 配置为 Codex CLI 提供方
  3. 03核对模型 ID 并诊断错误

MCP 相关

项目未说明 MCP 支持；它配置 Claude Code 和 Codex CLI，通过 Anthropic Messages 与 OpenAI Responses 端点连接 Muapi。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/samuraigpt/muapi-skills --skill muapi-chat-agents

安装后在 Claude Code 中输入/muapi-chat-agents确认已加载。

详细介绍

Muapi 聊天 Agent

Muapi 原生支持编码 Agent，无需翻译代理：

Agent协议基础 URL模型端点
Claude CodeAnthropic Messageshttps://api.muapi.ai/anthropicGET /anthropic/v1/models
Codex CLIOpenAI Responseshttps://api.muapi.ai/openai/v1GET /openai/v1/models

用量按 Muapi API 中相同的单模型价格从用户的 Muapi 额度中扣除。身份验证始终使用用户的 Muapi API 密钥，从 MUAPI_API_KEY 读取（切勿粘贴或提交）。

规则

  • 不要在基础 URL 中填写完整的请求 URL。Agent 会自行附加 /v1/messages 或 /responses。
  • 始终从模型端点读取模型 ID。切勿依赖记忆中的列表。
  • 将提供商设置放在用户级配置中，切勿放入项目文件。
  • 使用 Authorization: Bearer <key>（Claude Code 的 ANTHROPIC_AUTH_TOKEN 会这样处理）或 x-api-key 进行身份验证。
  • 请求运行前会先检查钱包余额，因此余额必须足以支付最坏情况下的请求费用（大型模型处理较长提示词并使用完整输出上限时，可能会占用 1 美元或更多；未使用的部分会退还）。

设置

  1. export MUAPI_API_KEY=your_key（PowerShell：$env:MUAPI_API_KEY = "your_key" 和 setx MUAPI_API_KEY "your_key"）。
  2. 列出模型： 
    curl -s -H "Authorization: Bearer $MUAPI_API_KEY" https://api.muapi.ai/anthropic/v1/models
curl -s -H "Authorization: Bearer $MUAPI_API_KEY" https://api.muapi.ai/openai/v1/models
    （Windows PowerShell：使用 curl.exe。）
Claude Code

添加到 ~/.claude/settings.json（或 .claude/settings.local.json，切勿添加到已提交的项目文件）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.muapi.ai/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<your Muapi API key>",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

或者，在启动 claude 之前，于 shell 中导出 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN="$MUAPI_API_KEY"。 settings.json 中的 env 值是字面值，因此建议使用 shell 导出，以免将密钥写入文件。 在 Claude Code 中运行 /status，确认基础 URL；运行 claude --debug，查看请求。

Claude Code 中的无审查（消融）模型

GET /anthropic/v1/models 也会列出支持工具调用的消融模型。使用相同的基础 URL 和密钥，通过 claude --model <id> 选择一个模型，并将 ANTHROPIC_DEFAULT_HAIKU_MODEL 和 ANTHROPIC_SMALL_FAST_MODEL 设为相同的 ID（否则 Claude Code 的后台请求会返回 404）。请提醒用户：模型质量各有不同（较小的模型在多文件任务中可能会跳过步骤）；不支持提示词缓存，因此每轮都会对整个对话重新计费；每次响应的输出上限为 16,384 个 token。Codex CLI 也能通过 /openai/v1 使用这些模型（将 model 设为对应 ID）；此路径已通过真实的 Codex CLI 会话测试（使用 qwen、mimo 和 glm 进行文件写入、shell 及 apply_patch 工具调用），但模型质量各有不同。

Codex CLI

~/.codex/config.toml：

model = "gpt-5-6-sol"
model_provider = "muapi"

[model_providers.muapi]
name = "Muapi"
base_url = "https://api.muapi.ai/openai/v1"
env_key = "MUAPI_API_KEY"
wire_api = "responses"

env_key 指定存放密钥的变量名，而不是密钥本身。请将 model 显式设为模型端点中的一个 ID。提供商 ID openai、ollama 和 lmstudio 已被保留，因此请使用 muapi。 运行 codex doctor 进行验证。可选：model_reasoning_effort = "high"。

故障排除

问题解决方法
401请求头必须为 Authorization: Bearer <key> 或 x-api-key。请在 https://muapi.ai/dashboard 检查密钥
402 / 额度不足余额不足以支付该请求的最坏情况费用；请充值或降低输出上限
404 找不到模型使用模型端点中的 ID
错误中出现 /v1/v1/messages从基础 URL 中移除路径后缀
Claude Code 要求登录 Anthropic退出终端，导出变量，重新打开终端，然后从该 shell 启动 claude
Codex 忽略提供商将设置移至 ~/.codex/config.toml（用户级配置）
5xx / 提供商错误重试；代理已自动重试一次备用路由

评论

支持 Markdown