Awesome Claude Code 上手指南:从速查资源到提交新条目的完整流程
【免费下载链接】awesome-claude-codeA hand-picked collection of the finest of resources for the most awesome of agents, Claude Code, the undisputed champion of coding companions, from the unstoppable team at Anthropic PBC. A delectable showcase of top tier skills, ambidextrous agents, scintillating status lines, top notch developer tooling, and also we have plugins项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-claude-code
你每次给 Claude Code 加个状态栏、装个安全护栏,都要翻一堆文档和散落的教程?awesome-claude-code 就是来解决这件事的:它把技能、插件、状态栏、沙箱监控这类 Claude Code 资源按 18 个分类整理成一份带目录的清单,README 由 CSV 数据自动生成,你也能本地跑通整套生成和校验工具链。
这是什么
一句话定位:它不只是资源列表,更是一台"生成列表的机器"。你看到的 README.md 由一份 CSV(资源数据)、一份 config.yaml(分类与顺序)、一个模板三者自动渲染出来,全程可本地复现。
| 你遇到的痛点 | 这个项目给的解法 |
|---|---|
| Claude Code 第三方工具散落各处,找不到想要的 | 带目录的分类 README,每条附一句话说明 |
| 不确定某个资源是否靠谱 | 收录门槛:至少 14 天且持续维护,或 100+ stars |
| 想知道最近又冒出什么新工具 | 页首 Ticker 与 Recently Added 轮播,由脚本从数据刷新 |
| 有自研项目想推荐进去 | 标准 recommend-resource issue 表单 + 机器人校验,不直接开 PR |
🚀 三步跑起来
第一步,获取。克隆仓库进入目录:
git clone https://gitcode.com/GitHub_Trending/aw/awesome-claude-code cd awesome-claude-code make venv make depsmake venv建 Python 虚拟环境,make deps安装运行与开发依赖(运行时只需 PyYAML 和 requests 两个包,见 requirements.txt)。依赖用时间戳文件判断是否需要重装,依赖清单没变时不会重复 pip install。
第二步,安装完成即第三步,验证。跑一遍本地全量生成和测试:
make generate make testmake generate会重建 issue 表单下拉、轮播 SVG 和 README.md,过程幂等,连跑两遍结果逐字节一致;make test执行 tests/ 里的完整 pytest 用例。两者都通过,说明你手上的工具链是好的。
功能按场景拆
🧭 找资源来装:按分类读清单
什么情况下用:你想给 Claude Code 补能力,比如看多会话状态、显示 token 花费、拦截危险操作。
具体怎么用:打开 README.md,从目录直接跳分类。想看多会话监控就去 Session Monitors,清单里的 cctop 是零依赖的终端 TUI,读本地进程表列出每个会话的模型、上下文大小和 git 分支;想控制花费就翻 Usage & Cost;担心 agent 乱删东西看 Security 分类。
得到什么:每条都是可直接安装的资源链接,配一句话说明和 star 数徽章,不用自己判断质量。
加一条、挪一条:Makefile 资源工具
什么情况下用:列表缺一个分类,或者某个条目放错位置了。
具体怎么用:加分类用make add-category CATEGORY="Testing & QA" PREFIX=testing;挪条目用make move-resource ID=docs-1444912b CATEGORY="Skills",其中 ID 可以在 THE_RESOURCES_TABLE_NEW.csv 第一列查到。每条命令只改对应的一行 CSV,然后自动触发全量重新生成。
得到什么:CSV 单行变更,README、表单下拉、轮播图同步更新,不会出现"改了数据忘了刷新页面"的漂移。
刷新列表:Ticker 与 Recently Added
什么情况下用:页首的仓库滚动条和"最近添加"轮播需要更新。
具体怎么用:make ticker分两步走,ticker-data抓取仓库数据写入 data/repo-ticker.csv,ticker-svg再把 CSV 渲染成页首 SVG;make recently-added是纯本地动作,直接从 CSV 生成明暗两套轮播图到 assets/。注意抓取那一步依赖 GITHUB_TOKEN,本地没配只能跑渲染。
🔁 一个端到端实战
以"把一个新资源放进列表"为例,串完整条链路。运行:
make add-resource DISPLAY_NAME="MyTool" CATEGORY="Skills" \ LINK="https://example.com/mytool" AUTHOR="you"脚本内部做四件事:铸造一个不透明 ID、拿 CATEGORY 对照 config.yaml 校验、按链接去重、把新行追加进 CSV,随后自动执行make generate。
中间产物依次是:CSV 里多出一行 Active=TRUE 的记录;scripts/sync_issue_form.py 同步 recommend-resource 表单的分类下拉;generate_readme.py 把 CSV、config 和 templates/README.template.md 渲染回 README.md,你的条目按字母序出现在 Skills 分类下。最终结果:再跑一次make generate输出不变,make test全绿——一次提交,四个文件一致更新。
⚠️ 常见问题与避坑
| 现象 | 处理办法 |
|---|---|
| 生成直接报错退出,提示 Active 条目的 Category 不在 config.yaml 里 | 这是刻意的 fail-closed:用make add-category补上分类,或把该行 Active 置为 FALSE |
make ticker抓不到数据 | 需要先导出 GITHUB_TOKEN 环境变量再重试 |
| 想用 gh CLI 提交资源推荐 | 不行,CONTRIBUTING.md 明确只接受 Web 端 issue 表单,且一次只能推荐一个资源 |
make deps看起来什么都没装 | 时间戳文件判定依赖清单没变就跳过安装;确需重装时删掉 venv/.deps-stamp 再跑 |
| 之前收录的旧资源在列表里找不到 | 属迁移期的正常状态,旧资源暂存在 README_ALTERNATIVES/,之后会迁回新格式 |
🧩 架构一眼看
Makefile 是唯一的总调度入口,所有make目标都指向它编排的这几个 Python 脚本。config.yaml 是分类顺序的唯一事实来源,CSV 是资源内容的唯一事实来源,其余文件全是这两份输入的派生物——所以改数据只需要改这两个文件。
收尾
这份清单适合三类人:找资源装工具的使用者,直接读 README 对应分类即可;有作品想曝光的贡献者,按 CONTRIBUTING.md 的门槛走 issue 表单提交;维护列表的人,用 Makefile 里的资源工具完成增删改移。你的下一步建议很简单:先把 README 的 Start Here 分类读完打基础,再挑一两个贴合当前项目的分类(比如 Security 或 Status Lines)把工具装进自己的 Claude Code 环境里试跑一次。
【免费下载链接】awesome-claude-codeA hand-picked collection of the finest of resources for the most awesome of agents, Claude Code, the undisputed champion of coding companions, from the unstoppable team at Anthropic PBC. A delectable showcase of top tier skills, ambidextrous agents, scintillating status lines, top notch developer tooling, and also we have plugins项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-claude-code
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考