⚙️ LongCat 模型接入配置

美团的万亿参数 MoE 模型系列，兼容 OpenAI 和 Anthropic 两套协议。agent 都不默认支持，需要手动写 provider 配置。

🔌 接口

认证走 Authorization: Bearer $LONGCAT_API_KEY（API Keys 页面 申请）。

协议	Endpoint	baseURL 填什么
OpenAI Chat Completions	POST /v1/chat/completions	https://api.longcat.chat/openai，带 /v1
Anthropic Messages	POST /v1/messages	https://api.longcat.chat/anthropic，带 /v1

注意：baseURL 是 https://api.longcat.chat/openai，不是 https://api.longcat.chat。带 /openai 或 /anthropic 前缀区分协议。

📋 模型清单

Model ID	定位	上下文	最大输出	输入
LongCat-2.5-Preview	高性能 Agentic 模型，多模态	1M	128K	📝🖼️ 文本 / 图像
LongCat-2.0	高性能 Agentic 模型	1M	128K	📝 文本

来源：LongCat API 开放平台文档

⚙️ OpenCode

OpenCode 已内置 LongCat Provider，但需要升级到最新版本才能看到。

1️⃣ 认证

opencode auth login

Provider 列表选 LongCat，输入 API Key。Key 存在 ~/.local/share/opencode/auth.json（macOS/Linux）或 %USERPROFILE%\.local\share\opencode\auth.json（Windows）。

2️⃣ 切换模型

TUI 里跑 /models，选 LongCat-2.5-Preview 或 LongCat-2.0。

3️⃣ 配置文件详解

OpenCode 配置文件是 opencode.json（也支持 .jsonc 带注释），多份合并，后者覆盖前者。

优先级顺序（低 → 高）：

1. 远程配置（.well-known/opencode，组织默认）
2. 全局配置 ~/.config/opencode/opencode.json
3. 自定义路径（OPENCODE_CONFIG 环境变量）
4. 项目配置 <项目根>/opencode.json
5. .opencode/ 目录（agents、commands、plugins 等）
6. 内联配置（OPENCODE_CONFIG_CONTENT 环境变量）

LongCat 完整配置示例（全局或项目级均可）：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "longcat/LongCat-2.5-Preview",
  "small_model": "longcat/LongCat-2.0",
  "provider": {
    "longcat": {
      "options": {
        "timeout": 600000,
        "apiKey": "{env:LONGCAT_API_KEY}"
      },
      "models": {
        "LongCat-2.5-Preview": {
          "options": {
            "thinking": { "type": "disabled" }
          }
        },
        "LongCat-2.0": {
          "options": {
            "thinking": { "type": "disabled" }
          }
        }
      }
    }
  },
  "compaction": {
    "auto": true,
    "prune": false,
    "reserved": 10000
  },
  "watcher": {
    "ignore": ["node_modules/**", "dist/**", ".git/**"]
  }
}

变量替换：

• {env:VARIABLE_NAME} — 引用环境变量，未设置则为空字符串
• {file:path/to/file} — 引用文件内容（相对路径或绝对路径）

{
  "provider": {
    "longcat": {
      "options": {
        "apiKey": "{file:~/.secrets/longcat-key}"
      }
    }
  }
}

禁用/启用 Provider：

{
  // 禁用特定 provider（即使有 Key 也不加载）
  "disabled_providers": ["openai", "gemini"],
 
  // 或白名单模式（只允许指定 provider）
  "enabled_providers": ["longcat"]
}

如果内置 Provider 配不上，先升级 OpenCode：npm i -g opencode-ai@latest 或 curl -fsSL https://opencode.ai/install | bash。

🤖 harness（DeepSeek Harness / dsh）

配置在 $DSH_HOME/settings.yaml，和 SenseNova 一样是自定义提供方。

方式一：模型页表单

设置 → 模型 → 添加自定义提供方：

字段	值
Provider ID	longcat（小写，永久不可改）
显示名称	LongCat
API 地址	https://api.longcat.chat/openai/v1
API 协议	openai-completions
API 密钥	你的 Key
模型	至少一个，填 ID / 显示名 / 上下文窗口 / 最大输出

方式二：settings.yaml

llm-pi-ai:
  providers:
    longcat:
      apiKeyEnv: LONGCAT_API_KEY
      api: openai-completions
      baseURL: https://api.longcat.chat/openai/v1
      compat:
        supportsDeveloperRole: false
        maxTokensField: max_tokens
      models:
        - id: LongCat-2.5-Preview
          input: [text, image]
          reasoningEfforts:
            off: none
            high: high
            max: max
        - id: LongCat-2.0

四个 compat 字段和 SenseNova 同理：

• input: [text, image]：不声明图片输入，附图片在发送前就被拒
• compat.supportsDeveloperRole: false：pi-ai 默认发 role: "developer"，LongCat 只认 system / user / assistant / tool
• compat.maxTokensField: max_tokens：OpenAI 默认写 max_completion_tokens，LongCat 认 max_tokens
• reasoningEfforts：不声明就出不了推理菜单；关闭思考是 reasoning_effort: "none"，不是省略参数

🔧 其他 agent

agent	配置方式	文档
OpenClaw	~/.openclaw/openclaw.json 加 models.providers.longCat	官方文档
Hermes Agent	hermes config set model.provider custom + model.base_url	官方文档

🕘 状态记录

• 2026-09-28：首次记录，来源 LongCat 官方文档。覆盖 OpenCode（内置 Provider）、harness（自定义提供方）、OpenClaw、Hermes Agent 四种接入方式。

🔗 相关

• SenseNova 配置（对比参考）：SenseNova模型接入配置
• NVIDIA NIM 配置（对比参考）：NVIDIA NIM 模型接入配置
• 官方文档：https://longcat.chat/platform/docs/zh/
• API Keys：https://longcat.chat/platform/api_keys