Longbridge Skill 安装指引
安装完成后，你可以直接问 AI 助手这样的问题，并得到真实的答案：
- "帮我从美股和港股里，筛出市值 500 亿以上、PE 低于 25、近期 MACD 出现金叉的科技股，按市值排列"
- "NVDA 刚出财报，帮我对比实际业绩和分析师预期的差距，拆一下各业务线的营收变化，顺便看看当前估值是否合理"
- "帮我给 TSLA 设一个追踪止损，跌幅超过 8% 自动触发卖出，执行前把订单详情给我确认"
- "帮我复盘这个月的持仓表现：总盈亏趋势如何，哪只股票贡献最大、哪只表现最弱，组合里美股和港股各占多少"
- "我在执行五年长期定投计划，本月的 QQQ 和 SPY 计划在未来两天内买入，帮我看看最近市场情况，这个时机合适吗？"
最快的上手方式是使用终端类 AI 工具——Claude Code、Codex、opencode 或 OpenClaw。安装好 CLI、完成一次授权，AI 就能直接代你运行 longbridge 命令。
如果不想在本地安装软件，也可以通过 MCP 接入——只需在 AI 工具的配置中填入一个 URL 即可。
两种方式都建议同时安装 Skill：一组指令文件，告诉 AI 助手 Longbridge 能做什么、怎么用。
第一步：连接 Longbridge 平台
CLI 和 MCP 都是接入 Longbridge Developers 平台的方式，两者均可，选其一即可：
- CLI：体验最佳，AI 直接在终端运行
longbridge命令；需要在系统上安装软件 - MCP：接入更简便，只需在 AI 工具配置中填入一个 URL；无需本地安装
方式 A：CLI（推荐）
适用于 Claude Code、Codex（Work locally 模式）、opencode、OpenClaw、Gemini CLI、Warp 等可在终端执行命令的工具。
# macOS（需要 Homebrew，未安装请先访问 https://brew.sh）
brew install --cask longbridge/tap/longbridge-terminal
# macOS / Linux
curl -sSL https://open.longbridge.com/longbridge/longbridge-terminal/install | shWindows（Scoop）：
scoop install https://open.longbridge.com/longbridge/longbridge-terminal/longbridge.jsonWindows（PowerShell）：
iwr https://open.longbridge.com/longbridge/longbridge-terminal/install.ps1 | iex授权登录：
longbridge auth login完成后，AI 即可代你调用 longbridge 命令。
详细安装说明及完整命令列表参见 CLI 文档。
方式 B：MCP
适用于 Claude Desktop、Cursor、Zed、Gemini CLI、Warp 等支持 MCP 的工具。
在 AI 工具的 MCP 配置中添加以下服务器地址：
https://openapi.longbridge.com/mcp中国大陆用户可使用加速地址：
https://openapi.longbridge.cn/mcp
各工具配置入口：
| 工具 | 配置位置 |
|---|---|
| Claude Desktop | 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows） |
| Cursor | Settings → MCP Servers → Add Remote MCP Server |
| Zed | ~/.config/zed/settings.json 中的 context_servers 字段 |
| Gemini CLI | ~/.gemini/settings.json 中的 mcpServers 字段 |
| Warp | Settings → AI → MCP Servers → Add |
首次提问时客户端会自动弹出浏览器完成 OAuth 授权。
第二步：安装 Skill
Skill 是一组指令文件，告诉 AI 助手 Longbridge 能做什么。
通过 Claude Code 插件安装（Claude Code 用户推荐）：
在 Claude Code 中依次执行以下两条命令：
/plugin marketplace add longbridge/skills
/plugin install longbridge@longbridge-skills此方式通过 Claude Code 插件系统安装全部 Longbridge Skill，并可自动保持最新版本。
通过 npx / bunx（全局安装）：
# Node.js
npx skills add longbridge/skills -g
# Bun
bunx skills add longbridge/skills -g或下载 ZIP 手动安装：
下载 longbridge-all.zip 并解压，将文件放入你的 AI 工具指定的 Skill 目录（Claude Code 放 .claude/skills/，Cursor 粘贴到 Rules 编辑框，其他工具参考 README）。
OpenClaw 直接在对话中发送以下消息，自动完成安装：
从以下 zip 文件安装 Longbridge Developers Skill：
https://open.longbridge.com/skill/longbridge-all.zip各工具的已知限制
部分环境存在网络白名单或沙箱限制，会阻止 CLI 安装和 MCP 服务器连接。遇到问题请先查阅本节。
Claude Desktop — 切换到 Code 标签页
Claude Desktop 的 Chat 和 Cowork 模式都存在网络限制，无法安装 CLI 或连接 MCP 服务器。不要在这两种模式下反复尝试，这样不会成功。
切换到 Claude Desktop 的 Code 标签页（即 App 内嵌的 Claude Code）。在 Code 标签页下，你拥有完整的终端访问权限，可以在同一个会话中完成 CLI 安装、MCP 连接和 Skill 安装。
Codex — 选择「Work locally」
Codex 的 Cloud 模式存在同样的网络白名单限制。启动新会话时，请选择 Work locally 而非 Cloud。本地模式下 AI 可完整访问你的 shell 和网络。
Claude.ai 和 ChatGPT.com（网页版）
基于浏览器的界面无法访问本地系统，既不能执行 shell 命令，也无法连接外部 MCP 服务器。
如果你使用 Claude，请安装 Claude Desktop 并切换到 Code 标签页。
验证安装
安装完成后，在对话中发送：
使用 Longbridge 查一下 AAPL 当前报价如果 AI 能返回实时报价数据，说明安装成功。
提示： 如果 Skill 没有被自动触发，可以在提问前加上
/longbridge强制引用，例如：/longbridge 查一下 AAPL 当前报价。
常见问题
AI 说找不到 Longbridge 工具
部分客户端需要重启或新建对话才能加载 Skill。确认安装步骤已完成，并在新会话中再次尝试。
查询数据时需要授权
在终端中运行 longbridge auth login 完成 OAuth 授权即可。
交易操作无法执行
确认账户已开通 OpenAPI 交易权限，以及该市场（港股 / 美股）的交易资格。
撤销授权
如需撤销访问权限，前往 Longbridge 账户 → 安全设置 → 管理已授权应用。