美团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.html1. 开放平台核心能力开放平台为开发者和企业提供3类支持能力同步开放LongCat所有核心功能多轮对话、联网搜索、长文本处理等均可通过API调用无需单独适配配套服务支持提供完整的开发文档、在线调试工具、专属技术支持、用量监控告警等全流程服务灵活适配支持个人开发者测试、企业自定义额度/私有化部署等多类型需求2. 接入全流程第一步前期准备搜索【美团LongCat开放平台】进入官网用个人/企业账号登录即可完成开发者注册明确调用场景智能客服、文案生成、办公助手等方便后续选择适配参数。第二步创建应用获取凭证进入「应用管理中心」→点击「创建应用」填写应用名称/描述选择应用类型个人/企业创建完成后生成专属调用凭证AppID和AppSecret为API核心身份标识务必妥善保管。第三步选择对接方式官方支持两类调用方式可根据技术栈选择RESTful API通用格式所有支持HTTP请求的语言可调用适合快速集成官方SDK目前开放Python、Java、Go等主流语言SDK封装请求签名、错误校验逻辑降低集成难度第四步调试与上线开放平台提供完整API字典和在线调试工具可先在页面测试调用逻辑确认结果符合预期后部署生产环境上线后可实时查看调用量、异常占比等数据。3. Python SDK调用示例# 安装官方SDKpip install longcat-api from longcat import LongCatClient # 初始化客户端替换为自身凭证 client LongCatClient( app_id你的AppID, app_secret你的AppSecret ) # 发起对话调用 response client.chat( messages[ {role: user, content: 帮我写一段带注释的python猜数字游戏代码} ], temperature0.7, # 控制随机性0-1取值越低越严谨 max_tokens1024 # 最大输出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能力前提条件已获取LongCat开放平台有效调用凭证AppID、AppSecret账户有剩余调用额度已订阅Claude Pro/Team/Enterprise版本仅付费版支持自定义模型接入可选已搭建API中转服务解决跨网络访问问题操作步骤可选配置API中转服务若直连LongCat API网络不稳定可通过Cloudflare Worker、Nginx等搭建请求中转映射为可访问自定义域名Nginx中转配置示例location /longcat/ { proxy_pass https://api.longcat.com/; proxy_set_header Host api.longcat.com; }在Claude中添加自定义模型进入客户端「设置」→「模型配置」→「添加自定义模型」填写参数参数名填写说明模型名称自定义标识如「LongCat-Pro」API端点LongCat官方API地址https://api.longcat.com/v1/chat/completions或中转地址API Key填写LongCat AppSecret模型标识要调用的LongCat模型ID如longcat-chat-pro切换模型使用返回对话页点击顶部模型选择栏选择「LongCat-Pro」所有请求自动转发LongCat处理。场景2开发者在Claude插件/工作流中集成LongCat API操作步骤登录Claude开发者平台创建自定义插件/工作流进入开发模式添加「HTTP请求」节点配置LongCat调用参数请求方法POST请求地址LongCat官方API地址或中转地址请求头Content-Type: application/jsonAuthorization: Bearer {你的AppSecret}请求体{ model: longcat-chat-pro, messages: [ {role: user, content: {{工作流中的用户输入变量}}} ], temperature: 0.7, max_tokens: 2048 }添加「解析JSON」节点提取返回结果choices[0].message.content作为回复嵌入对话流程完成集成。四、开发者专属将LongCat集成到Claude Code中的操作步骤Claude Code为Anthropic官方推出的命令行AI编程开发工具集成逻辑与普通客户端不同。一、前置准备到LongCat开放平台创建应用获取AppID、AppSecret及调用的模型ID如longcat-chat-pro确保Claude Code已更新到支持自定义模型接入的最新版本可选可提前搭建请求中转服务解决网络延迟问题二、集成步骤场景1LongCat API兼容Anthropic Messages格式推荐优先使用直接配置环境变量即可完成集成打开终端执行配置命令或手动编辑~/.claude/.env# 替换为自身LongCat配置 export ANTHROPIC_BASE_URLhttps://api.longcat.com/v1/ export ANTHROPIC_API_KEY你的LongCat AppSecret export CLAUDE_CODE_MODELlongcat-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一致。场景2LongCat 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, jsonlongcat_req, headers{Authorization: fBearer {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, host127.0.0.1, port8000)安装依赖并启动适配服务pip install fastapi httpx uvicorn python adapter.py配置Claude Code环境变量指向本地适配服务export ANTHROPIC_BASE_URLhttp://127.0.0.1:8000 export ANTHROPIC_API_KEY任意非空字符串即可 export CLAUDE_CODE_MODELlongcat-chat-pro重启Claude Code即可正常使用底层能力由LongCat提供。
