集成¶

Macaron 托管模型 API 兼容 OpenAI，任何支持 /v1/chat/completions 的客户端均可使用。本页覆盖 dashboard 暴露的六种集成方式，每种附带可直接复制的片段。替换占位符：

<MACARON_API_KEY> — 你的 dashboard API key（见鉴权）
<BASE_URL> — https://mint.macaron.im（中国大陆以外）或 https://mintcn.macaron.xin（中国大陆）
<MODEL> — 模型中的模型 ID，例如 macaron-v1-venti

dashboard「开始使用 MinT」面板——六种集成方式（curl、CLI、Claude、Codex、OpenCode、cc-switch），base URL 与 API key 已预填。

curl¶

curl <BASE_URL>/v1/chat/completions \
  -H "Authorization: Bearer <MACARON_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL>",
    "messages": [
      {"role": "user", "content": "Why is the sky blue?"}
    ],
    "stream": true,
    "max_completion_tokens": 1024
  }'

MinT SDK（训练）¶

针对托管端点的训练与 RL 循环，安装 MinT toolkit 并指向托管 API：

pip install git+https://github.com/MindLab-Research/mindlab-toolkit.git
export MINT_API_KEY=<MACARON_API_KEY>
export MINT_BASE_URL=<BASE_URL>

Claude Code¶

Claude Code 从环境变量读取端点与模型。启动 claude 前设置它们。

macOS / Linux / WSL：

# 安装 Claude Code（已安装则跳过）
curl -fsSL https://claude.ai/install.sh | bash

# 配置 Macaron
export ANTHROPIC_BASE_URL="<BASE_URL>"
export ANTHROPIC_AUTH_TOKEN="<MACARON_API_KEY>"
export ANTHROPIC_MODEL="<MODEL>"
export CLAUDE_CODE_SUBAGENT_MODEL="<MODEL>"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="<MODEL>"
export ANTHROPIC_DEFAULT_SONNET_MODEL="<MODEL>"
export ANTHROPIC_DEFAULT_OPUS_MODEL="<MODEL>"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
export _CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL="1"
export CLAUDE_CODE_USE_POWERSHELL_TOOL="true"
export IS_SANDBOX="1"
export CLAUDE_CODE_ATTRIBUTION_HEADER="0"
export CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS="1"

# 启动
claude

Windows PowerShell：

# 安装 Claude Code
irm https://claude.ai/install.ps1 | iex

# 配置 Macaron
$env:ANTHROPIC_BASE_URL="<BASE_URL>"
$env:ANTHROPIC_AUTH_TOKEN="<MACARON_API_KEY>"
$env:ANTHROPIC_MODEL="<MODEL>"
$env:CLAUDE_CODE_SUBAGENT_MODEL="<MODEL>"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="<MODEL>"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="<MODEL>"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="<MODEL>"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"
$env:_CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL="1"
$env:CLAUDE_CODE_USE_POWERSHELL_TOOL="true"
$env:IS_SANDBOX="1"
$env:CLAUDE_CODE_ATTRIBUTION_HEADER="0"
$env:CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS="1"

# 启动
claude

Note

Shell 环境变量优先级高于 ~/.claude/settings.json。若 rc 文件中有旧 ANTHROPIC_* 值，会覆盖上述配置导致不生效。先检测：

grep -nE 'ANTHROPIC_|CLAUDE_CODE_SUBAGENT_MODEL' ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile 2>/dev/null

注释掉匹配行，然后 source 该文件或重开终端。

或者，将键合并进 ~/.claude/settings.json 的 env 块（保留原有配置）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "<BASE_URL>",
    "ANTHROPIC_AUTH_TOKEN": "<MACARON_API_KEY>",
    "ANTHROPIC_MODEL": "<MODEL>",
    "CLAUDE_CODE_SUBAGENT_MODEL": "<MODEL>",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "_CLAUDE_CODE_ASSUME_FIRST_PARTY_BASE_URL": "1",
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "true",
    "IS_SANDBOX": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS": "1",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "<MODEL>",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "<MODEL>",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "<MODEL>"
  },
  "model": "<MODEL>"
}

运行 claude，用 /status 确认主模型与 subagent 模型均为 <MODEL>。

Codex¶

按需安装 Codex，然后更新用户级配置文件（macOS/Linux 为 ~/.codex/config.toml， Windows 为 %USERPROFILE%\.codex\config.toml）。保留原有配置并加入：

model = "<MODEL>"
model_provider = "macaron"

[model_providers.macaron]
name = "Macaron"
base_url = "<BASE_URL>"
wire_api = "responses"
experimental_bearer_token = "<MACARON_API_KEY>"

运行 codex，用 /status 验证模型与 provider。

OpenCode¶

按需安装 OpenCode，然后更新全局配置 ~/.config/opencode/opencode.json。保留原有配置并加入：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "macaron/<MODEL>",
  "provider": {
    "macaron": {
      "npm": "@ai-sdk/openai",
      "name": "Macaron",
      "options": {
        "baseURL": "<BASE_URL>/v1",
        "apiKey": "<MACARON_API_KEY>"
      },
      "models": {
        "<MODEL>": {
          "name": "Macaron V1"
        }
      }
    }
  }
}

运行 opencode，用 /models 确认默认模型为 macaron/<MODEL>。不要将此配置写入项目目录或提交到 Git。

ccswitch¶

ccswitch 通过协议 URL 导入 provider 配置。在浏览器中打开此 URL（或让 ccswitch 处理）以注册 Macaron provider：

ccswitch://v1/import?resource=provider&app=claude&name=Macaron-V1&endpoint=<BASE_URL>&apiKey=<MACARON_API_KEY>&model=<MODEL>

app 参数选择目标客户端（claude、codex 或 opencode）；ccswitch 为该客户端写入对应配置。

自部署接口¶

以上集成针对托管 Macaron API（/v1/chat/completions）。若你自部署 MinT 并服务 Qwen3 基座模型，该场景下的 /oai/api/v1 接口记录在「自部署」页签下。