Context Engineering on KnightLiブログ

Claude Code の出力が長すぎるときの設定：短く、エンジニアリング報告らしくする

Fri, 10 Jul 2026 11:57:57 +0800

Claude Code を使っていると、小さな悩みが出てきます。仕事はできるのに、返答が長すぎることです。

テストを一つ直してほしいだけなのに、テストフレームワークを説明し、依頼を言い直し、「これからやります」と書き、最後に変更ファイルを言います。コードは問題なくても読むコストが高く、長い会話では context を圧迫します。

解決策は「簡潔に」と言うだけではありません。一時プロンプト、CLAUDE.md、output style、custom slash command を分けて使うのが安定します。

目標は、Claude Code の出力を工程報告に近づけることです。結果を先に、前置きを減らし、task restatement を避け、必要な files、commands、risks、next steps だけを残します。

Quick Answer

レイヤー	場面	方法
一時プロンプト	今の turn が長い	result、files、validation、risks だけ要求
`CLAUDE.md`	project 長期 preference	concise report rules を書く
Output style	全体の tone と format	output style を定義
Custom slash command	review、test fix、summary	短い template を command 化

おすすめ順は、一時プロンプト、CLAUDE.md、output style、slash command です。

今すぐ短くする

后续回复请压缩：
- 不复述我的需求。
- 不写礼貌铺垫。
- 先给结论。
- 只列改动文件、验证命令、结果、风险。
- 没有风险就写“未发现额外风险”。

コード変更では：

请用简短工程汇报格式输出：
1. 改了什么
2. 改了哪些文件
3. 跑了什么验证
4. 还有什么风险

不要解释通用背景，不要复述任务。

調査では：

只输出：
- 最可能原因
- 证据
- 下一步验证命令

不要写长篇分析过程。

これはすぐ効きますが、会話単位です。長期化するなら project rules に移します。

`CLAUDE.md` に書く

## Response Style

- Be concise and engineering-focused.
- Do not restate the user's request.
- Do not include generic explanations unless asked.
- Put the result first.
- For code changes, report only:
  1. changed files
  2. behavior changed
  3. validation run
  4. remaining risks
- If no validation was run, say so directly.
- If no extra risk is found, write "未发现额外风险".

中国語プロジェクトなら：

## 回复风格

- 默认用中文，简洁、直接、工程化。
- 不复述用户需求。
- 不写礼貌铺垫。
- 不解释通用背景，除非用户明确要求。
- 修改代码后只汇报：改动文件、行为变化、验证命令、剩余风险。
- 没有运行验证时必须明确说明。
- 没有额外风险时写“未发现额外风险”。

CLAUDE.md 自体が長くなると context の負担になります。圧縮方法は /ja/2026/07/10/ai-coding-prompt-compression-guide/。

Output Style を使う

output styles は Claude の response style、role、tone、format を変えます。project facts を教えるものではありません。

# Concise Engineering

Respond like a senior engineer giving a short handoff.

Rules:
- Lead with the result.
- Avoid restating the task.
- Avoid generic explanations.
- Use short bullets only when useful.
- For code work, include changed files, validation, and risks.
- If blocked, state the blocker and the next concrete action.
- Keep final answers short unless the user asks for detail.

中国語なら：

# 简洁工程汇报

默认用中文回答，风格像资深工程师交接工作。

规则：
- 先说结果。
- 不复述用户需求。
- 不写通用背景。
- 不写“我将会”这类过程铺垫。
- 代码修改后只汇报改动、验证、风险。
- 遇到阻塞时只说明阻塞点和下一步。
- 用户没有要求长解释时，回答保持短。

project paths、test commands、forbidden files は output style ではなく CLAUDE.md に置きます。

`/config` で設定する

Claude Code で：

/config

output style の項目を確認します。バージョンによっては次のような形式を使える場合があります。

`1`	`/config outputStyle=your-style-name`

key 名は変わる可能性があるため、まず /config で確認するのが安全です。

Custom Slash Command

固定タスクには command を作ります。

`1`	`.claude/commands/short-review.md`

只读审查当前改动，不要修改文件。

输出格式：

1. 高风险问题
2. 中低风险问题
3. 缺失测试
4. 结论

规则：
- 每个问题最多 2 行。
- 必须给文件路径。
- 没有问题时写“未发现高风险问题”。
- 不要复述任务。
- 不要写通用审查方法。

実行：

`1`	`/short-review`

同様に short-fix、short-test、short-summary を作れます。

コード変更後の出力形式

结果：
- ...

改动文件：
- path/to/file

验证：
- 命令：...
- 结果：...

风险：
- ...

さらに短く：

改动：...
文件：...
验证：...
风险：...

検証していない場合：

`1`	`验证：未运行，原因是 ...`

Review で短くする

只读审查当前 diff。

只输出真实问题，不输出优点。
按严重程度排序。
每个问题包含：文件路径、问题、建议。
没有问题就写“未发现高风险问题”。
不要写总结性夸奖。

Codex を独立 review に使う場合、Claude Code は実装、Codex は read-only review にできます。分担: /ja/2026/07/10/cursor-codex-claude-code-workflow-division/。

Test fix で短くする

请修复当前 failing test。

输出限制：
- 不解释测试框架。
- 不复述错误日志。
- 只保留失败原因、改动文件、验证结果。
- 连续失败两次后停止修改，先总结共同原因。

token usage が高いときは log output も制御します: /ja/2026/07/08/claude-code-token-usage-spike-troubleshooting-faq/。

すべてを極短にしない

短い出力が向くのは bug fix、failing tests、commit summary、code review、simple command explanation、明確な実装タスクです。

短すぎないほうがよいのは onboarding、architecture tradeoff、incident review、security risk、database migration、曖昧な requirements です。

実行フェーズは短く、設計フェーズは少し展開してよいと考えます。

caveman との違い

caveman は Claude Code や Codex の出力を短くする skill/plugin として紹介しました: /ja/2026/07/03/caveman-agent-output-compression-guide/。

この記事の方法は基礎です。一時プロンプト、CLAUDE.md、output style、slash command で自分の rule を作ります。

よくある間違い

“Be concise” だけ

曖昧です。

`1`	`只保留：结果、文件、验证、风险。`

毎回 style を繰り返す

安定ルールは CLAUDE.md や output style に移します。

output style に project facts を入れる

output style は tone と format、project facts は CLAUDE.md です。

safety を削る

危険操作、database、permissions、production config、file deletion は省かないでください。

説明を完全禁止する

良い書き方：

`1`	`默认短输出；只有遇到设计取舍、风险或阻塞时再解释。`

Copy-Paste Config

## Response Style

- Default language: Chinese.
- Be concise and engineering-focused.
- Do not restate the user's request.
- Do not include generic background unless asked.
- For code changes, report only:
  - result
  - changed files
  - validation
  - risks
- For reviews, list only actionable issues.
- For test failures, summarize the failing cause and next command only.
- If validation was not run, say that explicitly.
- If no risk is found, write "未发现额外风险".

一時プロンプト：

1
2
3

本轮请使用短汇报格式：
结果 / 文件 / 验证 / 风险。
不要复述任务，不要解释通用背景。

まとめ

Claude Code の出力が長すぎるとき、すぐ道具を変える必要はありません。現在の会話は短い prompt、project は CLAUDE.md、全体表現は output style、固定タスクは slash command で制御します。

大事なのは「できるだけ短く」ではなく、場面に合う長さです。実装とテスト報告は短く、architecture と risk discussion は必要に応じて展開します。

参考資料

AI コーディングの長すぎるプロンプトを圧縮する方法：コンテキスト整理と実用テンプレート

Fri, 10 Jul 2026 11:55:30 +0800

AI コーディングを長く使うほど、プロンプトは長くなりがちです。

最初は「この bug を直して」だけだったものが、数百字の背景、十数個のルール、完全なエラーログ、ディレクトリ説明、過去の判断、個人の好み、テスト要件、多くの「ついでに」へ膨らみます。完全に見えて、実際には使いにくくなります。モデルは焦点を見失い、不要なファイルを読み、token を消費し、タスクから外れやすくなります。

プロンプト圧縮とは、単に短く書くことではありません。低密度な内容を削り、タスク境界、入力、制約、受け入れ条件を AI がすぐ理解できるようにすることです。

Quick Answer

多くの AI coding prompt は 6 行のタスクカードにできます。

Goal: Fix failed login session refresh.
Scope: Start with src/auth/session.ts and tests/auth/session.test.ts.
Limit: First pass is analysis only; do not modify files; do not scan the whole repo.
Constraints: Do not change public API; do not delete files.
Validation: Give the smallest test command.
Output: List the 3 most likely causes and next steps.

長い文章より安定します。何をするか、どこを見るか、何をしないか、どう検証するか、何を出すかが明確だからです。

目的は「少なく書く」ことではなく、「モデルに推測させない」ことです。

長いプロンプトが悪くなる理由

1. 目的が背景に埋もれる

履歴や個人的判断が多いと、モデルは現在の問題を解く代わりに背景を要約し始めます。

2. 制約が衝突する

最小変更、ついでの refactor、テスト追加、大きく変えない、architecture 変更可、早く直す、が同時にあると優先順位が不明です。

3. ファイル範囲が広すぎる

“whole project”、“check everything”、“all related files” は不要な読み込みを招きます。

4. ログとコードを貼りすぎる

完全な logs、files、diff は重要情報を埋もれさせます。

5. 一時的な要望が長期ルールになる

一回限りの task を CLAUDE.md、AGENTS.md、memory に入れると後続タスクを汚します。

Claude Code の token spike が問題なら /ja/2026/07/08/claude-code-token-usage-spike-troubleshooting-faq/ も参照してください。

ステップ 1：何が長いか分ける

種類	必須か	圧縮方法
現在の目的	必須	明確な動詞を一つ残す
ファイル範囲	必須	正確な path を書く
制約	必須	操作に影響するものだけ残す
受け入れ条件	必須	test command や確認可能な結果を書く
過去背景	場合による	現在タスクに関係する結論だけ
完全ログ	通常不要	key error のみ
完全コード	通常不要	path を渡して読ませる
好み	場合による	長期 rule に移す
感情表現	不要	削除
“also” tasks	非推奨	次のタスクへ分ける

判断基準は、その文が Agent の次の行動を変えるかです。

ステップ 2：自然文をフィールドに変える

長い書き方：

I recently changed the login module. Users report that refreshing the page often logs them out. I suspect session expiry handling or cookie updates. Please look at it, avoid affecting other login logic, don't rewrite the architecture, maybe add tests, and check if similar problems exist elsewhere.

圧縮後：

Goal: Diagnose login state lost after page refresh.
Scope: src/auth/session.ts, src/auth/cookie.ts, tests/auth/session.test.ts.
Limit: Do not change auth architecture; first pass analysis only.
Validation: List minimal reproduction and tests to add.
Output: 3 likely causes ranked by probability.

情報量は減っていません。実行しやすくなっています。

ステップ 3：背景は結論だけ残す

低密度な背景は、次のように事実とリスクへ変えます。

Background facts:
- Login has a legacy compatibility layer; do not remove it.
- Web and mobile share session logic.
- There was a previous cookie write issue; check cookie update paths first.

モデルに必要なのは、あなたの思い出し方ではなく、変更判断に影響する事実です。

ステップ 4：“しないこと” を具体化する

曖昧な「慎重に」ではなく、禁止事項を書きます。

Forbidden:
- Do not change public API.
- Do not change database schema.
- Do not delete legacy compatibility logic.
- Do not do unrelated refactoring.

削除、移動、refactor は特に明確に制限します。誤削除対策: /ja/2026/07/10/ai-coding-avoid-accidental-file-deletion/。

ステップ 5：“also” を分割する

“also” は scope を広げます。

Phase 1: Diagnose the bug only; do not modify.
Phase 2: Fix the minimal code path.
Phase 3: Add the smallest related test.
Phase 4: Separately evaluate whether refactoring is needed.

長時間タスクは phase plan を作り、段階的に進めます。復旧方法: /ja/2026/07/10/ai-agent-long-task-resume-guide/。

ステップ 6：完全なファイルを貼らない

Agent に path を渡します。

Please read:
- src/auth/session.ts
- src/auth/cookie.ts
- tests/auth/session.test.ts

First pass: summarize relevant logic only. Do not modify.

大きいファイルならさらに絞ります。

`1`	`Focus only on session refresh, cookie update, and logout branches.`

ステップ 7：ログは key lines だけ

Command: pnpm test -- auth
Failing test: refresh session keeps user logged in
Key error: Expected status 200, received 401
Stack: tests/auth/session.test.ts:42

完全ログが必要ならファイルに置きます。

1
2

Full log is in .tmp/auth-test.log.
Read only the last 80 lines first.

ステップ 8：長期ルールは外へ出す

毎回繰り返す pnpm、migration 禁止、API 変更後の test、削除禁止、中国語 summary、既存 helper 優先などは、AGENTS.md、CLAUDE.md、.cursor/rules/、docs/ai-workflow.md、Codex Skill、Claude Code subagent に移します。

プロンプトでは次のように書きます。

1
2

Follow project AGENTS.md.
Extra limit for this task: do not modify src/db/migrations.

コードベース記憶と rule files は /ja/2026/07/10/ai-agent-codebase-memory-tools-comparison/。

ステップ 9：`CLAUDE.md` / `AGENTS.md` も圧縮する

残すもの：build commands、test commands、forbidden paths、style constraints、security boundaries、commit/validation rules、project-specific pitfalls。

削るもの：古い履歴、重複、感情的注意、長い architecture background、README の一般説明、一回限りの task record、曖昧な表現。

例：

1
2

- Search `src/components` before adding UI; prefer existing components.
- Do not create a generic component for a one-page change.

caveman のような圧縮ツールを使う場合も、安全ルールは人間が確認してください: /ja/2026/07/03/caveman-agent-output-compression-guide/。

ステップ 10：三つのテンプレート

Diagnosis

Goal:
Scope:
Symptom:
Key error:
Limit: First pass analysis only; do not modify files.
Output: 3 most likely causes + minimal validation steps.

Change

Goal:
Allowed files:
Forbidden files:
Implementation requirements:
Validation command:
Output: changed files + validation result + risks.

Review

Goal: Read-only review current diff.
Focus:
Limit: Do not modify files.
Output: List issues by severity; if none, say no high-risk issue found.

Cursor、Codex、Claude Code を併用する場合は、Cursor が locate、Claude Code が implement、Codex が review を担当できます: /ja/2026/07/10/cursor-codex-claude-code-workflow-division/。

Before / After

Goal: Diagnose login state lost after page refresh.
Scope: src/auth/session.ts, src/auth/cookie.ts, tests/auth/session.test.ts.
Background: There is old token compatibility; do not remove it.
Limit: First pass analysis only; do not modify; do not scan the whole repo.
Validation: Give minimal reproduction and test suggestions.
Output: 3 causes ranked by probability.

短く、明確です。

圧縮しすぎてはいけないもの

safety boundaries、permission limits、database migration rules、production risk、削除禁止ファイル、acceptance criteria、legal/compliance/privacy、正確な code、commands、paths、error strings は削らないでください。

悪い例：

`1`	`Run related tests.`

良い例：

`1`	Run `pnpm test -- auth`.

Team Rule

## Prompt Discipline

- Treat each task as a small work order.
- Prefer fields: goal, scope, limits, validation, output.
- Do not scan the whole repository unless explicitly requested.
- Ask before reading large logs or unrelated directories.
- Keep command output summarized; save full logs to files.
- Do not mix new feature work, refactor, docs, and cleanup in one task.
- Preserve exact paths, commands, error messages, and safety rules.

Checklist

問題	対処
目的が一文を超える	verb + object にする
背景が 5 行超	3 facts に圧縮
file scope が曖昧	exact paths
“also” が複数	later tasks
制約が多い	must / forbidden / optional
full log	command、failing test、key error
full code	paths
repeated rules	`AGENTS.md` / `CLAUDE.md`
output requirements が長い	list format
編集すべきか不明	first pass analysis only

まとめ

AI coding prompt が長くなるのは、目的、背景、制約、ログ、コード、長期ルールが混ざるからです。

安定した圧縮方法はタスクカード化です。目的を一文、scope を path、limits を明確に、validation を command、output を固定形式にします。背景は判断に影響する事実だけ、ログは key lines だけ、長期ルールは project files へ、“also” は次のタスクへ分けます。

Context Engineering on KnightLiブログ

Claude Code の出力が長すぎるときの設定：短く、エンジニアリング報告らしくする

Quick Answer

今すぐ短くする

CLAUDE.md に書く

Output Style を使う

/config で設定する

Custom Slash Command

コード変更後の出力形式

Review で短くする

Test fix で短くする

すべてを極短にしない

caveman との違い

よくある間違い

“Be concise” だけ

毎回 style を繰り返す

output style に project facts を入れる

safety を削る

説明を完全禁止する

Copy-Paste Config

まとめ

参考資料

AI コーディングの長すぎるプロンプトを圧縮する方法：コンテキスト整理と実用テンプレート

Quick Answer

長いプロンプトが悪くなる理由

1. 目的が背景に埋もれる

2. 制約が衝突する

3. ファイル範囲が広すぎる

4. ログとコードを貼りすぎる

5. 一時的な要望が長期ルールになる

ステップ 1：何が長いか分ける

ステップ 2：自然文をフィールドに変える

ステップ 3：背景は結論だけ残す

ステップ 4：“しないこと” を具体化する

ステップ 5：“also” を分割する

ステップ 6：完全なファイルを貼らない

ステップ 7：ログは key lines だけ

ステップ 8：長期ルールは外へ出す

ステップ 9：CLAUDE.md / AGENTS.md も圧縮する

ステップ 10：三つのテンプレート

Diagnosis

Change

Review

Before / After

圧縮しすぎてはいけないもの

Team Rule

Checklist

まとめ

`CLAUDE.md` に書く

`/config` で設定する

ステップ 9：`CLAUDE.md` / `AGENTS.md` も圧縮する