Claude Codeの文章を、GPTで整える仕組みを作る

Claude Codeでサイトやアプリを作っていると、商品説明やお知らせの文章も一緒に作れます。一方で、出てきた日本語は、読点や言い回しにAIらしい調子が出やすく、手直しが必要に感じることがあります。

毎回ブラウザに貼り付けて直す代わりに、OpenAIのAPIを使う小さなスクリプトを用意できます。文章を渡すと、決めておいた方針に沿ってGPTが整え、結果を返す仕組みです。これをClaude Codeから呼べるようにしておくと、文章を作るたびに同じ手順で整えられます。

ムチオ
ムチオ
手で毎回コピペしなくても、仕組みにしておけるんだね。
ルミナ
ルミナ
はい。整え方を決めて組み込むと、同じ基準で繰り返しやすくなります。

まずGPTのAPIキーを用意する

OpenAIのAPIを使うには、APIキーが必要です。APIキーは、プログラムからGPTを呼び出すための鍵です。料金は使うモデルや文章量で変わるため、使い始める前に最新の料金を確認してください。

キーはソースコードに直接書かず、.envのような設定ファイルで管理します。そのファイルを.gitignoreに加えて、GitHubに登録されないことも確認します。キーが漏れると、他人に使われて料金が発生することがあるためです。

文章を整えるスクリプトを作る

スクリプトには、APIキーを読み込み、文章をGPTに送り、返ってきた文章を表示する処理を書きます。「一文を短くする」「不要な前置きを減らす」「事実を補わない」といった整え方の指示も、スクリプト側に設定しておきます。方針を固定しておけば、毎回同じ指示を打ち直さずにすみます。

このスクリプト自体も、Claude Codeに「渡した文章をGPTで整えて返すツールを作って」と頼んで用意できます。

Claude Codeから呼び出せるようにする

作ったスクリプトを、Claude Codeから使える形にします。順番に分けて考えると分かりやすいです。

まず、コマンドとして実行できる状態にします。そのうえでCLAUDE.mdに手順を書いておきます。CLAUDE.mdはClaude Codeに指示を伝えるファイルなので、作業の方針として効きます。たとえば、次のように書きます。

画面に載せる文章を作るとき
・確定前に、必ず整えコマンド(refine)に通してから使う
・整えても、事実や数字は変えない
・分からない情報は補わず、確認が必要な箇所として残す

よく使うなら、スラッシュコマンドやスキルとして登録する方法もあります。整えコマンドを呼ぶ形にしておけば、文章を書いたあとにそれを実行するだけで整えられます。

気をつけたいのは、CLAUDE.mdに書くだけでは、スクリプトが自動で動くわけではないことです。書くたびに必ず通したい場合は、Claude Codeがスクリプトを呼び出す手順や、フックなどの仕組みを別に設定します。

ムチオ
ムチオ
ルールに書くだけじゃなくて、呼び出す形まで作るんだね。
ルミナ
ルミナ
はい。CLAUDE.mdは方針を伝えるところまでで、実行はコマンドやフックで用意します。

整えたあと、事実と具体を確かめる

仕組みで整えられるのは、言い回しまでです。整えた文章も、そのまま使わずに読み返します。整える途中で、もとの文の事実が変わっていないか、伝えたい情報が残っているかを確認します。

そのうえで、商品を使った人の感想や、ほかとの違い、どんな場面で役立つかといった、自分で確かめた具体は、人が足します。この確認と、具体を足すところが、文章を自分のものにする部分です。

一度作ると、次の工夫につながる

整えの仕組みは、一度作っておくと、次からは同じ手順で使えます。同じように、よく使う作業をスクリプトにして、CLAUDE.mdやスキルに足していくと、Claude Codeの使い方を自分の環境に少しずつ積み上げていけます。文章の整えは、その最初の一つにできます。

APIキーの用意や、整えツールをCLAUDE.mdやスキルから呼び出す設定は、初めてだと手が止まりやすいところです。Claude Codeで自分のサービスを作りながら、こうした仕組みづくりまで進めたい方は、実際の環境を見ながら相談してみる方法もあります。ZELK IT・AI相談所では、Claude Codeの設定から文章の整え方まで、進め方を1対1で一緒に整理しています。