Claude Codeの出力スタイルとは、応答の文体を決める指示のことです。
楽天市場の本店とAmazon店、自社のShopifyサイトで、同じ商品の説明文を毎回「この店はやわらかい口調で」「こっちは箇条書きで短く」とAIに頼み直していないでしょうか。Claude Codeの出力スタイル(アウトプットスタイル)を使えば、口調・長さ・形式の指示を1つのMarkdownファイルにまとめ、店舗のフォルダごとに自動で切り替えられます。組み込みスタイルは標準のDefaultのほかに4種類あり、独自のスタイルも作れます。本記事は、EC支援19年・5,000社超の実績を持ち、AI導入支援は2023年から提供する株式会社オルセル(うるチカラ運営)が、出力スタイルで商品説明の文体を店舗ごとに固定する手順を、スタイルファイルの例とプロンプト3本つきで解説します。
出力スタイルで何が変わるのか
出力スタイルを使う最大の利点は、文体の指示を毎回のプロンプトから切り離し、セッション内のすべての応答に効かせられることです。公式ドキュメントは、出力スタイルを「セッション内のすべての応答に対して、Claudeの役割、トーン、応答形式を設定する一連の指示」と説明しています。カスタムスタイルでは、Claudeをソフトウェアエンジニアではなくライティングアシスタントやデータアナリストとして振る舞わせることもできます。
組み込みのスタイルは次の4つです。日常的な判断を質問せずに進めるProactive、結果から書き始めて前置きや要約を省くConcise、コードの選択理由を短いInsightブロックで添えるExplanatory、ユーザーに一部のコードを書かせるLearningです。Conciseを使うにはClaude Code v2.1.237以降が必要です。どれも開発作業向けの性格が強いので、商品説明の文体を固定したいEC事業者は、カスタムスタイルを作ることになります。
ここで押さえておきたいのは、ほかの機能との役割分担です。ドキュメントは、プロジェクトについてClaudeが知るべき情報はCLAUDE.md、特定の種類の作業の手順はスキル、毎回必ず実行されなければならない処理はフック(決まったタイミングで自動実行される仕組み)、と使い分けを整理しています。出力スタイルはあくまで「Claudeが従う指示」であり、何かが必ず起きることを保証するものではない、と明記されています。
EC運営に当てはめると、店舗の基本情報や商品カテゴリの決まりごとはCLAUDE.md、楽天R-Mailの作成手順のような作業ごとの手順はスキル、そして「この店舗ではいつもこの口調・この長さで書く」という声の部分が出力スタイル、という分け方になります。禁止表現のチェックのように漏れが許されない作業は、出力スタイルに頼らずフックやチェック用スクリプトで確実に止めるのが筋です。
店舗ごとに文体を固定できる仕組み
結論として、店舗ごとの文体固定は「プロジェクト単位のスタイルファイル」と「設定ファイルのoutputStyle」の2つで実現します。カスタムスタイルのファイルは、ユーザー全体(~/.claude/output-styles)、プロジェクト(.claude/output-styles)、管理ポリシーの3つの階層に置けます。ファイル名がそのままスタイル名になり、フロントマターでnameを指定すれば表示名を変えられます。
店舗ごとに切り替えるうえで便利なのが、プロジェクトのスタイルの読み込み方です。プロジェクトのスタイルは、作業ディレクトリからリポジトリのルートまでの間にあるすべての.claude/output-styles/から読み込まれ、同じ名前のスタイルが複数あるときは作業ディレクトリに最も近いものが使われます。たとえば1つのリポジトリの中にrakuten-honten/、amazon/、shopify/のフォルダを作り、それぞれに同じ名前shop-voiceのスタイルを置けば、どのフォルダで作業しているかによって自動的にその店舗の文体が選ばれます。
どのスタイルを使うかは、設定ファイルのoutputStyleで決めます。/output-styleコマンドやメニューで選ぶと、選択内容はローカルのプロジェクト設定.claude/settings.local.jsonに保存されます。全プロジェクトの初期値にしたい場合は~/.claude/settings.jsonに書き、プロジェクト側の設定があればそちらが優先されます。値は大文字と小文字を区別し、名前が完全に一致しないと標準のスタイルが適用される点に注意が必要です。コマンドのほうは大文字と小文字を区別しません。
切り替えのタイミングも把握しておきましょう。セッション中にスタイルを変えると、次のメッセージから新しいスタイルが使われます(v2.1.251より前は/clearか新しいセッションが必要でした)。ただし、ターミナルではスタイルのファイルを起動時に読み込むため、セッション中にファイルを作ったり書き換えたりした場合は、Claude Codeの再起動が必要です。
フォルダ構成の例を文章で示すと、次のようになります。リポジトリの最上位に、全店舗で共通の決まりごと(会社名の表記、送料の基本ルール、問い合わせ窓口の案内文など)を書いたCLAUDE.mdを置きます。その下に店舗ごとのフォルダを作り、各フォルダの中に.claude/output-styles/shop-voice.mdと.claude/settings.jsonを置きます。担当者は、楽天本店の作業をするときはrakuten-hontenフォルダで、Amazon店の作業をするときはamazonフォルダでClaude Codeを起動するだけです。共通の知識は最上位から、店舗の声はフォルダから読み込まれるので、指示の重複や貼り間違いが起きにくくなります。
ドキュメントによると、カスタムスタイルはkeep-coding-instructionsをtrueにしない限り、完全なシステムプロンプトに含まれる標準の開発向け指示の部分を外して動きます。商品説明を書く専用のフォルダでは開発向けの指示は不要なので、外したほうが文章作成に集中した応答になります。逆に、商品ページのHTMLを編集しながら説明文も整える、といった開発寄りの作業が多い店舗なら、trueにして開発向けの指示を残しておくほうが安全です。
プラグインで配ることもできます。プラグインのoutput-styles/ディレクトリにスタイルを入れておけば、スキルやフックと一緒に社内へ配布できます。フロントマターでforce-for-plugin: trueを設定すると、プラグインが有効なときに利用者が選ばなくてもそのスタイルが自動で適用されます。社内配布の考え方は、Claude Codeのプラグインを業務パッケージとして配る方法で詳しく扱っています。
文体を固定する5つの手順とプロンプト3本
ここからは、楽天市場の本店、Amazon店、自社ECの3店舗で商品説明の文体を分ける場合を例に、5つの手順で進めます。プロンプトはChatGPT、Claude、Geminiのどれでも使えるように書いてあります。
手順1は、店舗ごとの「良い文章」を集めることです。各店舗で評価の高い商品説明(転換率が高い、レビューで説明が分かりやすいと書かれているなど)を5〜10件選びます。ここで選ぶ文章が、そのまま文体ルールの元になります。
手順2は、集めた文章から文体ルールを言葉にすることです。人が感覚で「この店らしさ」と呼んでいるものを、語尾、文の長さ、使う言葉と使わない言葉、構成の順番といった、AIが従える具体的なルールに変えます。
プロンプト1:既存の商品説明から店舗の文体ルールを抽出する
あなたはECの商品ページ制作に詳しい編集者です。
以下は当店で評価の高い商品説明文です。これらに共通する文体のルールを抽出してください。
店舗:{例:楽天市場の本店/食品ギフト/主な購入者は50〜60代}
商品説明文:
{評価の高い説明文を5〜10件貼り付け}
出力してほしい項目:
1. 語尾の傾向(です・ます、言い切り、体言止めの割合など)
2. 1文の長さの目安と、1段落の文数
3. よく使う言葉と、使っていない言葉
4. 説明の順番(例:用途→特徴→素材→サイズ→お手入れ)
5. 数字や単位の書き方(全角か半角か、単位の表記)
6. この店舗らしさを一言で表すなら何か
条件:
- 文章から確認できることだけを書き、推測には「推測」と付ける
- 最上級表現や効能を断定する表現が含まれていた場合は、ルールにせず「要修正」として別にまとめる
手順3は、文体ルールをスタイルファイルにすることです。商品説明を書く作業はプログラミングではないので、keep-coding-instructionsは付けずに作ります。この項目をtrueにすると、Claude Code標準のソフトウェア開発向けの指示(変更範囲、コメントの書き方、作業の検証方法など)が残ります。開発とライティングを同じセッションで行う場合だけtrueにするのが目安です。
スタイルファイルは、たとえばrakuten-honten/.claude/output-styles/shop-voice.mdに次のように書きます。
---
name: shop-voice
description: 楽天本店の商品説明用。やわらかい口調で、贈る相手の場面から書き始める
---
あなたは当店(楽天市場の食品ギフト店)の商品説明を書くライターです。
文体
- です・ます調で書く。1文は40字前後を目安にし、60字を超えたら分ける
- 1段落は2〜3文にする
- 冒頭の1文は、贈る相手と場面から書き始める
構成の順番
1. 贈る場面
2. 味と食感
3. 原材料と産地
4. 内容量・賞味期限・保存方法
5. のし・包装の対応
使わない表現
- 最上級表現(最高、日本一、No.1など)や効能を断定する表現
- 楽天市場外のURL、SNSアカウント名、電話番号
数字は半角で書き、単位を必ず付ける。
手順4は、店舗のフォルダごとにスタイルを選ぶことです。各店舗のフォルダでClaude Codeを起動し、/output-style shop-voiceを実行すれば、その選択がそのフォルダの.claude/settings.local.jsonに保存されます。チーム全員に同じ設定を配りたい場合は、各フォルダの.claude/settings.jsonに"outputStyle": "shop-voice"と書いてリポジトリで共有します。名前は大文字と小文字まで一致させてください。
手順5は、スタイルどおりに書けているかを確かめることです。出力スタイルは指示であって保証ではないので、書き上がった説明文を別の観点で点検します。
プロンプト2:書き上がった商品説明の文体チェック
あなたは当店の商品説明の校閲担当です。
以下の文体ルールに照らして、商品説明文をチェックしてください。
文体ルール:
{プロンプト1で抽出したルール、またはスタイルファイルの本文}
チェックする商品説明文:
{AIが書いた説明文}
出力してほしい項目:
1. ルールに合っていない箇所(該当する文を引用し、どのルールに反するかを書く)
2. 修正案(該当する文だけを書き直す)
3. 景品表示法・薬機法・モールの規約に触れるおそれのある表現
4. 総合判定(そのまま使える/一部修正/書き直し)
条件:ルールにない好みの問題は指摘しないこと。
複数の店舗で同じ商品を出すときは、店舗ごとの文体の違いを一度に確かめておくと、文章の使い回しによるちぐはぐさを防げます。
プロンプト3:同じ商品の説明文を店舗ごとに書き分けて比較する
あなたは複数のECモールを運営する店舗の編集責任者です。
同じ商品について、店舗ごとの文体ルールに合わせた説明文を書き分け、違いを比較してください。
商品情報:{商品名、内容量、原材料、産地、価格帯、主な用途}
店舗ごとの文体ルール:
- 楽天本店:{要約}
- Amazon店:{要約}
- 自社EC:{要約}
出力してほしい項目:
1. 店舗ごとの説明文(楽天市場のスマートフォン用商品説明文は半角2,560文字以内、Amazonの商品説明は半角2,000文字以内に収める)
2. 3つの説明文で、事実(数字・原材料・産地)が食い違っていないかの確認結果
3. 店舗ごとの文体の違いを1行ずつ
条件:事実情報は商品情報にあるものだけを使い、追加しないこと。
失敗例と回避策
出力スタイルでつまずくのは、設定の細かい決まりを見落としたときがほとんどです。
1つ目の失敗は、スタイル名の大文字と小文字の違いです。設定ファイルのoutputStyleにShop-Voiceと書き、ファイル側がshop-voiceだと、名前が一致せず標準のスタイルが適用されます。エラーは出ないので、文体が変わらない理由に気づきにくいのが厄介です。回避策は、名前をすべて小文字とハイフンにそろえ、/output-styleを引数なしで実行して現在のスタイルに印が付いているかを確かめることです。フロントマターの項目名を書き間違えた場合もエラーなしで無視されるため、効いていないと感じたらclaude --debugで読み込みを確認します。
2つ目の失敗は、スタイルファイルを書き換えたのに反映されないケースです。ターミナルではスタイルのファイルを起動時に読み込むので、セッション中に編集した内容は再起動するまで使われません。店舗運営の現場感覚では、文体ルールを少しずつ直しながら試す時期にこのつまずきが起きやすく、「直したのに変わらない」と担当者が混乱します。ルールを直したら一度終了して起動し直す、という手順を運用メモに書いておくと防げます。
3つ目の失敗は、出力スタイルにすべてを詰め込むことです。禁止表現や外部URLの禁止を出力スタイルに書いても、それは指示であって保証ではありません。楽天R-Mailの本文に楽天市場外のURLを入れないといった規約は、プロンプト2のような点検や、決まった語を検出するチェック処理で確実に止めるべきです。また、サブエージェント(別の文脈で動く補助役のAI)は独自のシステムプロンプトで動くため、出力スタイルの影響を受けません。商品説明をサブエージェントに書かせる構成なら、文体の指示はサブエージェント側にも入れておく必要があります。
KPI設計と費用・工数の目安
文体の固定がうまくいっているかは、手直しの量で測るのが分かりやすい方法です。AIが書いた商品説明のうち、そのまま使えた割合、一部修正で済んだ割合、書き直しになった割合を、店舗ごとに月単位で記録します。プロンプト2の総合判定をそのまま集計に使えます。
もう1つの指標は、店舗ごとの文体のぶれです。担当者が変わったり、AIのモデルが新しくなったりしたときに、同じ商品カテゴリの説明文の平均文字数や、1文の平均の長さが大きく変わっていないかを見ます。モデルの更新で文体が変わったと感じたら、スタイルファイルの指示を具体的にする合図です。
費用面では、出力スタイル自体に追加料金はありません。ドキュメントによると、スタイルの指示は入力トークン(AIに渡す文字量)を増やしますが、セッション内の最初のリクエストのあとはプロンプトキャッシュでその負担が下がります。ExplanatoryやLearningのような長めの応答を出すスタイルは出力トークンを増やし、Conciseは逆に減らします。カスタムスタイルの場合は、指示がどれだけの量を書かせるかで変わります。Claude Codeの利用料金は契約しているプランやAPIの料金体系によるので、2026年11月時点の公式の料金表で確認してください。
工数の目安は、手順1〜3の文体ルールづくりに1店舗あたり2〜3時間、手順4の設定は数分です。直近の支援案件で観測した範囲では、最初に作った文体ルールはやや抽象的になりがちで、実際の出力を見ながら何度か具体的に書き直して安定する流れが多く見られました。
今後の展望と独自考察
AIに書かせる文章が増えるほど、「どの店の声で書くか」を仕組みとして管理できるかが、ブランドの差になります。出力スタイルの価値は、文体の決まりごとを担当者の頭の中から取り出し、ファイルとして共有・改善できる点にあります。プラグインのforce-for-pluginを使えば、社内の全員が同じ店舗の声で書く状態を、選択の手間なしにつくれます。
その一方で、出力スタイルは「全応答に効く指示」なので、範囲が広すぎると別の作業の邪魔になることもあります。商品説明以外の作業、たとえば売上データの集計やサイトの改修も同じセッションで行うなら、文体の指示は商品説明を書くスキルの中に入れ、出力スタイルは店舗全体の基本的な口調だけに絞る、という分け方が現実的です。手順を持つスキルの設計については、Agent Skillsの65.7%が知識ではなく手順だという分析が参考になります。
自動化との相性にも触れておきます。/output-styleコマンドは、v2.1.269以降なら非対話モードやAgent SDKのセッション、スマートフォンやWebからのリモート操作でも使えますが、その場合に選べるのは組み込みスタイルだけです。夜間に商品説明をまとめて生成するような自動処理で店舗の文体を使いたいなら、コマンドで切り替えるのではなく、店舗フォルダの設定ファイルにoutputStyleを書いておく方式が確実です。
作ったスタイルやスキルの品質を数字で確かめたい場合は、claude plugin evalで社内AIの品質を担保する方法のように、評価ケースを用意して回す方法もあります。文体ルールの改定前後で、そのまま使える割合がどう変わったかを比べれば、改善が勘ではなく数字で語れるようになります。
よくある質問
出力スタイルとCLAUDE.mdは何が違いますか
出力スタイルとは、Claudeの口調・長さ・形式など「どう応答するか」を決める指示のことです。CLAUDE.mdは、プロジェクトの決まりごとや構成など「Claudeが知っておくべき情報」を書く場所で、選んだスタイルに関係なく読み込まれます。店舗の基本情報はCLAUDE.md、文体は出力スタイル、と分けるのが基本です。
出力スタイルを設定すれば禁止表現は確実に防げますか
いいえ、確実には防げません。出力スタイルはClaudeが従う指示であり、何かが必ず起きる、または決して起きないことを保証するものではないと、公式ドキュメントに明記されています。禁止表現や外部URLの混入は、点検用のプロンプトやチェック処理で別に止めてください。
スタイルファイルを編集したのに文体が変わりません。なぜですか
ターミナルで使っている場合、スタイルのファイルは起動時に読み込まれるためです。セッション中に作成・編集したスタイルは、Claude Codeを再起動すると反映されます。名前の大文字と小文字が設定と一致しているかも確認してください。
店舗ごとに別のスタイルを自動で使い分けられますか
はい、使い分けられます。店舗ごとのフォルダに.claude/output-styles/を置き、各フォルダの設定ファイルでoutputStyleを指定すれば、作業するフォルダに応じてスタイルが選ばれます。同じ名前のスタイルが複数ある場合は、作業ディレクトリに最も近いものが使われます。
組み込みのConciseスタイルは商品説明に向いていますか
いいえ、商品説明の文体づくりには向いていません。Conciseは結果から書き始めて前置きや要約を省くスタイルで、主にClaude Codeとのやり取りを短くするためのものです。商品説明の文体を固定したい場合は、店舗のルールを書いたカスタムスタイルを作ってください。
出力スタイルを使うと料金は上がりますか
スタイルそのものに追加料金はありませんが、指示の分だけ入力トークンが増えます。ドキュメントによると、セッション内の最初のリクエストのあとはプロンプトキャッシュでその負担が下がります。長い応答を書かせる指示にすると出力トークンが増える点には注意が必要です。
まとめ
Claude Codeの出力スタイルを使えば、商品説明の口調・長さ・構成の指示を1つのファイルにまとめ、店舗のフォルダごとに自動で切り替えられます。作業ディレクトリに最も近いスタイルが優先される仕組みを使い、楽天本店・Amazon店・自社ECで同じ名前のスタイルを置くのが扱いやすい形です。ただし出力スタイルは保証ではないので、禁止表現の点検は別に用意してください。最初の一歩は、評価の高い商品説明を5件集め、プロンプト1で文体ルールを抽出することです。
参考文献
著者:齋藤竹紘(株式会社オルセル 編集長/5,000社以上のEC支援実績/書籍3冊)
※うるチカラでは、生成AIの導入支援から運用最適化まで、貴社のEC事業に合わせたカスタマイズ提案を行っています。無料相談(30分)も実施中ですので、お気軽にお問い合わせください。
https://uruchikara.jp/contact/
【監修】齋藤竹紘(株式会社オルセル代表 / 19年・5,000社のEC支援実績)

株式会社オルセル代表取締役 / うるチカラ編集長。19年・5,000社以上のEC支援実績を持ち、楽天市場・Amazon・Yahoo!ショッピング・Shopify・Shopee越境ECの実装ノウハウを保有。AI×ECに関する書籍を3冊執筆。「現場で使えるAI実装」を一次情報として発信しています。