---
title: "hitokoto: Claude Code 입력 상자 위의 한마디"
url: "https://claudemods.dev/ko/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: "ko"
content_locale: "ko"
---

# hitokoto: Claude Code 입력 상자 위의 한마디

hitokoto: 프롬프트 위의 밴드에 Hitokoto(一言) 한 줄을 표시하며, 타이머, 세션별, 프롬프트별 또는 하루 한 번 새로 고칩니다.

## Description

# 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 영화/TV, 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`。
