Cc Music — Development skill for Claude Code
在 Claude Code 里听音乐:点歌、侧边栏播放器、歌词、队列与收藏,支持插件市场安装.
How to install Cc Music
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open ccckfg/cc-music and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Cc Music does
在 Claude Code 里听音乐:点歌、侧边栏播放器、歌词、队列与收藏,支持插件市场安装.
Alternatives in Development
- Music Genre Finder — 🎵 Intelligent music genre search with 5947 genres from RateYourMusic - Claude Code skill for quick lookup, sm 158 ★
- Better Statusline — A status line for Claude Code: the session's figures as dot-matrix rings, and the music you are playing beside 119 ★
- Applemusic MCP — Apple Music MCP server: playlists, library, catalog, playback and the Up Next queue, on macOS, Windows and Lin 118 ★
README
🎵 cc-music
**写代码的时候,让 Claude 顺手放首歌。** 🎧
敲一句 `/music 晴天 周杰伦`,或者直接跟 Claude 说“来点适合写代码的歌”,音乐就在后台响起来了。你接着写你的代码,它接着放它的歌。

✨ 都有些什么
- 🎶 点歌、切歌、调音量:搜索、播放、暂停、上一首下一首、拖进度、单曲循环,一条命令搞定。
- 🖼️ 侧边栏播放器:块字符画的封面、跟着节奏跳的音符、频谱动画,还有卡拉 OK 式逐字染色的歌词。
- 📻 迷你播放器:常驻输入框上方,瞄一眼就知道在放什么,顺手就能暂停。
- 📚 队列、收藏、历史:搜到喜欢的,立刻播放或者排到后面,听过的都有记录。
- 💬 动嘴就行:Claude 会调用插件的
music工具,命令记不住也没关系。 - 📺 两个音源:默认哔哩哔哩,国内直连;也能用 YouTube Music。
播放器是一个独立的后台进程:Claude Code 关了、插件热重载了,音乐都不停,几个会话还能共用一个播放器。没在放歌且 30 分钟没人理它,它会自己退出;想马上关掉就 `/music quit`。
📦 安装
1. 🧰 先备好这几样
| 软件 | 版本 | 干什么用 |
|---|---|---|
| Claude Code | 2.1.288+(支持 mods) | 加载命令、工具和播放器界面 |
| Node.js | 22.18+ | 跑后台播放器 |
| mpv | 最新即可 | 真正出声的那个 |
| yt-dlp | 越新越好 | 从音源页面取音频 |
| ffmpeg | 可选,强烈推荐 | 画封面 |
Windows 用户有 [Scoop](https://scoop.sh/) 的话,一行搞定:
scoop install mpv yt-dlp ffmpeg
# Node.js 版本不够的话再加上:
scoop install nodejs-lts
装完重开一下终端,`node --version`、`mpv --version`、`yt-dlp --version` 都能跑就妥了 ✅
2. 🛒 从插件市场安装(推荐)
在 Claude Code 里输入:
/plugin marketplace add ccckfg/cc-music
/plugin install cc-music@cc-music
界面、后台和 npm 依赖会一起装好。重开一个会话,来一首试试:
/music 晴天 周杰伦
第一次会顺便把后台播放器拉起来,稍等几秒就响了 🎉
🤖 懒人法:让 agent 帮你装
把这句话丢给 Claude Code 或任何能跑命令的 coding agent:
帮我安装 https://github.com/ccckfg/cc-music:检查 Claude Code、Node.js(>= 22.18)、mpv、yt-dlp、ffmpeg 是否就绪,缺什么先告诉我;然后通过插件市场添加 ccckfg/cc-music 并安装 cc-music@cc-music,装好后提醒我重开会话。
🛠️ 从源码跑
git clone https://github.com/ccckfg/cc-music.git
cd cc-music
npm ci
claude --plugin-dir .
`.` 就是仓库根目录,整个仓库就是一个插件。
🎤 开始听歌
🔍 点歌
/music 晴天 周杰伦
/music bili:稻香 周杰伦
/music yt:Yellow Coldplay
直接播放第一个搜索结果。“歌名 + 歌手”最准。
想挑一挑再放:
/music search 晴天 周杰伦
/music 2
序号就是刚才那次搜索的结果。点歌会插在当前这首后面并马上切过去,原来的队列一首不少。
或者干脆跟 Claude 聊 💬
放点周杰伦的歌。
把稻香加入队列。
下一首,音量调到 40。
现在放的是什么?帮我收藏。
🎛️ 打开面板
输入 `/music`,点上面的图标在**正在播放、搜索、队列、收藏、历史、设置**之间切换。
Related Skills
Music Composition Skills
Professional agent skills for composing and arranging popular music
Add Music
Generate background music and add it to your Remotion project. Describe the mood/genre you want, and this will
Generate Assets
Generate real game assets — images, textures, skyboxes, 3D models, SFX, music, voice, and intro/cinematic vide
Qiaomu Music Player Ncm
网易云音乐全能助手。安装配置、播放控制、搜索、队列管理、场景音乐推荐、 每日推荐、心动模式、私人漫游FM、雷达歌单、红心管理、听歌排行、歌词查询、 偏好分析、智能推荐、定时推送调度。 USE THIS SKILL whe
Htmlstyleguides 1hk
Integrate background music from audio tracker
Dj Claude
DJ Claude — the only music MCP server with multi-agent collaboration
Related Agents
Audio Designer
Designs reactive audio, music, SFX, and functional mix behavior.
Suno Songwriter
Professional songwriter that creates songs for Suno AI. Use proactively when the user wants to create songs, w
Style Page Builder
Generate a single-file HTML page for the 「島嶼共鳴 2026」music festival using a specified design skill. Invoked onc