Claude Code SQLと正規表現を安全に書かせる勘所
Claude CodeにSQLや正規表現を書かせる実務ポイントです。SQLの実行経路ごとの権限の効き方と、実行前に行う検査の実例、Grepツールとシェルのgrepで変わる正規表現の前提を扱います。
Claude CodeにSQLや正規表現を書かせると、生成した文字列がその場で実行される経路が複数あることに気づきます。経路ごとに、権限確認の出方も検証すべき点も違います。SQLならMCP接続かBash直接実行か、正規表現ならGrepツールかシェルのgrepかアプリコードか。この3つの分かれ目を押さえておくと、依頼文と安全策の組み立てが楽になります。
SQLを実行させる経路はMCP接続かBash直接実行か
Claude CodeはSQLも、他のコードと同じく自然文の指示から生成します。データベースへ届く道は、MCPサーバー経由かBashでのクライアント直接実行のどちらかです。
SQLが実行されるまでの2経路
MCP接続(DBHub等)
守りの要は接続文字列に入れるDBユーザーの権限です。読み取り専用ユーザーなら、Claudeが書いたSQLが何であっても更新は通りません。スキーマ探索や日常的な集計に向きます。
Bash直接実行(psql -c 等)
守りの要はコマンドごとの権限ルールとフックです。MCPサーバーを入れていない環境でも使えますが、確認の出方が環境によって変わります(次の節)。
実在するMCPサーバーの1つがDBHub(@bytebase/dbhub)で、--dsnに渡した接続文字列でPostgreSQL・MySQL・SQLiteなどに接続できます。公式ドキュメントの例も、読み取り専用ユーザーを使う形です。
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
--dsn "postgresql://readonly:pass@prod.db.com:5432/analytics"MySQL専用サーバーで読み取り専用アクセスを設定する手順はMySQL MCPサーバーの使い方にあります。/mcpでの接続確認や認証まわりはClaude CodeでMCPからデータベースに接続する方法が詳しいです。
psqlの実行で確認が出る環境と出ない環境
Bash直接実行で気になるのは、psql -cやmysql -eのたびに確認が出るかどうかです。答えは、環境の設定によって変わります。
Claude Codeには、確認なしで走る読み取り専用コマンドの組み込み一覧があります(auto modeでは、これらも分類器の審査を待つ場合があります)。中身はls・cat・echo・pwd・head・tail・grep・find・wc・which・diff・stat・du・cdです。読み取り専用形式のgitも入ります。この一覧は設定で変えられません。psqlやmysqlは入っていないので、素の状態なら実行のたびに権限確認が出ます。
例外が2つあります。1つはsandboxです。sandboxを有効にしてautoAllowBashIfSandboxedを既定のtrueのままにすると、sandbox内のBashコマンドは確認なしで走ります。「DBクライアントには必ず確認が挟まる」とは言えなくなる点に注意が要ります。
もう1つは権限モードです。v2.1.283以降は、対話ターミナルとVS Codeの既定がauto mode(分類器が確認の大半を代行するモード)になりました。それ以前のバージョンでは、既定がautoになるのはPro・Max・Teamプランに限られ、他は確認を毎回出すManual modeです。Shift+Tabでモードを切り替えると、ステータスバーにmanual mode onやauto mode onと表示されます。DBクライアントは組み込み一覧の外なので、auto modeでは分類器の判断1つに委ねる形になります。
書き込み系のSQLを流す環境では、この「確認が出る・出ない」に安全を預けないほうが無難です。
Bashの許可ルールでSQLの安全は担保できない
確認を省きたくてBash(psql -c *)のような許可ルールを書く人もいますが、引数を絞るBashルールは抜け道が多い仕組みです。公式ドキュメントは、curl http://github.com/*という一見安全なルールが、オプションの位置・リダイレクト・変数展開ですり抜けられる例を挙げています。psql -cにも同じことが言えます。
内容そのものを検査するなら、PreToolUseフックが向いています。公式ドキュメントのガイドには、rm -rfを含むコマンドをスクリプトで調べ、終了コード2でツール呼び出しを拒否する例があります。同じ仕組みで、DROP TABLEやWHERE句のないDELETE FROMを含むコマンドを止められます。複数のフックが同時に走るときは、deny・defer・ask・allowの順で最も厳しい判定が採用されます。フックの設定項目はClaude Code Hooks完全ガイドにまとめてあります。
OSレベルで全プロセスの動作を制限したいなら、sandboxの有効化が次の段です。権限ルールとフックは.claude/settings.jsonに書き、個人用のsettings.local.jsonと使い分けます。違いはClaude Code settings.json完全ガイドに詳しくあります。
そもそもSQLをその場で実行させる必要があるか
MCP接続もBash直接実行も、Claudeが書いたSQLをその場でデータベースに投げる経路です。もう1つ、リスクの質が変わる選択肢があります。マイグレーションや分析用クエリを.sqlファイルに書かせ、通常のコードと同じくプルリクエストでレビューしてから流す方法です。
この方法では、危険の所在が実行時の権限から、レビューを飛ばして反映してしまう運用の緩さへ移ります。スキーマ変更を伴うマイグレーションや、行数の大きいバッチ更新は、対話セッションでその場で実行するのに向きません。定常的な集計はMCP接続、1回限りの重い変更はファイル化してレビューを挟む、という使い分けが現実的です。
生成されたSQLを実行前に検査する4手順
権限を固めても、SQL自体の正しさは別問題です。生成SQLでありがちなつまずきは、次の4つです。
UPDATEやDELETEにWHERE句が付いていない(全件更新・全件削除)JOINで行が重複し、集計値が水増しされるLIMITなしのSELECT *が想定より大きい結果を返す- 日付範囲の境界(
<か<=か)が意図とずれる
これらを実行前に潰す手順を、SQLite 3.51.0での実行例で示します。テーブルはusers(2行)・orders(3行、金額の合計は350)・tags(usersに紐づく行を持つ)です。
本番の前に挟む4つの検査
- 1
件数だけ数える
本クエリの前に、同じ条件で件数と合計だけを出させます。
SELECT SUM(amount) FROM orders;は350を返します。この数字が、後の手順で突き合わせる基準です。 - 2
JOINの水増しを見る
ordersにusersとtagsを続けてJOINし、同じSUM(o.amount)を取ると、350を上回る値になります。tagsが1ユーザーに複数行あるため、注文が重複して数えられるからです。手順1の基準と合わなければ、JOINの条件を疑います。 - 3
更新はトランザクションで囲む
BEGIN; UPDATE users SET plan='free'; SELECT changes();は2を返します。WHEREを書き忘れた全件更新が、2行すべてに及んだことが数字で分かります。ROLLBACK後にplanを読むと、元のproとfreeに戻ります。 - 4
EXPLAINで計画を見る
EXPLAIN QUERY PLAN SELECT * FROM orders WHERE user_id=1;はSCAN ordersと表示します。インデックスが効かず全件走査になる点が、実行前に分かります。PostgreSQLやMySQLではEXPLAINの出力形式が違うため、読み方は各製品に合わせます。
Claude自身にクエリの意図を説明させ、自分の要求と一致するかを読んでから実行に移す一手間も、実行後に気づくより安く済みます。同じ考え方は、Claude CodeにPolarsを書かせて部分データで試してから全件処理に進むときにも使えます。
正規表現が実行されるのはGrepツール・シェルのgrep・アプリコードの3か所
SQLの次は正規表現です。「正規表現を書いて」という同じ指示でも、行き先は3つに分かれます。
Claude Codeの検索には、Grepツールがあります。公式ドキュメントによると、macOS・Linux・WSLではGrepとGlobが既定のツール集合に入っていません。ClaudeはfindやgrepをBash経由で呼び、Claudeのシェルではbfsとugrepの組み込み版が動きます。この検索はフックや権限ルールから見るとBashの呼び出しです。Windowsでは両ツールが既定で入っています。
macOS・Linux・WSLでGrepツールを使いたいときは、--toolsで名前を挙げるか、--allowedToolsにGrepかGlobを入れます。後者は片方の指定でも両方が戻ります。設定ファイルのallowルールには、この効果がありません。claude --helpの--toolsの説明は、次のとおりです。
--tools <tools...> Specify the list of available tools from
the built-in set. Use "" to disable all
tools, "default" to use all tools, or
specify tool names (e.g. "Bash,Edit,Read").Grepツールが使われる場合、構文はripgrepです。POSIXのgrepとは違うため、波括弧などのメタ文字はエスケープが要ります。公式ドキュメントの例は、Goコードのinterface{}を探すinterface\{\}です。ripgrepはinterface{}をそのまま渡すと、次のエラーを返します。
$ rg 'interface{}' g.txt
rg: regex parse error:
(?:interface{})
^
error: repetition quantifier expects a valid decimal
$ rg 'interface\{\}' g.txt
type T interface{}ripgrepが拒否したパターンやファイルタイプは、診断メッセージごとClaudeに返るので、Claudeはその場で直して再検索できます。v2.1.208より前のバージョンでは、拒否された入力がNo files foundとして報告され、本文にその文字列があっても「無い」ように見えました。古いバージョンで検索結果が空のときは、パターンの拒否を疑う価値があります。
3つ目のアプリコードは別です。バリデーションやログ抽出のコードに埋め込む正規表現は、実行言語(JavaScript、Python、Javaなど)のエンジンが解釈できる構文でなければなりません。依頼文に「検索用か、アプリに組み込むものか」を書いておくと、Claudeが前提とする構文がぶれません。
試し撃ちで見るべき点
Grepツールの出力モードは3つあります。files_with_matches(ファイルパスのみ、既定)・content(マッチ行と行番号)・count(ファイルごとの件数と総数)です。パターンの精度を見るなら、contentを指定させます。
行の境界にも注意が要ります。既定では1行の中だけがマッチ対象で、複数行にまたがるパターンはmultiline: trueを指定しないと、一致するはずの箇所が「マッチなし」になります。.gitignoreに載ったファイルはGrepの検索から外れます。ログや生成物を探すときは、ファイルのパスを直接渡す必要があります。
アプリコード側の正規表現には、別の2点が共通して要ります。1つは貪欲マッチ(.*)と非貪欲マッチ(.*?)の取り違えで、意図より広い範囲を拾っていないかです。もう1つは、ユーザー入力をそのままパターンに埋め込んで、壊滅的バックトラッキング(入力長に対して処理時間が急増し、ReDoSの原因になる現象)を起こす構造になっていないかです。空文字列・改行を含む文字列・想定より長い入力の3種類をテストケースにして、期待どおりにマッチするかを見てから組み込むのが手堅い進め方です。
まとめ
SQLは、実行経路で「どこに安全を置くか」が決まります。MCP接続ならDBユーザーの権限、Bash直接実行ならフックとsandboxです。更新を伴うSQLは、件数の突き合わせとトランザクションでの試行を挟んでから本番に流してください。正規表現は、Grepツールのripgrep、シェルのgrep、アプリの言語のエンジンのどれで動くかを先に決めると、構文の迷いが減ります。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。