用 Claude + Agent Trade Kit 从 0 到 1 搭建 AI 交易员

实操路线图

全部操作均在真实模拟盘环境完成，以下为本次实操的完整时间线

Step 1 安装 Agent Trade Kit

npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli

Step 2 配置模拟盘 API Key

~/.okx/config.toml → demo = true

Step 3 实时行情查询 — BTC / ETH / SOL

无需 API Key • K 线 • 资金费率 • 盘口深度

Step 4 现货实战 — 市价买入 / 限价挂单 / 撤单

市价买入 100 USDT BTC • 限价挂单 ETH • 撤销 • 查成交

Step 5 合约实战 — 开多 / 持仓 / 平仓

BTC-USDT-SWAP 多头 1 张 • 10x 杠杆 • 全仓模式

Step 6 效率对比 + 安全机制 + Claude 集成

传统 vs AI 效率表 • 4 层安全防护 • MCP 一键接入

什么是 Agent Trade Kit？

OKX Agent Trade Kit 是 OKX 官方推出的开源 MCP 工具包，它将 AI 助手（如 Claude、Cursor）与你的 OKX 交易账户直接连接。你只需要用自然语言描述需求，AI 就能自动执行交易。

82 个工具

现货、合约、期权、策略委托、账户管理、网格机器人

本地安全

API Key 永不离开本地，HMAC-SHA256 本地签名

MCP 标准协议

接入 Claude / Cursor / VS Code 等所有 MCP 客户端

完全开源（MIT 协议），代码审计透明： github.com/okx/agent-trade-kit

安装 Agent Trade Kit

一行命令即可完成安装。需要 Node.js 18+ 环境。

Terminal

# 全局安装 MCP 服务器 + CLI 工具 $ npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli added 102 packages in 8s 29 packages are looking for funding

安装后直接验证 — 查行情无需 API Key：

Terminal — 验证安装

$ okx market ticker BTC-USDT instId BTC-USDT last 74,789.1 24h open 71,019.6 24h high 74,930 24h low 70,824.1 24h vol 9,016.72 BTC 24h change % +5.31% time 4/14/2026, 1:36:40 PM

看到价格输出，安装就成功了。

配置模拟盘 API Key

获取模拟盘 API Key

登录 okx.com → 右上角头像 → API 管理
点击「创建 V5 API Key」→ 选择模拟交易
权限勾选：读取 + 交易（不要勾提币）
设置 Passphrase（自定义密码短语），记住它
保存 API Key、Secret Key、Passphrase 三个值

方式一：交互式向导（推荐）

Terminal

$ okx config init # 向导会引导你完成配置，运行一次即可

方式二：手动创建配置文件

~/.okx/config.toml

default_profile = "demo" [profiles.demo] api_key = "your-demo-api-key" secret_key = "your-demo-secret-key" passphrase = "your-demo-passphrase" demo = true # demo=true → 模拟盘，不涉及真实资金

安全提示：切勿将 API Key / Secret Key / Passphrase 粘贴到 AI 对话框中。Agent Trade Kit 的密钥只保存在本地配置文件中，AI 模型永远无法读取。

查询行情数据

无需 API Key，一句话获取全市场实时数据。

BTC-USDT

74,789.1

+5.31%

ETH-USDT

2,389.85

+9.19%

SOL-USDT

86.65

+5.17%

BTC 1 小时 K 线（真实数据可视化）

Terminal — K 线查询

$ okx market candles BTC-USDT --bar 1H --limit 5 time open high low close vol 4/14/2026, 1:00 PM 74462.6 74894.7 74413.8 74870.8 247.685 4/14/2026, 12:00 PM 74377.8 74492 74281.5 74462.5 167.274 4/14/2026, 11:00 AM 74348.5 74459.4 74309.7 74377.7 105.627 4/14/2026, 10:00 AM 74507.7 74615.1 74340 74348.5 170.626 4/14/2026, 9:00 AM 74752.3 74830.9 74425.2 74507.6 195.224

永续合约资金费率

资金费率

$ okx market funding-rate BTC-USDT-SWAP fundingRate 0.0000449 正值 = 多头付费给空头 fundingTime 4/14, 4:00 PM

盘口深度

Orderbook

$ okx market orderbook BTC-USDT --sz 5 Ask 74,870.7 @ 0.100 Ask 74,870.4 @ 0.249 Ask 74,870.3 @ 0.267 ───────────────────────── Bid 74,865.7 @ 0.017 Bid 74,863.1 @ 0.015 Bid 74,860.3 @ 0.012

模拟盘实战 — 现货交易

第一步：查看账户余额

Demo — 账户余额

$ okx --demo account balance Environment: demo (simulated trading) currency equity available BTC 1.0000 1.0000 USDT 13,559.03 11,471.48 ETH 1.0000 1.0000 SOL 0.0012 0.0012

第二步：市价买入 100 USDT 的 BTC

Demo — 现货市价买入

$ okx --demo spot place --instId BTC-USDT --side buy --ordType market --sz 100 Order placed: 3480968769957396480 (OK) ✓

第三步：限价挂单买入 0.05 ETH @ 2300

Demo — 限价挂单

$ okx --demo spot place --instId ETH-USDT \ --side buy --ordType limit --px 2300 --sz 0.05 Order placed: 3480969113051463680 (OK) ✓ # 查看当前挂单 $ okx --demo spot orders ETH-USDT ordId instId side type price size state 3480969113051463680 ETH-USDT buy limit 2300 0.05 live # 取消挂单 $ okx --demo spot cancel --instId ETH-USDT --ordId 3480969113051463680 Cancelled: 3480969113051463680 (OK) ✓

第四步：查看成交记录

Demo — 现货成交

$ okx --demo spot fills BTC-USDT instId side fillPx fillSz fee ts BTC-USDT buy 74,172.6 0.00130576 -0.0000013 BTC 4/15, 8:55 AM BTC-USDT buy 74,172.0 0.00004244 -0.0000000 BTC 4/15, 8:55 AM

100 USDT 成功买入约 0.001348 BTC（均价 74,172），成交拆为两笔完成。交易手续费极低。

模拟盘实战 — 合约交易

第一步：开多 BTC 永续合约

Demo — 合约开多

# 开多 1 张 BTC 永续合约，10 倍杠杆，全仓模式 $ okx --demo swap place --instId BTC-USDT-SWAP \ --side buy --ordType market --sz 1 \ --posSide long --tdMode cross Order placed: 3480969446985170944 (OK) ✓

第二步：查看持仓

Demo — 合约持仓

$ okx --demo swap positions instId side size avgPx upl uplRatio lever BTC-USDT-SWAP long 1 74,132.9 +$0.059 +0.08% 10x

第三步：平仓

Demo — 合约平仓

$ okx --demo swap close --instId BTC-USDT-SWAP \ --posSide long --mgnMode cross Position closed: BTC-USDT-SWAP long ✓

第四步：合约成交记录

Demo — 合约成交

$ okx --demo swap fills BTC-USDT-SWAP instId side fillPx fillSz fee ts BTC-USDT-SWAP sell 74,110.5 0.86 -$0.318 4/15, 8:56:49 AM BTC-USDT-SWAP sell 74,110.6 0.14 -$0.051 4/15, 8:56:49 AM BTC-USDT-SWAP buy 74,133.0 0.66 -$0.244 4/15, 8:56:13 AM BTC-USDT-SWAP buy 74,132.9 0.08 -$0.029 4/15, 8:56:13 AM

从开仓到平仓仅用了 36 秒。均价 74,132.9 开多 → 74,110.5 平仓。全程通过命令行完成，如果接入 Claude 则只需自然语言对话。

传统交易 vs AI 交易

同样的操作，效率差距可达 10–40 倍。

操作	传统手动交易	AI 一句话完成	提速
查看 BTC 价格	打开 App → 搜索 → 找交易对 ~30 秒	"BTC 现在多少钱？" ~2 秒	15x
市价买入	切到交易页 → 选方向 → 输金额 → 确认 ~60 秒	"买 100U 的 BTC" ~3 秒	20x
开合约仓位	切合约 → 设杠杆 → 选方向 → 输仓位 → 确认 ~120 秒	"开多 1 张 BTC 永续" ~3 秒	40x
设止盈止损	进持仓 → 设止盈 → 设止损 → 确认 ~60 秒	"涨到 8 万止盈，跌到 7 万止损" ~3 秒	20x
综合数据查询	分别切换 K 线 / 资金费率 / 盘口页面 ~180 秒	"给我 BTC 的 K 线、费率和盘口" ~5 秒	36x

四层安全机制

Agent Trade Kit 从架构层面确保你的资金安全。

本地优先安全

API Key 保存在本地 ~/.okx/config.toml。HMAC-SHA256 签名在本地完成。AI 模型永远无法访问你的密钥。

权限感知注册

启动时自动读取 API Key 权限。若密钥无交易权限，下单工具根本不会注册到 AI 的工具箱中。

模拟盘模式

使用 --demo 标志，所有交易在模拟环境完成。零真实资金风险，适合测试和学习。

风险标签 + 开源审计

涉及资金操作的工具标记 [CAUTION]，AI 执行前会确认。MIT 协议完全开源，代码可审计。

连接 Claude — 用自然语言交易

通过 MCP 协议，一行命令将 Agent Trade Kit 接入你的 AI 客户端。

MCP 接入

# 一键接入 Claude Desktop $ okx-trade-mcp setup --client claude-desktop # 其他客户端 $ okx-trade-mcp setup --client cursor $ okx-trade-mcp setup --client vscode $ okx-trade-mcp setup --client windsurf $ okx-trade-mcp setup --client claude-code

接入后，在 Claude 中你可以直接说：

"OKX 上 BTC 现在多少钱？"

"查看我的账户余额"

"市价买入 100 USDT 的 BTC"

"BTC 资金费率是多少？"

"开多 1 张 BTC 永续，全仓 10 倍"

"涨到 80000 止盈，跌到 70000 止损"

支持的 AI 客户端

Claude Desktop Claude Code Cursor VS Code Windsurf OpenClaw 所有 MCP 兼容客户端

总结

本文从零开始，完整演示了使用 OKX Agent Trade Kit 搭建 AI 交易员的全过程：

一行命令安装，无需 API Key 即可查询全市场行情
配置模拟盘 API Key，零风险开始实战
现货交易：市价买入、限价挂单、撤单，全部一句话完成
合约交易：开多、查看持仓、平仓，36 秒完成全流程
效率对比：AI 交易比手动操作快 10–40 倍
四层安全机制：本地密钥、权限感知、模拟盘、风险标签

资源链接

GitHub — Agent Trade Kit

github.com/okx/agent-trade-kit

npm — okx-trade-mcp

npmjs.com/package/okx-trade-mcp

官方文档

okx.com/docs-v5/agent_zh/

AI 101 免费课程

okx.com/zh-hans/ai-101

Telegram 社群

t.me/OKX_AgentKit

Agent Trade Kit 产品页

okx.com/zh-hans/agent-tradekit

#OKXAI交易大赛