---
title: "hitokoto：Claude Code の入力欄の上に表示される一言"
url: "https://claudemods.dev/ja/builds/hitokoto-cea84b"
source: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/hitokoto"
source_type: "github"
repo: "https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/hitokoto"
author: "hoobnn"
author_handle: "hoobnn"
stars: 8
category: "ツール・連携"
categories: ["tools"]
tags: ["Claude Code", "mod"]
permission_level: 3
scan_complete: false
install: "claude plugin marketplace add hoobnn/hoobnn-agent-mods\nclaude plugin install hitokoto@hoobnn-agent-mods"
added: "2026-10-04T10:40:35.446Z"
updated: "2026-11-09T14:28:07Z"
locale: "ja"
content_locale: "ja"
---

# hitokoto：Claude Code の入力欄の上に表示される一言

hitokoto：プロンプトの上に Hitokoto（一言）の一節を表示するバンド。タイマー、セッションごと、プロンプトごと、または 1 日 1 回更新されます。

## Description

# hitokoto：Claude Code の入力欄の上に表示される一言

**簡体字中国語** · [English](README.en.md)

入力欄の上に[一言](https://hitokoto.cn)を表示します。詩歌、文学、アニメのセリフ、または哲学的な短句で、後ろに作者と出典が淡淡と添えられます。Claude が作業するのを待つ間に、ついでに一句読めます。

![hitokoto：入力欄の上の一言と出典](assets/preview.png)

## 機能

- **一言と出典**：文の後ろに作者と出典があり、末尾の `↻` をクリックすると別の一句に変わります（`daily` モードではこのボタンはありません）。
- **4 つの切り替え方法**：定時切替（デフォルトは 30 分ごと）、毎日一句（全セッションで同じ一句、0 時を過ぎると新しい一句に変わる）、セッションごとに一句、メッセージ送信ごとに一句。
- **カテゴリで選ぶ**：詩歌、文学、哲学などのカテゴリだけを指定できます。
- **通信量を節約、空白なし**：バーが非表示のときはリクエストしません。同時に 1 つのリクエストのみ送信し、10 秒応答がなければ失敗とみなします。前回取得した文は保存され、新しいセッションやオフライン時にそれを直接表示するので、空白になりません。
- `claude -p` および SDK ではリクエストしません。

## インストール

```sh
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hitokoto@hoobnn-agent-mods
```

## コマンド

- `/hitokoto`：すぐに別の一句に変えます（`daily` モードでは今日の一句を置き換えます）。
- `/hitokoto off`、`/hitokoto on`：バーを非表示または表示します。この設定は `/config` に書き戻され、以降のセッションでも引き継がれます。再表示時にはまず新しい一句を取得します。

## オプション

`/config` で変更するか、`~/.claude/settings.json` の `pluginConfigs` に記述します：

| オプション | 効果 | デフォルト |
| --- | --- | --- |
| `visible` | バーを表示（`/hitokoto off` / `on` が変更するもの） | オン |
| `refreshMode` | `interval` 定時切替、`daily` 毎日一句、`session` セッションごとに一句、`prompt` メッセージごとに一句 | `interval` |
| `categories` | 一言のカテゴリ文字。カンマ区切り、空欄で無制限。a アニメ、b 漫画、c ゲーム、d 文学、e オリジナル、f ネット、g その他、h 映画・テレビ、i 詩歌、j NetEase Cloud、k 哲学、l ジョーク、例 `d,i,k` | 空 |
| `intervalMinutes` | `interval` モードで何分ごとに切り替えるか（最低 1） | 30 |
| `language` | `/hitokoto` の返信とエラーの言語：`auto`、`en`、`zh-Hans`、`zh-Hant`、`ja`、`ko`、`es`、`fr`、`de`、`pt-BR`、`ru`（文自体は中国語） | `auto` |

`language` が `auto` の場合、Claude Code の `language` 設定、システムロケールの順に従い、どちらもなければ英語を使用します。

## 同シリーズの mod

[hoobnn-agent-mods](../../README.md) には、ステータスバー HUD（`hud`）、タスク進捗バー（`todo-bar`）、ターンレシート（`receipt`）、実行アニメーションとペット（`spinner`）、Tailscale ノードステータス（`ts-band`）もあり、組み合わせて使用できます。

## 開発

- `hooks/register.tsx`：フック（セッション開始時の言語、`/hitokoto` と各モードの更新スケジュール、コマンドとバー）。
- `hooks/config.ts`：オプション。一度に型付きの `Config` として読み込みます。
- `hooks/parse.ts`：API エンドポイントと応答内容の解析、出典とローカル日付。
- `hooks/i18n.ts`：各言語の文言。
- `hooks/kit/`：`claude-code/kit` のコピー。ソースファイルを変更したら `scripts/sync-kit.sh` を実行します。

## Install

```
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hitokoto@hoobnn-agent-mods
```

## Original README

# hitokoto：Claude Code 输入框上方的一言

**简体中文** · [English](README.en.md)

在输入框上方显示一句[一言](https://hitokoto.cn)：诗词、文学、动画台词或哲理短句，后面淡淡地附上作者和出处。等 Claude 干活的时候，顺便读一句。

![hitokoto：输入框上方的一句一言和出处](assets/preview.png)

## 功能

- **一句话加出处**：句子后面是作者和出处，点末尾的 `↻` 换一句（`daily` 模式下没有这个按钮）。
- **四种更换方式**：定时换（默认每 30 分钟）、每天一句（所有会话同一句，过了零点换新的）、每个会话一句、每次发消息换一句。
- **按分类挑**：可以只要诗词、文学、哲学等分类。
- **省流量、不空白**：横条隐藏时不请求；同一时间只发一个请求，10 秒没响应算失败；上次取到的句子会保存，新会话或离线时直接显示它，不会空着。
- 在 `claude -p` 和 SDK 里不请求。

## 安装

```sh
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hitokoto@hoobnn-agent-mods
```

## 命令

- `/hitokoto`：立刻换一句（`daily` 模式下替换今天的这句）。
- `/hitokoto off`、`/hitokoto on`：隐藏或显示横条。这个设置会写回 `/config`，以后的会话也会沿用；重新显示时会先取一句新的。

## 选项

在 `/config` 里修改，或写在 `~/.claude/settings.json` 的 `pluginConfigs` 里：

| 选项 | 作用 | 默认 |
| --- | --- | --- |
| `visible` | 显示横条（`/hitokoto off` / `on` 改的就是它） | 开 |
| `refreshMode` | `interval` 定时换、`daily` 每天一句、`session` 每个会话一句、`prompt` 每次发消息换一句 | `interval` |
| `categories` | 一言的分类字母，逗号分隔，留空不限。a 动画、b 漫画、c 游戏、d 文学、e 原创、f 网络、g 其他、h 影视、i 诗词、j 网易云、k 哲学、l 抖机灵，例如 `d,i,k` | 空 |
| `intervalMinutes` | `interval` 模式下几分钟换一句（至少 1） | 30 |
| `language` | `/hitokoto` 回复和报错的语言：`auto`、`en`、`zh-Hans`、`zh-Hant`、`ja`、`ko`、`es`、`fr`、`de`、`pt-BR`、`ru`（句子本身是中文） | `auto` |

`language` 为 `auto` 时，依次跟随 Claude Code 的 `language` 设置和系统语言环境，都没有时用英语。

## 同系列 mod

[hoobnn-agent-mods](../../README.md) 里还有状态栏 HUD（`hud`）、任务进度条（`todo-bar`）、回合回执（`receipt`）、运行动画和宠物（`spinner`）和 Tailscale 节点状态（`ts-band`），可以搭配使用。

## 开发

- `hooks/register.tsx`：钩子（会话开始时的语言、`/hitokoto` 和对应模式的刷新计划，命令和横条）。
- `hooks/config.ts`：选项，一次性读成类型化的 `Config`。
- `hooks/parse.ts`：接口地址和返回内容的解析、出处和本地日期。
- `hooks/i18n.ts`：各语言文案。
- `hooks/kit/`：`claude-code/kit` 的副本；改源文件后运行 `scripts/sync-kit.sh`。
