企业官网建设流程全解析

1. 长任务盯屏这件事，其实有原生解法

Claude Code 跑长任务时最反人类的体验，不是它写得慢，而是你根本不知道它什么时候需要你。它可能在第 3 分钟就卡在权限确认上等你点同意，也可能在第 15 分钟才把整个重构跑完，而你全程只能隔几秒切回终端看一眼。这种「人肉轮询」的注意力消耗，比写代码本身还累。

我试过用番茄钟硬扛，结果要么提前切回来发现它还在跑，要么错过授权请求白白等了十分钟。后来才意识到，Claude Code 本身就带了一套 hooks 机制，专门解决「什么时候该通知你」这个问题。它有两个事件特别关键：Notification在需要你批准工具调用、或者停下来等你输入时触发；Stop在主 agent 回合结束、任务停下时触发。这两个事件配合系统提示音，就能把「盯屏」变成「听声」。

这篇要做的，是把 Claude Code 的模型通道接到 TaoToken，再用原生 hooks 把提示音配起来。TaoToken 在这里只负责提供 Key 和 Base URL，提示音逻辑完全由 Claude Code 自己完成，不依赖任何第三方插件。适合已经在用 Claude Code 写代码、但被长任务折磨得不敢离开工位的人。

2. 先把模型通道接到 TaoToken

Claude Code 默认走的是官方通道，但如果你想让请求走 TaoToken 的 API 网关，需要在环境变量里把 Base URL 指过去。这一步和提示音无关，但它是前置条件——通道不通，hooks 配得再对也没用。

打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建 Key，然后在 Claude Code 的配置里把 Base URL 填成https://taotoken.net/api。注意这里不要加 UTM 参数，API 地址就是干净的https://taotoken.net/api。

具体操作上，Claude Code 读取的是~/.claude/settings.json里的env字段。Windows 下路径是C:\Users\你的用户名\.claude\settings.json。如果你之前已经配过env，直接在里面追加两行即可：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "你的TaoToken Key" } }

这里有个容易踩的坑：ANTHROPIC_API_KEY填的是 TaoToken 创建的 Key，不是 Anthropic 官方的 Key。两者格式可能相似，但走的是不同网关。填错的话 Claude Code 会报 401，但错误信息不会直接告诉你 Key 来源不对，只会说认证失败。

改完env后，重启 Claude Code 会话让环境变量生效。你可以用一个简单请求验证通道是否通了，比如让它读一个本地文件或者跑一条echo命令。如果它能正常返回结果，说明 Base URL 和 Key 都对了。

3. 追加 Notification 和 Stop 两个 hooks

通道通了之后，就可以动 hooks 了。Claude Code 的 hooks 配置和env是并列关系，追加在settings.json顶层即可，不会影响已有的statusLine、enabledPlugins等字段。

先备份原文件，这是习惯动作：

Copy-Item "C:\Users\yfx\.claude\settings.json" "C:\Users\yfx\.claude\settings.json.bak"

然后在settings.json里追加hooks字段。完整的结构如下：

{ "hooks": { "Notification": [ { "matcher": "", "hooks": [ { "type": "command", "command": "powershell -NoProfile -Command \"[System.Media.SystemSounds]::Hand.Play()\"", "timeout": 10 } ] } ], "Stop": [ { "matcher": "", "hooks": [ { "type": "command", "command": "powershell -NoProfile -Command \"[System.Media.SystemSounds]::Asterisk.Play()\"", "timeout": 10 } ] } ] } }

两个事件的语义要分清楚：Notification用Hand音，表示「该你了」，触发时机是 Claude 需要你批准工具调用、或者空闲等你输入超过约 60 秒；Stop用Asterisk音，表示「干完了」，触发时机是主 agent 回合结束。这样你听到 Hand 就知道要回去点同意，听到 Asterisk 就知道可以回来收结果了。

matcher留空字符串表示匹配所有情况，timeout设 10 秒是给 PowerShell 播放声音留足时间，实际播放是毫秒级的，不会真的等 10 秒。

如果你本机的settings.json里已经有其他顶层字段，比如env、statusLine，直接把hooks作为新的顶层键加进去就行，JSON 的键顺序不影响解析。改完后用 Python 的 JSON 解析器验证一下合法性：

import json with open(r"C:\Users\yfx\.claude\settings.json", "r", encoding="utf-8") as f: data = json.load(f) print(list(data.keys())) print(data["hooks"]["Notification"][0]["hooks"][0]["command"])

如果输出里能看到hooks键，并且命令字符串和预期一致，说明配置写对了。

4. 验证提示音是否真的响

配置写完不代表生效，Claude Code 需要重启会话才会重新加载settings.json。重启之后，你可以用一个简单任务触发Stop事件：让它跑一条echo hello或者读一个文件。任务结束时，你应该能听到 Asterisk 音。

Notification事件的触发稍微麻烦一点，因为它需要 Claude 主动请求权限。你可以让它执行一条需要确认的命令，比如删除一个临时文件，或者写入一个受保护目录。当它弹出权限确认时，Hand 音应该会响。

如果两个声音都没响，先检查 PowerShell 能不能单独播放声音。在终端里直接跑：

powershell -NoProfile -Command "[System.Media.SystemSounds]::Hand.Play()"

如果这条命令本身没声音，说明是系统声音方案的问题，不是 Claude Code 配置的问题。去 Windows 设置里检查「声音」→「声音方案」，确保 Hand 和 Asterisk 都有对应的音频文件。

如果 PowerShell 能响但 Claude Code 不触发，检查settings.json的路径对不对。Windows 下是C:\Users\你的用户名\.claude\settings.json，注意.claude前面有个点，不是claude。另外确认你重启的是 Claude Code 会话，不是只关了终端窗口。

想换自定义提示音的话，把命令里的[System.Media.SystemSounds]::Hand.Play()换成播放 wav 文件的写法：

powershell -NoProfile -Command "(New-Object Media.SoundPlayer 'C:\path\to\your.wav').Play()"

这样就能用自己喜欢的音频文件替代系统音了。

5. 本篇常见错排查

报错一：401 认证失败。大概率是ANTHROPIC_API_KEY填错了，检查是不是把 Anthropic 官方的 Key 填进去了。TaoToken 的 Key 需要在 https://taotoken.net/api-keys 单独创建，不要混用。

报错二：hooks 不触发。先确认settings.json是合法 JSON，用上面的 Python 脚本验证。如果 JSON 里有尾随逗号或者引号转义错误，Claude Code 会静默忽略整个 hooks 字段，不会报错但也不会触发。

报错三：PowerShell 命令被拦截。某些安全软件会拦截powershell -Command的调用。如果声音不响但手动跑命令能响，检查一下安全软件的日志。可以把命令改成cmd /c加rundll32的方式，但 PowerShell 的方案在 Windows 10/11 上兼容性最好。

报错四：改了 settings.json 但没生效。Claude Code 只在会话启动时读取配置，改完必须重启会话。如果你是在会话中途改的，当前会话不会加载新配置。

报错五：Notification 不触发。这个事件只在 Claude 需要权限确认或者空闲等你输入时触发。如果你用的是全自动模式，或者任务本身不需要交互，它就不会响。这是正常的，不是配置问题。

6. 接上之后，你可以离开工位了

把 Claude Code 的模型通道接到 TaoToken，再用原生 hooks 配上 Notification 和 Stop 两个提示音，整个链路就通了。TaoToken 在这里只做了一件事：提供 Key 和 Base URL，让请求能走通。提示音的逻辑完全由 Claude Code 自己的 hooks 机制完成，不需要装任何额外插件。

配好之后，你交给它一个长任务，就可以去倒杯水或者处理别的事情。听到 Hand 音就回来点授权，听到 Asterisk 音就回来收结果。不用再隔几秒切回终端看一眼，注意力可以真正放在别的事情上。

如果你还想把模型对话、Coding Plan 或者 API Keys 的管理也接进来，可以走这几个入口：模型对话在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite ，长期编码和 Agent 场景看 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，Key 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite ，接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite 。Claude Code 相关的配置可以参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite 。

最后提醒一句：改settings.json之前一定先备份，JSON 格式对引号和逗号很敏感，手改容易出错。用 Python 脚本追加字段比手动编辑更稳，至少能保证解析通过。