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



