ccckfg

Cc Music — Development skill for Claude Code

Development community

在 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 说“来点适合写代码的歌”,音乐就在后台响起来了。你接着写你的代码,它接着放它的歌。

![Claude Code 对话区、迷你播放器和 cc-music 侧边栏](docs/images/player.svg)

✨ 都有些什么

  • 🎶 点歌、切歌、调音量:搜索、播放、暂停、上一首下一首、拖进度、单曲循环,一条命令搞定。
  • 🖼️ 侧边栏播放器:块字符画的封面、跟着节奏跳的音符、频谱动画,还有卡拉 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`,点上面的图标在**正在播放、搜索、队列、收藏、历史、设置**之间切换。