美团AI大模型-LongCat小白全指南：从基础使用到多场景集成完整教程

美团AI大模型-LongCat小白全指南：从基础使用到多场景集成完整教程

---

一、基础认知：LongCat核心能力与普通用户使用说明

1. 核心定位

LongCat是美团研发的大语言模型，核心能力覆盖文本创作、知识问答、逻辑推理、代码生成等全场景，用户可直接在对话框交互获得AI能力，开发者可通过API接入集成到自有产品。

2. 普通用户高频使用场景

• 文本创作：写邮件、文案、作文、工作总结，支持纠错润色、纠错润色、风格调整
• 知识问答：覆盖生活常识、学科领域、行业知识科普，还支持联网搜索获取最新信息
• 逻辑任务：解数学题、分析问题逻辑、写代码/Debug
• 创意输出：生成策划案、视频脚本、活动方案等

3. 普通用户常用技巧

• 需求尽量具体，明确目标、要求、细节，避免笼统提问
• 复杂任务分步骤逐步提问，更高效拿到符合预期的结果
• 不满意可以直接提出修改方向，LongCat会快速调整

---

官网地址：

https://longcat.chat/platform/docs/zh/

二、进阶能力：LongCat API开放平台接入指南（开发者/企业专属）

官方文档：

https://longcat.chat/platform/docs/zh/ClaudeCode.html

1. 开放平台核心能力

开放平台为开发者和企业提供3类支持：

• 能力同步开放：LongCat所有核心功能（多轮对话、联网搜索、长文本处理等）均可通过API调用，无需单独适配
• 配套服务支持：提供完整的开发文档、在线调试工具、专属技术支持、用量监控告警等全流程服务
• 灵活适配：支持个人开发者测试、企业自定义额度/私有化部署等多类型需求

2. 接入全流程

第一步：前期准备

搜索【美团LongCat开放平台】进入官网，用个人/企业账号登录即可完成开发者注册，明确调用场景（智能客服、文案生成、办公助手等），方便后续选择适配参数。

第二步：创建应用获取凭证

进入「应用管理中心」→点击「创建应用」，填写应用名称/描述，选择应用类型（个人/企业），创建完成后生成专属调用凭证：AppID和AppSecret，为API核心身份标识，务必妥善保管。

第三步：选择对接方式

官方支持两类调用方式，可根据技术栈选择：

1. RESTful API：通用格式，所有支持HTTP请求的语言可调用，适合快速集成
2. 官方SDK：目前开放Python、Java、Go等主流语言SDK，封装请求签名、错误校验逻辑，降低集成难度

第四步：调试与上线

开放平台提供完整API字典和在线调试工具，可先在页面测试调用逻辑，确认结果符合预期后部署生产环境，上线后可实时查看调用量、异常占比等数据。

3. Python SDK调用示例

# 安装官方SDK：pip install longcat-api
from longcat import LongCatClient

# 初始化客户端（替换为自身凭证）
client = LongCatClient(
    app_id="你的AppID",
    app_secret="你的AppSecret"
)

# 发起对话调用
response = client.chat(
    messages=[
        {"role": "user", "content": "帮我写一段带注释的python猜数字游戏代码"}
    ],
    temperature=0.7, # 控制随机性，0-1取值，越低越严谨
    max_tokens=1024 # 最大输出token数
)

print(response.choices[0].message.content)

4. 常见错误码说明

错误码	含义	解决方案
200	调用成功	-
401	认证失败	检查AppID、AppSecret是否正确，是否已过期
429	调用频率超限	降低请求频率，或联系官方申请提升调用额度
500	服务器内部错误	重试，若持续出现联系官方技术支持

---

注：

博客：

https://blog.csdn.net/badao_liumang_qizhi

三、场景拓展：将LongCat能力集成到Claude客户端

场景1：普通用户在Claude客户端中直接使用LongCat能力

前提条件

1. 已获取LongCat开放平台有效调用凭证（AppID、AppSecret），账户有剩余调用额度
2. 已订阅Claude Pro/Team/Enterprise版本（仅付费版支持自定义模型接入）
3. （可选）已搭建API中转服务，解决跨网络访问问题

操作步骤

1. （可选）配置API中转服务
   若直连LongCat API网络不稳定，可通过Cloudflare Worker、Nginx等搭建请求中转，映射为可访问自定义域名，Nginx中转配置示例：

   location /longcat/ {
   proxy_pass https://api.longcat.com/;
   proxy_set_header Host api.longcat.com;
   }

2. 在Claude中添加自定义模型

   进入客户端「设置」→「模型配置」→「添加自定义模型」，填写参数：

   参数名	填写说明
   模型名称	自定义标识，如「LongCat-Pro」
   API端点	LongCat官方API地址（https://api.longcat.com/v1/chat/completions）或中转地址
   API Key	填写LongCat AppSecret
   模型标识	要调用的LongCat模型ID，如longcat-chat-pro

3. 切换模型使用

   返回对话页点击顶部模型选择栏，选择「LongCat-Pro」，所有请求自动转发LongCat处理。

场景2：开发者在Claude插件/工作流中集成LongCat API

操作步骤

1. 登录Claude开发者平台，创建自定义插件/工作流进入开发模式

2. 添加「HTTP请求」节点，配置LongCat调用参数：

   • 请求方法：POST
   • 请求地址：LongCat官方API地址或中转地址
   • 请求头：Content-Type: application/json，Authorization: Bearer {你的AppSecret}
   • 请求体：

   {
   "model": "longcat-chat-pro",
   "messages": [
   {"role": "user", "content": "{{工作流中的用户输入变量}}"}
   ],
   "temperature": 0.7,
   "max_tokens": 2048
   }

3. 添加「解析JSON」节点，提取返回结果choices[0].message.content作为回复嵌入对话流程，完成集成。

---

四、开发者专属：将LongCat集成到Claude Code中的操作步骤

Claude Code为Anthropic官方推出的命令行AI编程开发工具，集成逻辑与普通客户端不同。

一、前置准备

1. 到LongCat开放平台创建应用，获取AppID、AppSecret及调用的模型ID（如longcat-chat-pro）
2. 确保Claude Code已更新到支持自定义模型接入的最新版本
3. （可选）可提前搭建请求中转服务，解决网络延迟问题

二、集成步骤

场景1：LongCat API兼容Anthropic Messages格式（推荐优先使用）

直接配置环境变量即可完成集成：

打开终端执行配置命令（或手动编辑~/.claude/.env）：

# 替换为自身LongCat配置
export ANTHROPIC_BASE_URL="https://api.longcat.com/v1/"
export ANTHROPIC_API_KEY="你的LongCat AppSecret"
export CLAUDE_CODE_MODEL="longcat-chat-pro"

或者按照官方参考配置：

创建或编辑 Claude Code 配置文件：~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_longcat_api_key",
    "ANTHROPIC_BASE_URL": "https://api.longcat.chat/anthropic",
    "ANTHROPIC_MODEL": "LongCat-2.0",
    "ANTHROPIC_SMALL_FAST_MODEL": "LongCat-2.0",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "LongCat-2.0",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "LongCat-2.0",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "131072",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重启Claude Code，所有编程、调试请求自动转发LongCat处理，效果与原生Claude一致。

场景2：LongCat API仅支持OpenAI/自定义格式

需要搭建轻量适配层转换格式：

新建adapter.py文件，写入适配代码：

from fastapi import FastAPI
import httpx
app = FastAPI()

# 替换为自身LongCat配置
LONGCAT_URL = "https://api.longcat.com/v1/chat/completions"
LONGCAT_KEY = "你的LongCat AppSecret"
LONGCAT_MODEL = "longcat-chat-pro"

@app.post("/v1/messages")
async def handle_request(request: dict):
    # 转换请求格式
    longcat_req = {
        "model": LONGCAT_MODEL,
        "messages": request["messages"],
        "max_tokens": request.get("max_tokens", 1024),
        "temperature": request.get("temperature", 0.7)
    }
    async with httpx.AsyncClient() as client:
        resp = await client.post(
            LONGCAT_URL,
            json=longcat_req,
            headers={"Authorization": f"Bearer {LONGCAT_KEY}", "Content-Type": "application/json"}
        )
    longcat_resp = resp.json()
    # 转换为Claude Code可识别的Anthropic格式
    return {
        "id": longcat_resp["id"],
        "type": "message",
        "role": "assistant",
        "model": LONGCAT_MODEL,
        "content": [{"type": "text", "text": longcat_resp["choices"][0]["message"]["content"]}],
        "stop_reason": "end_turn",
        "usage": longcat_resp["usage"]
    }

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="127.0.0.1", port=8000)

安装依赖并启动适配服务：

pip install fastapi httpx uvicorn
python adapter.py

配置Claude Code环境变量指向本地适配服务：

export ANTHROPIC_BASE_URL="http://127.0.0.1:8000"
export ANTHROPIC_API_KEY="任意非空字符串即可"
export CLAUDE_CODE_MODEL="longcat-chat-pro"

重启Claude Code即可正常使用，底层能力由LongCat提供。