アウトプットスタイルとは？Claude Code の応答をコントロールする新機能
Claude Code を使い込んでいると、「もう少し簡潔に答えてほしい」「コードの意図をもっと詳しく説明してほしい」と感じることはありませんか？アウトプットスタイル（Output Styles） は、Claude Code の応答トーン・フォーマット・深さを自由にカスタマイズできる機能です。
この機能の特徴は、Claude Code のシステムプロンプトそのものを置き換える点にあります。ツールやファイルシステムアクセスなどの能力はそのままに、応答の「人格」と「優先事項」だけが変わります。
何が変わり、何が変わらないのか
アウトプットスタイルを適用しても維持されるもの:
CLAUDE.mdによるプロジェクトコンテキスト- 全ツールエコシステム（ファイル操作、Bash、エディタなど）
- サブエージェント・カスタムエージェントの委任
- MCP サーバー連携
- コンテキスト管理とコンパクション
アウトプットスタイルで変わるもの:
- 応答のトーンとフォーマット
- ドメインの仮定と優先度
- タスクのアプローチ方法
- インタラクションパターン
組み込みスタイルの使い方
スタイルの選択方法
Claude Code でアウトプットスタイルを設定するには、/config コマンドを実行します:
# Claude Code のインタラクティブモードで
/config
# メニューから "Output style" を選択設定は .claude/settings.local.json にプロジェクトレベルで保存されるため、プロジェクトごとに異なるスタイルを使い分けることが可能です。
Default スタイル
デフォルトのスタイルは、ソフトウェアエンジニアリングタスクを効率的に完了するために設計されたシステムプロンプトです。簡潔で実用的な応答が特徴で、多くの開発者にとって最適なベースラインです。
Explanatory スタイル
Explanatory スタイルは、コーディング作業の合間に教育的な「Insights」を提供してくれるモードです。新しいコードベースに初めて触れるときや、チームの技術的意思決定の背景を理解したいときに最適です。
# 例: Explanatory スタイルでリファクタリングを依頼
> このファイルのデータベースクエリを最適化して
# Claude の応答例:
# 💡 Insight: このファイルでは N+1 クエリ問題が発生しています。
# ループ内で個別にクエリを発行する代わりに、JOIN や
# サブクエリを使って一括取得するアプローチが一般的です。
#
# [具体的なリファクタリング実施]Learning スタイル
Learning スタイルは、コーチングモードです。Claude が全てを代行するのではなく、あなたに小さなコード変更を自分で書くよう促します。スキルアップしたい開発者にとって理想的なスタイルです。
# 例: Learning スタイルでエラーハンドリングを学ぶ
> この API エンドポイントにエラーハンドリングを追加して
# Claude の応答例:
# 💡 Insight: try-catch ブロックでエラーを捕捉し、
# 適切な HTTP ステータスコードを返す必要があります。
#
# まず、try-catch ブロックを追加してみてください。
# ヒント: catch ブロックでは error オブジェクトの
# message プロパティを使ってレスポンスを構成します。
#
# 準備ができたら、コードを見せてください。カスタムアウトプットスタイルの作成
組み込みスタイルでは物足りない場合、独自のアウトプットスタイルを Markdown ファイルとして作成できます。
ファイルの配置場所
カスタムスタイルは2つのレベルで配置できます:
# ユーザーレベル（全プロジェクト共通）
~/.claude/output-styles/my-style.md
# プロジェクトレベル（プロジェクト固有）
.claude/output-styles/my-style.md
カスタムスタイルの基本構造
---
name: concise-japanese
description: 簡潔な日本語で応答するスタイル
---
あなたはシニアソフトウェアエンジニアです。
## 応答ルール
- 日本語で応答する（コード内コメントも日本語）
- 変更内容は箇条書きで簡潔にまとめる
- コードブロックには必ず言語指定をつける
- 不要な前置きや挨拶は省略する
- 変更理由を1行で述べてから実装に入る
## コードスタイル
- 変数名・関数名は英語（camelCase）
- コメントは日本語
- TypeScript の場合は strict モードを想定実践的なカスタムスタイル例
1. コードレビュアースタイル
---
name: code-reviewer
description: コードレビューの視点で応答するスタイル
---
あなたはシニアコードレビュアーとして振る舞います。
## レビュー方針
コード変更を依頼されたら、以下の観点で分析してから実装します:
1. **セキュリティ**: 入力バリデーション、SQL インジェクション、XSS
2. **パフォーマンス**: 不必要なループ、N+1 クエリ、メモリリーク
3. **可読性**: 命名規則、関数の長さ、責務の分離
4. **テスト容易性**: モック可能な設計、依存性注入
変更を実施する前に、改善ポイントを簡潔に列挙してください。
重大な問題がある場合は ⚠️ マークで強調します。2. アーキテクトスタイル
---
name: architect
description: システム設計の視点で応答するスタイル
---
あなたはソフトウェアアーキテクトです。
## 設計原則
- SOLID 原則に基づいた設計判断を行う
- トレードオフを明示する（例: 「速度 vs 可読性」）
- スケーラビリティへの影響を常に考慮する
- 変更がシステム全体に与える影響を説明する
## 応答フォーマット
1. 設計判断の要約（1-2行）
2. 選択した理由とトレードオフ
3. 実装コード
4. 将来の拡張ポイント（該当する場合）3. ドキュメンテーション重視スタイル
---
name: documenter
description: ドキュメンテーションを重視するスタイル
---
すべてのコード変更に対して、以下のドキュメンテーションを含めてください:
- JSDoc/TSDoc コメント（関数・クラス・型）
- インラインコメント（複雑なロジックのみ）
- 変更サマリー（コミットメッセージ案を含む）
README.md の更新が必要な場合は、差分も提示してください。プラグインからのスタイル配布
チーム全体で統一されたスタイルを使いたい場合、アウトプットスタイルをプラグインとして配布できます。
プラグインでのスタイル定義
my-team-plugin/
├── .claude-plugin/
│ └── plugin.json
└── output-styles/
├── team-standard.md
└── pr-review.md
plugin.json でスタイルのパスを指定します:
{
"name": "my-team-styles",
"version": "1.0.0",
"description": "チーム標準のアウトプットスタイル集",
"outputStyles": "./output-styles/"
}プラグインをインストールすると、/config のスタイル選択メニューにチームのカスタムスタイルが自動的に追加されます。これにより、チーム全員が同じスタイルで Claude Code を使えるようになります。
ユースケース別おすすめ設定
新規プロジェクト立ち上げ時
新しいコードベースの構築では Default スタイルが最適です。素早くコードを生成し、イテレーションを回すのに無駄がありません。
既存コードベースの理解
初めて参加するプロジェクトでは Explanatory スタイルに切り替えましょう。フレームワークの仕組みやコードパターンを解説してくれるため、キャッチアップが大幅に加速します。
ジュニアエンジニアの教育
メンターの代わりとして Learning スタイルを活用できます。Claude が全てを代行するのではなく、考え方のヒントを出しながらジュニアエンジニアに実際にコードを書かせるアプローチです。
コードレビュー自動化
カスタムの code-reviewer スタイルを作成し、PR 前のセルフレビューに活用します。セキュリティやパフォーマンスの問題を事前に発見できます。
高度なテクニック
環境変数を使ったスタイルの動的切り替え
CI/CD パイプラインや自動化スクリプトでは、環境変数を使ってスタイルをプログラマティックに切り替えることも可能です:
# settings.local.json を直接書き換える方法
cat > .claude/settings.local.json << 'EOF'
{
"outputStyle": "concise-japanese"
}
EOF
# Claude Code を非インタラクティブモードで実行
claude -p "このファイルをリファクタリングして" --output-format stream-jsonCLAUDE.md との組み合わせ
アウトプットスタイルと CLAUDE.md は補完関係にあります:
- CLAUDE.md: プロジェクト固有のルールやコンテキスト（「テストは Jest を使う」「API レスポンスはこの形式」）
- アウトプットスタイル: Claude の応答スタイル全般（「簡潔に答える」「レビュー視点で答える」）
# CLAUDE.md の例
## プロジェクトルール
- パッケージマネージャは pnpm を使用
- コミットメッセージは Conventional Commits 形式
- テストカバレッジ 80% 以上を維持
# これとは別にアウトプットスタイルで応答トーンを制御両方を適切に設定することで、プロジェクトの技術的な制約とコミュニケーションスタイルを独立して管理できます。
全体を振り返って
Claude Code のアウトプットスタイルは、AI ペアプログラミングの体験を大きく変える機能です。組み込みの3つのスタイル（Default、Explanatory、Learning）をまず試し、自分のワークフローに合わなければカスタムスタイルを作成しましょう。チームでの活用では、プラグインとしてスタイルを配布することで、全員が統一されたコミュニケーション品質で Claude Code を使えるようになります。
まずは /config でスタイルを切り替えてみることから始めてください。応答の変化を実感したら、自分だけのカスタムスタイルを ~/.claude/output-styles/ に作成してみましょう。
Claude Code のアウトプットスタイルをカスタマイズする方法について、さらに詳しくは公式ドキュメントも参照してください。