SuperAPI AI 工具集

muapi-chat-agents

部署与运维

查看项目

更新于 10-16 03:50

技能介绍

用途

muapi-chat-agents 用于在 Muapi(api.muapi.ai)上运行 Claude Code 或 Codex CLI,使用 Muapi 积分结算,而无需单独注册供应商账户。Muapi 原生托管编程智能体,因此不需要额外的转换代理。适用于希望让本地编程智能体通过 Muapi 统一计费与认证的场景。

支持的智能体与协议

  • Claude Code:Anthropic Messages 协议,基础地址 https://api.muapi.ai/anthropic,模型端点 GET /anthropic/v1/models。
  • Codex CLI:OpenAI Responses 协议,基础地址 https://api.muapi.ai/openai/v1,模型端点 GET /openai/v1/models。

使用量按用户 Muapi 积分计费,价格与 Muapi API 的按模型定价相同。认证始终使用用户的 Muapi API 密钥,从 MUAPI_API_KEY 读取(切勿粘贴或提交该密钥)。

主要规则

  • 不要把完整请求 URL 放入基础地址,智能体会自行追加 /v1/messages 或 /responses。
  • 始终从模型端点读取模型 ID,不要依赖记忆中的列表。
  • 供应商设置应放在用户级配置中,绝不放在项目文件里。
  • 使用 Authorization: Bearer <key>(Claude Code 的 ANTHROPIC_AUTH_TOKEN 即为此方式)或 x-api-key 进行认证。
  • 请求运行前会先检查钱包,因此余额必须能覆盖最坏情况(大模型上的大提示加上完整输出上限可能占用一美元以上;未使用部分会返还)。

设置

  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 确认基础地址,用 claude --debug 查看请求。

在 Claude Code 中使用无审查(abliterated)模型

GET /anthropic/v1/models 也会列出支持工具调用的 abliterated 模型。使用相同的基础地址和密钥,用 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 / insufficient credit 余额无法覆盖该请求的最坏情况;充值,或降低输出上限
404 model not found 使用模型端点返回的 ID
错误中出现 /v1/v1/messages 从基础地址中移除路径后缀
Claude Code 要求登录 Anthropic 退出终端,导出变量,重新打开,并从该 shell 启动 claude
Codex 忽略该 provider 将设置移至 ~/.codex/config.toml(用户级)
5xx / provider error 重试;代理已对备份路由重试一次

适用场景与限制

适用于希望通过 Muapi 统一积分和认证来运行本地编程智能体(Claude Code、Codex CLI)的开发者。限制方面:无审查模型的输出质量因模型而异,且没有提示缓存会重复计费;每次响应输出上限为 16,384 个 token;请求前需保证余额足以覆盖最坏情况。其他定价、平台支持或效果信息暂未提供。