它到底是什么

--channels 是 Claude Code CLI 的启动 flag，用于指定本次会话中 Claude 应该监听通知的 channel（频道）。一个 channel 本质上是一个 MCP 服务器，会把终端外部发生的事件（聊天消息、webhook、告警、CI 结果等）推送进正在运行的 Claude Code 会话，使 Claude 能在你不在终端前时做出反应。

接受值是空格分隔的条目列表，每个条目格式为 plugin:<name>@<marketplace>（也可以传多个，一次启用多个 channel）。目前处于**研究预览（research preview）**阶段，官方文档明确提示：--channels 的 flag 语法和协议约定未来可能变化。

截至目前可访问的官方文档，--channels 和其配套的 --dangerously-load-development-channels 不会出现在 claude --help 的输出里——即便处于预览期被隐藏，两个 flag 依然可以正常使用。

用法

claude --channels plugin:my-notifier@my-marketplace

启用多个 channel（空格分隔）：

claude --channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-official

官方给出的实际示例（Telegram / Discord / iMessage / fakechat 均来自 claude-plugins-official 市场）：

claude --channels plugin:telegram@claude-plugins-official
claude --channels plugin:discord@claude-plugins-official
claude --channels plugin:imessage@claude-plugins-official
claude --channels plugin:fakechat@claude-plugins-official

使用前提：channel 必须先通过 /plugin install <name>@<marketplace> 安装，且插件运行依赖 Bun。

与其他 flag 的组合 / 互斥

• --dangerously-load-development-channels：与 --channels 是并列关系但用途不同。--channels 在预览期只接受 Anthropic 维护的允许列表（或组织自定义的 allowedChannelPlugins）里的插件；--dangerously-load-development-channels 则用于本地开发测试未上允许列表的 channel，接受 plugin:<name>@<marketplace> 或 server:<name> 两种格式，且会弹出确认提示。
• -p（非交互/headless 模式）：channels 可以和 -p 一起用，但在此模式下，需要终端输入的工具（多选题、plan mode 审批等）会被禁用，避免会话因等待输入而卡死。
• --dangerously-skip-permissions：官方文档在无人值守场景里提到可配合使用来跳过大多数权限提示，但同时强调仅应在受信任环境使用，且该模式下"无论如何都会自动批准的动作"限制依然生效。
• 仅在 .mcp.json 里声明 channel 服务器是不够的：服务器必须同时被 --channels 显式命名，否则不会推送消息。
• 与 MCP_PROTOCOL_NEGOTIATION=auto（v2 MCP client）的冲突见下方"常见坑"。

在 settings.json / env 的等价配置

--channels 本身没有直接等价的 env var 或 settings.json 字段——它是每次会话都要显式传入的 opt-in flag。但组织层面有两个相关的托管设置（managed settings）会决定 --channels 能否生效：

allowedChannelPlugins 配置示例（来自官方文档）：

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

此外，具体 channel 插件（如 Telegram）的凭证通过插件自身的 /xxx:configure 命令保存到 ~/.claude/channels/<name>/.env，也可以提前在 shell 里设置对应 env var（例如 TELEGRAM_BOT_TOKEN、DISCORD_BOT_TOKEN）——这些是插件级配置，不是 --channels flag 本身的等价物。

运行约束 / 限制

经典使用场景

以下场景均来自官方文档的实际描述：

• 聊天桥接（chat bridge）：通过 Telegram / Discord / iMessage，在离开电脑时用手机向 Claude 提问，Claude 在本机对真实文件继续工作，回复出现在同一个聊天里。
• Webhook 接收器：把 CI 结果、错误追踪、部署流水线等外部事件推送到已经打开相关文件、了解调试上下文的 Claude 会话中，让 Claude 主动响应。
• 快速验证 channel 机制：使用官方内置的 fakechat 插件（本地 localhost:8787 聊天界面，无需任何外部凭证）先跑通流程，再切换到 Telegram/Discord/iMessage。
• 无人值守但受控的场景：结合 -p 非交互模式或 --dangerously-skip-permissions，让 channel 消息触发的操作不会因等待终端输入而卡住（但官方强调仅限受信任环境）。

常见坑

• 只在 .mcp.json 里声明不够：channel 服务器必须同时出现在 --channels 参数里才会真正投递消息，否则该 MCP 服务器照常连接、工具照常可用，但 channel 通知不会到达。
• allowedChannelPlugins 设为空数组并不能彻底封锁：这只会挡住默认允许列表，--dangerously-load-development-channels 仍可以绕过它用于本地测试；要彻底禁用（包括开发 flag），需要保持 channelsEnabled 未设置而不是设为空数组。
• MCP_PROTOCOL_NEGOTIATION=auto（v2 MCP client）会导致注册失败：如果协商到协议版本 2026-07-28，Claude Code 不会为该 channel 服务器完成注册。
• 组织默认阻塞却没有报错：claude.ai Team/Enterprise 组织若未开启 channelsEnabled，MCP 服务器仍能正常连接、工具仍可调用，只是 channel 消息不会到达，仅在启动时给出一条提醒用户联系管理员开启的警告，容易被误判为插件本身故障。
• 传入未在允许列表上的插件不会报错中止：Claude Code 会正常启动，但该 channel 不会注册，启动提示里会说明"插件不在组织允许列表上"，需要仔细看启动时的提示行才能发现。

来源

• Channels reference（channels-reference）— code.claude.com
• Push events into a running session with channels（channels）— code.claude.com
• CLI reference（cli-reference）— code.claude.com