在 Claude 和 Codex 中使用 ReShare AI
用个人 API 密钥把 Claude Code、Claude Desktop 或 OpenAI Codex 连接到 ReShare AI：只要对智能体说一声，就能把你的 AI 角色换进短视频、查看进度、预览并定时发布帖子、查看数据分析。
1. 创建 API 密钥
登录后打开设置 → 连接你的智能体并创建密钥。选择它能做什么：读取、制作视频、发布。密钥只显示一次。请把它作为 RESHARE_API_KEY 保存在你的 shell 中，切勿提交到代码仓库；下面每种安装方式都会说明是否还会保存在本地配置文件中。
2. 连接你的智能体
添加 ReShare AI MCP 服务器。claude mcp add 会把密钥保存在本机的 Claude Code 配置（~/.claude.json）中。如果改用 ReShare AI 插件，每次都会从 RESHARE_API_KEY 读取密钥，绝不保存；插件还会添加三个技能（角色替换并发布、定时发布一周的帖子、查看数据分析）。
把密钥保存在 shell 中
Shell export RESHARE_API_KEY="rsk_…"添加 MCP 服务器
Shell claude mcp add --scope user --transport http reshare https://www.reshare.ai/api/mcp \ --header "Authorization: Bearer $RESHARE_API_KEY"或使用插件（公开插件市场上线前，仅供 ReShare AI 团队成员使用）
Shell claude plugin marketplace add reshareai/reshareai claude plugin install reshare@reshare
服务器：https://www.reshare.ai/api/mcp（基于 Streamable HTTP 的 MCP，使用 Authorization: Bearer 加你的密钥）。
3. 直接提要求
- “把我的角色 Mia 换进 https://www.instagram.com/reel/…，好了告诉我。”
- “把我最新的三条视频定时发到 TikTok 和 Instagram，每天一条，马德里时间下午 6 点。”
- “上周的帖子表现如何？下次什么时候发比较好？”
你的智能体会先预览每条帖子（账号、文案长度限制、视频时长、时间、会用掉多少条帖子额度），你同意后才会发布。
工具
| 工具 | 权限 | 功能 |
|---|---|---|
whoami | 读取 | 你的账号、密钥权限、你的套餐以及本周期剩余用量 |
list_characters | 读取 | 你的角色（可用的角色能换进视频） |
list_profiles | 读取 | 发布档案及其已连接的社交账号 |
list_videos / get_video | 读取 | 你的视频，以及单条视频的状态、进度和下载链接 |
get_upload | 读取 | 检查中的已上传视频或短视频链接 |
list_posts / get_post | 读取 | 即将发布和已发布的帖子、每个账号的状态和帖子链接 |
get_usage | 读取 | 本月用量 |
get_analytics / get_post_analytics | 读取 | 各平台的播放、点赞和评论，以及最佳发布时间 |
create_upload / commit_upload | 制作视频 | 把本地视频直接上传到存储（通过签名上传链接） |
add_video_link | 制作视频 | 使用公开的 Instagram、TikTok 或 YouTube Shorts 链接 |
start_swap | 制作视频 | 把你的角色换进视频（消耗套餐中的 AI 角色替换次数） |
use_own_video | 制作视频 | 原样发布你自己的视频，或裁剪后发布 |
preview_post | 发布 | 试运行：检查账号、文案、时长和时间，不会发出任何内容 |
publish_post | 发布 | 立即发布、定时发布或加入队列；需要 confirm 和幂等键 |
cancel_post | 发布 | 取消一条已定时的帖子 |
常见问题
我的智能体会不问我就发布吗？
不会。发布需要 confirm: true，插件技能也会要求智能体先给你预览、等你同意。用同一个幂等键重复调用，永远不会发两次。
API 密钥能看到什么？
只能看到你自己的角色、视频、发布档案和帖子，即使你是团队管理员也一样。每个密钥都有独立的权限（读取、制作视频、发布），每分钟最多 120 次请求，并可随时撤销。
会占用我的套餐额度吗？
会，和在应用里完全一样。免费版每月可发 5 条帖子，不含 AI 角色替换；你的智能体收到的限额提示和升级链接，和你自己看到的一样。
从智能体上传时，我的视频会传到哪里？
通过一个短时有效的签名链接，从你的电脑直接传到 ReShare AI 的存储，绝不经过第三方。
claude.ai 能用吗？
暂时不能：claude.ai 的自定义连接器通过 OAuth 登录，这项支持即将推出。Claude Desktop 和 Claude Code 现在就能用 API 密钥连接。