OceanToken

面向编码 Agent 的 OceanToken 插件

OceanToken 用一个账号即可使用 500 多种 AI 模型：用于文本的 GPT、Claude、Gemini、 DeepSeek 和 Qwen；用于图像的 GPT Image、Seedream、Recraft 和 Gemini；用于视频的 Seedance、Veo、 Sora 和 Wan；以及文本转语音和转录。此插件将所有功能带入你的编码 Agent：只需一条命令，即可连接 Codex、Claude Code、Cursor、Gemini CLI、OpenClaw、 OpenCode、VS Code、WorkBuddy、Hermes Agent 和 Windsurf；任何其他 MCP 客户端也可以手动添加此 服务。你的 Agent 可以查找模型、查看费用、生成素材，并将其保存到项目中。

Agent 能使用哪些工具

工具	功能
search_models	按名称、类型、发布方、能力和价格搜索目录。
get_model	查看定价、限制，以及模型支持的尺寸、时长和输入内容。
estimate_cost	预先估算请求费用，并确认余额是否充足。
generate_image	文本生成图像和图像编辑，并提供预览和下载链接。
create_video + get_job	根据文本、首帧（和尾帧）或参考媒体生成视频。
generate_speech	生成配音和旁白。
transcribe_audio	生成转录文本和 SRT/VTT 字幕。
ask_model	将子任务交给其他模型处理：选用更便宜的模型，或获取第二意见。
upload_file	使用本地文件作为参考。
get_account	查看余额、可用余额和支出。

以下三个技能会教 Agent 如何善用这些工具：

• oceantoken-media：为项目制作图像、视频和音频。
• oceantoken-models：选择模型、查询价格并委派任务。
• oceantoken-setup：让 Codex 或 Claude Code 本身使用 OceanToken 运行，或配置你的应用。

同一个插件文件夹中包含各个平台的清单（.codex-plugin、.claude-plugin、 .cursor-plugin，以及开源的 Agent Plugins plugin.json），因此 所有平台都能获得相同的工具和技能。

安装

你需要一个 OceanToken 账号（注册）并充值。

一条命令，适用于任何 Agent

让你的 Agent：

按照 https://mcp.oceantoken.ai/install 为我安装 OceanToken

或自行运行：

npx -y @oceantoken/cli@latest connect <client>

<client> 可以是 codex、claude-code、cursor、gemini、openclaw、opencode、vscode、 workbuddy、hermes 或 windsurf。它会安装插件或 MCP 配置项和三个技能（Windsurf / Devin Desktop 没有技能文件夹，因此只会安装服务），并启动登录流程。有关选项（API 密钥、试运行、断开连接，以及通过 use 让 Codex 或 Claude Code 本身使用 OceanToken 模型运行），请参阅 cli/；分步指南请参阅指南。以下各节介绍手动安装方法。

Codex

codex plugin marketplace add OceanTokenAI/oceantoken-plugins
codex plugin add oceantoken@oceantoken
codex mcp login oceantoken      # opens the OceanToken sign-in page

在 Codex 应用中，你也可以先添加 marketplace，然后从 Plugins 面板安装 OceanToken，并按提示登录。

Claude Code

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken
/mcp                             # pick "plugin:oceantoken:oceantoken" and authenticate

Cursor

此按钮会添加 MCP 服务；Cursor 会在首次运行工具时提示你登录。如需同时获取技能，请从此仓库安装插件（其中包含 .cursor-plugin marketplace 清单）。

Gemini CLI

gemini extensions install https://github.com/OceanTokenAI/oceantoken-plugins

然后，在 Gemini CLI 中运行 /mcp auth oceantoken 并登录。此扩展包含 MCP 服务、三个技能和简短的 GEMINI.md。

OpenClaw

openclaw plugins install clawhub:@oceantoken/oceantoken --accept-capabilities
openclaw mcp set oceantoken '{"url":"https://mcp.oceantoken.ai/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login oceantoken

ClawHub 软件包包含三个技能 （也可在 ClawHub 上单独获取：oceantoken-media、oceantoken-models、oceantoken-setup）。mcp set 条目会向 OpenClaw 注册服务，以便你通过 mcp login 登录；它会替换插件中同名的未认证条目。

其他 MCP 客户端

OceanToken 已收录在官方 MCP Registry中，名称为 ai.oceantoken/mcp，因此浏览 Registry 的客户端（例如 VS Code 和 GitHub Copilot）可以按名称找到它。

服务地址为 https://mcp.oceantoken.ai/mcp（streamable HTTP）。它支持动态客户端注册 OAuth，因此大多数客户端只需提供 URL。如需改用 API 密钥，请将其作为 bearer token 发送：

# Codex, without the plugin
export OCEANTOKEN_API_KEY=sk-...
codex mcp add oceantoken --url https://mcp.oceantoken.ai/mcp --bearer-token-env-var OCEANTOKEN_API_KEY

# Claude Code, without the plugin. The single quotes keep the key off the command line:
# Claude Code reads OCEANTOKEN_API_KEY from its environment when it starts.
claude mcp add --transport http oceantoken https://mcp.oceantoken.ai/mcp \
  --header 'Authorization: Bearer ${OCEANTOKEN_API_KEY}'

{
  "mcpServers": {
    "oceantoken": { "type": "http", "url": "https://mcp.oceantoken.ai/mcp" }
  }
}

Muse Code（Meta）

将服务添加到 Muse Code 设置的 mcp_servers 代码块中，然后登录：

{
  "mcp_servers": {
    "oceantoken": { "transport": "streamable_http", "url": "https://mcp.oceantoken.ai/mcp" }
  }
}

muse mcp login oceantoken

Muse Code 也会从 ~/.agents/skills 读取技能：将 plugins/oceantoken/skills/ 中的文件夹复制到该目录，即可使用 OceanToken 工作流。

让你的 Agent 主动使用 OceanToken

Agent 会自行选择工具。遇到自身无法完成的任务时（视频、配音、字幕、没有的模型、费用估算），它们会使用 OceanToken。对于图像，Codex 也有内置生成器，因此请按名称指定 OceanToken，或将其设为规则：

• 明确提出要求：在 Codex 中使用 $oceantoken-media ...，在 Claude Code 中使用 /oceantoken:oceantoken-media ...， 或直接说“使用 OceanToken 来……”。

• 将其设为项目规则，写入 AGENTS.md（Codex）或 CLAUDE.md（Claude Code）：

  Generate images, video, voice-overs and subtitles with the OceanToken tools.
  Estimate the cost first and ask me before spending more than $2.
  

• 在 Codex 中跳过只读工具的审批提示（~/.codex/config.toml）：

  [plugins."oceantoken@oceantoken".mcp_servers.oceantoken.tools.search_models]
  approval_mode = "approve"
  [plugins."oceantoken@oceantoken".mcp_servers.oceantoken.tools.estimate_cost]
  approval_mode = "approve"
  [plugins."oceantoken@oceantoken".mcp_servers.oceantoken.tools.get_job]
  approval_mode = "approve"
  

登录

登录页面提供两种连接方式：

• 登录：使用你的 OceanToken 电子邮件和密码。这会为连接的应用创建一个 API 密钥，你可以在控制台的 API 密钥 页面查看和撤销该密钥。
• API 密钥：粘贴你已有的密钥。如果希望为 Agent 设置额度上限，可以为其设置信用额度。

撤销密钥后，应用会立即断开连接。

费用

你支付的模型用量将从 OceanToken 预付余额中扣除，价格以 模型页面为准。请先让 Agent 估算费用 （estimate_cost）。视频任务启动时会暂时冻结少量金额，完成后再按实际费用扣款。失败的任务不会收费。

隐私和条款

提示词和文件会通过 OceanToken 发送给你选择的模型，以生成结果。 生成的文件会存储在你的 OceanToken 存储空间中，并通过有时限的链接分享。 除 MCP 服务 https://mcp.oceantoken.ai/mcp 外，设置技能还会使用你的 OCEANTOKEN_API_KEY 调用 OceanToken 自有 API https://api.oceantoken.ai，仅用于检查密钥并配置工具使用该密钥。此插件不会将数据发送给其他服务。请参阅 隐私政策和条款。

支持

提交问题，或发送电子邮件至 [email protected]。