跳到主要内容
AI教程

使用 claude-mods 提升 Claude Code 的可读性

了解如何安装、使用、更新和开发 claude-mods。这是一组小型 Claude Code 插件,可让模型回复更易读,并使工具调用更加紧凑。

使用 claude-mods 提升 Claude Code 可读性

claude-mods 的功能

claude-mods 是一组用于 Claude Code 的插件,旨在让终端会话更易于浏览。目前,该项目提供两个 mod:glamour-dark 和 tool-lines。

  • glamour-dark 使用 glamour 的默认深色样式渲染模型的文本回复。
  • tool-lines 将每次工具调用显示为一行紧凑内容,格式为 tool_call: Tool(input) - meta,并隐藏工具结果块。

使用这些 mod 可以减少视觉干扰,帮助你在 Claude Code 会话中注意到重要细节。

前置条件

你需要安装 Claude Code,并确保可以通过 claude 命令使用它。安装过程会使用 Claude Code 的插件市场和插件命令。

从命令行安装插件

首先,将该仓库添加为 Claude Code 插件市场:

claude plugin marketplace add Tickloop/claude-mods

然后安装一个或两个可用的 mod:

claude plugin install glamour-dark@claude-mods
claude plugin install tool-lines@claude-mods

安装完成后,Claude Code 会按照正常的插件加载行为使用这些插件。

在 Claude Code 会话中安装

你也可以在 Claude Code 会话打开时添加该市场:

/plugin marketplace add Tickloop/claude-mods

接下来,打开 /plugin,选择要安装的 mod。如果你希望在不离开当前会话的情况下管理插件,这种方式会很实用。

要在不重启 Claude Code 的情况下应用已安装或发生更改的插件,请运行:

/reload-plugins

选择合适的 mod

使用 glamour-dark 优化格式化回复

如果你希望让 Claude 的文本回复在深色终端界面中更易阅读,请安装 glamour-dark。它会将 glamour 的默认深色样式应用于模型回复。

使用 tool-lines 显示紧凑的工具活动

如果你希望以紧凑的单行格式概览工具活动,请安装 tool-lines。该 mod 会隐藏结果块,并将每次调用显示为:

tool_call: Tool(input) - meta

如果你希望在同一会话中同时获得格式化的模型回复和更简洁的工具输出,可以安装两个 mod。

更新 mod

当新版本在其 plugin.json 中更改了 mod 的版本时,请先更新市场元数据:

claude plugin marketplace update claude-mods

然后更新你想刷新的具体插件:

claude plugin update glamour-dark@claude-mods

如果要更新 tool-lines mod,请将插件名称替换为 tool-lines@claude-mods。在打开的会话中,运行以下命令切换到新版本:

/reload-plugins

在本地开发或测试 mod

要参与项目开发,请克隆仓库,并从仓库根目录启动 Claude Code,同时加载两个 mod 目录:

claude --plugin-dir ./glamour-dark --plugin-dir ./tool-lines

--plugin-dir 选项仅会为当前会话加载 mod。你可以利用它测试本地更改,而无需全局安装插件。

每次都加载本地 mod

如果你正在积极开发这些 mod,并希望它们在每次 Claude Code 会话中都加载,请将别名添加到 shell 配置中。README 为 ~/.zshrc 或 ~/.bashrc 提供了以下示例:

alias claude='command claude --plugin-dir ~/path/to/claude-mods/glamour-dark --plugin-dir ~/path/to/claude-mods/tool-lines'

将 ~/path/to/claude-mods 修改为你克隆仓库的位置。添加别名后,重新加载 shell 配置或启动新的终端会话,使该别名生效。

实用工作流建议

  • 如果你只想改善回复样式而不改变工具显示,请仅安装 glamour-dark。
  • 如果你的主要目标是让工具活动更加紧凑,请仅安装 tool-lines。
  • 安装两个 mod,获得完整的可读性优化配置。
  • 在打开的会话中安装或更新插件后,使用 /reload-plugins。
  • 测试本地开发更改时,使用 --plugin-dir 仅为当前会话加载插件。
  • 如果希望自动加载本地克隆的 mod,请使用 shell 别名。

结语

claude-mods 提供了两个专注于提升终端可读性的 Claude Code 插件。安装 glamour-dark 可获得深色样式的模型回复,安装 tool-lines 可显示紧凑的工具调用,也可以同时安装两者。市场命令支持安装和更新,本地插件目录则让开发与测试变得简单直接。