1. Claude Code 长任务跑完没人喊你bark-notify 把完成提醒推到 iPhoneClaude Code 有个很实际的体验问题它经常一跑就是几分钟甚至十几分钟中间你切去写文档、回消息、开另一个项目然后就开始反复切回终端看它到底跑完没有。公司环境里开声音提醒不太合适手机通知反而更自然。bark-notify 就是解决这件事的 Claude Code 插件——当 Claude Code 完成一轮任务、等待授权、执行出错或会话异常结束时通过 Bark 给 iPhone 推一条通知。它适合主要用 Claude Code CLI、iPhone 上装了 Bark、又不想配飞书/钉钉/邮箱那套重权限方案的人。我试过同时开三个 Claude Code 窗口跑不同项目以前每隔两分钟就要切回去看一眼现在手机一震就知道是哪个项目需要处理。通知标题默认是当前项目目录名所以多窗口场景下一眼能分辨。整条链路其实就三段Bark 客户端拿到推送 URLbark-notify 插件挂到 Claude Code 的 hooks 上TaoToken 统一 Key 通道负责模型请求的 endpoint 与 auth.json 配置。前两段是提醒闭环第三段是让 Claude Code 本身能正常跑起来。这篇把三段串成一条可复制的路径目标 10 分钟内跑通。需要提前说明的是Bark 目前只有 iOS 版本没有安卓版。如果你用的是安卓手机这条链路走不通可以考虑换其他通知方案。下面所有步骤都在 macOS 上验证过Windows 下路径换成对应用户目录即可。核心检索词先摆出来bark-notify 是 Claude Code 的完成提醒插件Bark 是 iPhone 上的推送客户端Claude Code 是 Anthropic 的命令行编码工具TaoToken 是统一 Key/API 通道。四者关系是Claude Code 跑任务bark-notify 监听任务状态Bark 负责把状态推到手机TaoToken 负责 Claude Code 的模型请求通道。2. TaoToken 统一 Key 通道前置配置endpoint 与 auth.json 怎么写在挂 bark-notify 之前得先保证 Claude Code 本身能正常请求模型。如果你已经能跑 Claude Code这一段可以快速扫过如果还没配好这里把 endpoint 和 auth.json 一次写清楚。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数。官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content需要看文档或拿 Key 的时候从官网进。Claude Code 读取配置的位置在用户目录下的.claude文件夹。不同版本可能读settings.json或auth.json这里两个都给出来你按自己版本对照。先看~/.claude/settings.json里跟模型通道相关的片段。这个文件同时承载 hooks 配置所以后面 bark-notify 也会往这里写注意不要手动覆盖掉已有内容{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey } }如果你用的是auth.json形式结构类似{ baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: claude-sonnet-4-20250514 }三件套对照表方便你检查有没有漏配置项值说明Base URLhttps://taotoken.net/api不带 UTM不带尾斜杠API Keysk-开头从 console 的 API Keys 页面获取Model ID如claude-sonnet-4-20250514按你实际可用的模型填Key 的获取路径是进 console 后找 API Keys 页面新建。如果你还没决定用哪个模型可以先去模型对话页面试一下请求是否通再回来填 Model ID。这里有个容易踩的坑Base URL 末尾多写一个斜杠或者把官网地址误填进去。官网地址带 UTM 参数是给人看的页面不是 API endpoint。API 只认https://taotoken.net/api。配好之后先在终端里跑一次最简单的 Claude Code 请求确认模型通道是通的。如果这一步就报 401先别往下走 bark-notify先把 Key 和 Base URL 对齐。通道不通的情况下bark-notify 只会推「出错」通知你会以为是插件问题其实是模型请求根本没发出去。另外提醒一句settings.json是 JSON 格式不能写注释不能有多余逗号。改完可以用python -m json.tool ~/.claude/settings.json校验一下语法省得 Claude Code 启动时静默失败。3. bark-notify 插件挂载与可复制 settings 片段这一段是提醒闭环的核心。分三步装 Bark、装插件、写 hooks。第一步iPhone 上装 Bark。打开 App 后首页会显示你的推送地址形如https://api.day.app/你的设备key。这个 key 就是这台 iPhone 的收件地址复制下来待会 setup 要用。如果你在意隐私可以在 Bark 里开加密模式bark-notify 支持 AES-128-CBC正文在离开 Mac 之前就加密。第二步在任意 Claude Code 会话里执行三条命令装插件/plugin marketplace add RUIIIOVO/claude-code-bark-notify /plugin install bark-notifybark-notify /reload-plugins装完后 Claude Code 会识别到插件里的 slash command。接着跑 setup/bark-notify:bark-notify-setupsetup 会依次问你 Bark 推送 URL、是否用加密模式、加密模式下再问一个 16 位密钥。如果选加密模式iPhone 端 Bark 里也要设成一致Algorithm 选 AES128Mode 选 CBCPadding 选 pkcs7Key 填和 setup 里一样的 16 位密钥IV 随便填一个 16 位字符串用于保存配置真实推送时会用请求里的 IV。setup 会在本机做两件事写入~/.claude/claude-stop-bark.sh本地发送脚本合并写入~/.claude/settings.json的 Claude Code hooks。它不会覆盖你已有的其他设置这点可以放心。第三步确认 hooks 片段写进去了。打开~/.claude/settings.json应该能看到类似这样的结构{ hooks: { Stop: [ { hooks: [ { type: command, command: bash ~/.claude/claude-stop-bark.sh stop } ] } ], Notification: [ { hooks: [ { type: command, command: bash ~/.claude/claude-stop-bark.sh notification } ] } ] } }注意这个片段要和你第 2 段写的env或auth.json共存不是二选一。如果你之前手动改过settings.jsonsetup 会做合并但保险起见还是自己看一眼有没有把env段冲掉。bark-notify 支持的事件类型和通知级别对照场景通知正文Bark levelClaude 一轮回答正常结束Claude Code 已完成activeClaude 等待你授权工具调用Claude Code 等待操作timeSensitiveClaude 一轮回答因错误中断Claude Code 出错timeSensitiveClaude Code 会话异常结束Claude Code 会话异常结束timeSensitive用户主动 /exit、/clear、/logout静默-输入框空闲 60 秒内置提醒静默-这里把「等待授权」和「普通完成」分开是有意的普通完成你有空再回去看结果就行等待授权意味着 Claude 已经停住了需要你回终端点确认。timeSensitive 级别在 iPhone 上能穿透专注模式适合这两种需要及时响应的场景。4. 验证请求发一条测试通知并跑一次真实任务配置写完不验证等于没配。bark-notify 提供了一个测试命令/bark-notify:bark-notify-test如果 iPhone 收到一条 Bark 通知说明从 Mac 到 Bark 服务器的链路是通的。这一步只验证通知通道不验证 Claude Code 的 hooks 是否触发。接着做一次真实任务验证。随便在 Claude Code 里发一个会跑十几秒的请求比如让它读一个文件并总结。任务结束后你应该在 iPhone 上收到一条标题为当前项目目录名、正文为「 Claude Code 已完成」的通知。如果测试通知收到了但真实任务结束没收到问题大概率在 hooks 没触发而不是 Bark 通道。这时候检查~/.claude/settings.json里的 hooks 段是否完整以及~/.claude/claude-stop-bark.sh是否存在、有没有执行权限ls -l ~/.claude/claude-stop-bark.sh chmod x ~/.claude/claude-stop-bark.sh再验证一次等待授权场景。让 Claude Code 执行一个需要你确认的工具调用比如写文件或跑命令。当它停下来等你授权时iPhone 应该收到「 Claude Code 等待操作」级别是 timeSensitive。这个场景比完成通知更有用因为 Claude 是真的卡住了你不回去它就一直等。验证通过后日常使用就是开多个 Claude Code 窗口跑不同项目手机放旁边哪个项目需要处理通知标题会告诉你。不用再反复切终端。如果你还想验证模型通道本身是否稳定可以顺手去模型对话页面发一条请求确认 TaoToken 的 Key 和 endpoint 在长时间使用下没有异常。这一步和 bark-notify 无关但能帮你排除「通知收到了、但任务其实是因为模型请求失败才结束」这种误判。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一段按真实报错对照遇到哪个查哪个。401 报错。这是模型通道的认证问题跟 bark-notify 无关。检查ANTHROPIC_API_KEY或auth.json里的apiKey是不是sk-开头、有没有多余空格、有没有过期。Base URL 确认是https://taotoken.net/api不带尾斜杠。如果 Key 是从 console 复制的注意别把前后空白也复制进去。local proxy failed。这个报错通常出现在 Base URL 填错或网络请求被本地环境拦截时。先确认 Base URL 没有写成官网地址官网地址带 UTM 参数不是 API endpoint。再确认没有在settings.json里同时配了两套冲突的 env。reading choices 相关报错。这类报错一般是响应体解析失败常见原因是 Model ID 填了一个当前 Key 不可用的模型或者请求返回的不是预期格式。去模型对话页面确认你的 Key 能用哪些模型把auth.json里的model字段改成实际可用的。OAuth 相关报错。如果你之前用过 OAuth 登录方式auth.json里可能残留了旧字段和新的apiKey配置冲突。把auth.json里跟 OAuth 相关的字段清掉只保留baseUrl、apiKey、model三件套。通知收到了但内容是「出错」。这说明 bark-notify 正常工作但 Claude Code 那一轮任务失败了。往上翻终端日志看具体错误大概率是上面某一种模型通道问题。bark-notify 只是把失败状态推给你它不负责修复模型请求。测试通知收不到。先确认 Bark 推送 URL 完整复制包括https://api.day.app/前缀和设备 key。如果开了加密模式确认 iPhone 端 Bark 的 Algorithm、Mode、Padding、Key 和 setup 里填的一致。IV 不一致不影响因为真实推送用请求里的 IV。hooks 不触发。检查settings.json里 hooks 段的 JSON 语法用python -m json.tool校验。确认claude-stop-bark.sh有执行权限。确认/reload-plugins执行过。卸载的话执行/bark-notify:bark-notify-uninstall它会移除~/.claude/settings.json里的 Bark hook 并删除本地脚本不会动你的模型通道配置。6. 把提醒闭环和统一 Key 通道一起用起来整条链路跑通后日常状态是这样的Claude Code 在 Mac 上跑任务bark-notify 通过 hooks 监听完成、等待授权、出错、异常结束四种事件Bark 把通知推到 iPhone通知标题是项目目录名。模型请求走 TaoToken 统一 Key 通道endpoint 是https://taotoken.net/apiauth.json 里三件套对齐。如果你还没拿 Key去 API Keys 页面新建一个。接入文档在 doc 页面里面有各客户端的配置示例。想先验证模型通道是否通去模型对话页面发一条请求最快。长期用 Claude Code 跑编码任务或 Agent 的话Coding Plan 比按量更划算具体在 coding-plan 页面看。最后留一个实用技巧通知标题默认是项目目录名如果你同时开多个 Claude Code 窗口建议把项目目录名起得有区分度比如proj-a-api、proj-b-web这样手机上一眼就知道该切回哪个终端。另外「等待授权」是 timeSensitive 级别会穿透专注模式如果你在开会不想被打断可以在 Bark 里单独把这个级别调低但代价是 Claude 卡住等你授权时你可能不知道。这个取舍按你自己的工作节奏来。