Claude Codeを使い始めたばかりで、「設定ファイルって何をどう変えればいいんだろう」とモヤモヤしていませんか。実は、settings.jsonをうまく使いこなすだけで、毎日の繰り返し作業をほぼ自動化できるようになります。この記事では、settings.jsonの基本的な役割から、副業に直結する具体的な設定例まで、順を追ってお伝えします。
settings.jsonとは何か
settings.jsonは、Claude Codeの動作をカスタマイズするための設定ファイルです。Claude Codeはデフォルト状態でも十分に使えますが、settings.jsonに設定を追記することで、「どのコマンドを自動的に許可するか」「どのファイルにアクセスしてよいか」「特定の操作の前後に何をするか」といった細かな挙動を自分好みに変えられます。
たとえば、WordPressの記事投稿スクリプトを毎日実行するとき、毎回「このコマンドを実行してもいいですか？」と確認が入ると手間ですよね。settings.jsonに許可リストを書いておけば、Claude Codeが自動で判断して実行してくれるので、確認待ちのストレスがなくなります。
settings.jsonには、配置場所によって3種類あります。まずユーザー全体に適用される「グローバル設定」、特定のプロジェクトだけに適用される「プロジェクト設定」、そして同じプロジェクト内でも自分のマシンだけに適用される「ローカル設定」です。この3階層を理解しておくと、設定の使い分けがとてもスムーズになります。
settings.jsonの設定手順
実際にsettings.jsonを編集するところから、一緒に進めてみましょう。
ステップ1：ファイルの場所を確認する
グローバル設定のsettings.jsonは、WindowsならC:\Users\ユーザー名\.claude\settings.json、Macなら~/.claude/settings.jsonにあります。プロジェクト設定は、各プロジェクトのルートフォルダ直下に.claude/settings.jsonとして作成します。ファイルが存在しない場合は、新規作成してもかまいません。
ステップ2：基本構造を把握する
settings.jsonはJSON形式のファイルで、主に3つのキーを使います。permissionsは許可・禁止するツールや操作の定義、hooksはClaudeが何かをする前後に実行するシェルコマンドの定義、envは環境変数の設定です。まずはこの3つを覚えておけば、大半のカスタマイズに対応できます。
{
"permissions": {
"allow": [
"Bash(node:*)",
"Bash(npm run:*)"
],
"deny": []
},
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "echo 'Claude finished' >> ~/claude-log.txt"
}
]
}
]
}
}ステップ3：permissionsで許可リストを作る
副業自動化でよく使う許可設定を紹介します。allowの配列に追記するだけで、そのコマンドへの確認プロンプトが省略されます。nodeスクリプトの実行を許可したい場合は"Bash(node:*)"、curlコマンドを許可したい場合は"Bash(curl:*)"と記述します。ただし、セキュリティリスクのある操作（rm -rfなど）は絶対に許可リストに入れないよう、ここは慎重に設定しましょう。
ステップ4：hooksで自動処理を追加する
hooksは、Claudeのアクションをトリガーにして外部コマンドを実行できる仕組みです。たとえばClaudeが作業を終えたタイミング（Stop）でSlackに通知を送ったり、ファイルを編集したタイミング（PostToolUse）でGitにコミットしたりと、アイデア次第でさまざまな自動化が実現できます。慣れてくると、この仕組みが副業効率化の核になってきます。
副業での実践的な活用例
実際に副業でどう活用できるか、具体的なシーンを3つ紹介します。
活用例1：WordPress記事の自動投稿
ブログ収益化に取り組む方にとって、記事投稿の手間を減らすことは大きなメリットです。permissions.allowにcurlとnodeの実行を許可しておくと、「この記事をWordPressに投稿して」と指示するだけで、ClaudeがREST API経由の下書き作成から送信まで自動でこなしてくれます。毎回の確認プロンプトがなくなるので、10記事投稿するときも流れるように作業が進みます。
活用例2：作業完了のSlack通知自動化
副業は本業の合間に進めることが多いので、「Claudeがどこまで終わったか」をリアルタイムで把握したいですよね。hooksのStopイベントにSlack Webhookへのcurlコマンドをセットしておくと、Claudeが一連の作業を終えた瞬間にスマートフォンへ通知が飛んできます。外出先でも進捗を確認できるので、隙間時間を無駄なく使えるようになります。
活用例3：SEOキーワード調査の自動記録
キーワード調査の結果をいちいちコピーしてスプレッドシートに貼り付けるのは、意外と時間がかかるものです。PostToolUseフックを活用して、Claudeが分析ツールを呼び出すたびに結果をCSVファイルへ自動追記するようにしておけば、調査が終わった時点でデータがきれいに揃っています。月次レポートの作成時間を大幅に削減できますよ。
3種類のsettings.jsonの比較
settings.jsonには3種類あると最初にお伝えしました。それぞれの特徴と使いどころを表にまとめてみます。
| 種類 | ファイルパス | 適用範囲 | 向いている設定 |
|---|---|---|---|
| グローバル設定 | ~/.claude/settings.json | すべてのプロジェクト | 常用コマンドの許可、通知hookなど |
| プロジェクト設定 | .claude/settings.json | 特定プロジェクト（チーム共有可） | プロジェクト固有スクリプトの許可、共通環境変数 |
| ローカル設定 | .claude/settings.local.json | 特定プロジェクト（自分のみ） | 個人の認証情報参照、テスト用hook |
グローバル設定はどこからでも使いたい共通ルールに最適で、プロジェクト設定はチームメンバーと共有する設定に向いています。ローカル設定は自分だけが使う設定や、Gitにコミットしたくない情報（APIキーの参照先など）に使うのがベストです。特にローカル設定ファイルは.gitignoreに追加しておくと、認証情報の流出リスクをしっかり防げます。
よくある失敗と注意点
settings.jsonを触り始めたばかりの方が陥りやすいミスをまとめます。事前に知っておくだけで、かなりの時間ロスを防げるので、ぜひ目を通しておいてください。
JSON構文エラーで設定が読み込まれない
よくあるのが、末尾のカンマ（trailing comma）をつけてしまうミスです。JSONは最後の要素にカンマをつけるとエラーになり、設定ファイル全体が無効になってしまいます。設定を変更したあとは、必ずJSONバリデーターで確認する習慣をつけましょう。VS Codeを使っているなら、ファイルを開いた状態でエラー表示が出ないか確認するだけでOKです。
permissionsに認証情報を直接書いてしまう
設定ファイルにcurl -u "user:password"のような形で認証情報を直書きしてしまうと、GitHubへのpushやOneDriveの同期を通じて情報が流出するリスクがあります。必ず$WP_USER:$WP_PASSのような環境変数形式で参照するようにしてください。認証情報は.envファイルで管理し、.gitignoreに追加しておくのが基本です。
許可しすぎて意図しない操作が走る
"Bash(*)"のようにワイルドカードで全コマンドを許可してしまうのは危険です。Claudeが誤って破壊的なコマンドを実行しても、確認プロンプトが出ないまま処理が進んでしまいます。許可するコマンドは必要最小限に絞り、特にrmやgit reset --hardなどのコマンドは許可リストに入れないよう意識しましょう。
まとめと次のアクション
settings.jsonは「Claude Codeに何を任せるか」を決める司令塔のようなファイルです。最初は少し難しく感じるかもしれませんが、基本構造（permissions・hooks・env）を押さえてしまえば、あとは少しずつ設定を追加していくだけで、どんどん使いやすくなっていきます。
副業自動化の観点では、まず「毎回確認が面倒だと感じているコマンド」をpermissions.allowに追加するところから始めてみましょう。それだけでもClaudeとの作業がずっとスムーズになります。慣れてきたら、作業完了通知のhookを設定してみると、副業の進捗管理がぐっとラクになりますよ。
まずは今日、グローバルsettings.jsonを開いて、1つだけ許可コマンドを追加してみることをおすすめします。小さな一歩が、副業自動化の大きな積み重ねになっていきます。
実装前に確認したい自動化設計メモ
自動化の記事は、ツール名を覚えるだけでは実務に落とし込みにくいです。実装前に、何を自動化し、どこで人間が確認するかを決めると失敗を減らせます。
| 確認項目 | 判断基準 | 次の行動 |
|---|---|---|
| 対象作業 | 毎回同じ手順で発生しているか | まず手順を書き出し、判断が必要な箇所を分ける |
| 入力データ | どこから取得し、誰が閲覧できるか | API、フォーム、スプレッドシートなど入力元を固定する |
| 停止条件 | エラー時に止まる仕組みがあるか | 通知、ログ、手動確認ポイントを用意する |
手順を分解
小さく自動化
ログで改善
確認チェックリスト
- APIキーや個人情報を記事通りに扱わず、自分の環境で権限を確認する
- 最初から完全自動にせず、通知までの半自動で試す
- 実行頻度を高くしすぎない
- エラー通知とログ保存を用意する
- 公式ドキュメントで最新仕様を確認する
この記事を読む前に整理したいこと
ツール名は分かってきたものの、実際にどの業務を自動化すればよいのか、どこまで任せてよいのかで迷いやすいテーマです。 そのため、この記事では「知識を増やす」だけではなく、読後に何を確認し、どの順番で試すかまで分かるように整理します。
この記事では、いきなり大きな仕組みを作る前に、対象業務の選び方、設計の順番、失敗しやすいポイントを具体的に整理します。 すでに少し触ったことがある方は、表の判断軸から読み始めても大丈夫です。これから始める方は、最初に小さな一歩を決めるつもりで読んでみてください。
この記事で持ち帰れること
- 自分に関係するポイントと、今は無視してよいポイントを分けられます。
- ツール名や流行語ではなく、作業時間・費用・安全性・再現性で判断できます。
- 読後にそのまま試せる小さな手順と、失敗したときの修正方法が分かります。
判断基準の早見表
| 見るポイント | 確認する内容 | 行動の目安 |
|---|---|---|
| 毎回同じ手順がある | 請求書整理、問い合わせ分類、定期レポート作成 | 最初の自動化候補にしやすい |
| 判断が必要な箇所がある | 例外対応、承認、個人情報の確認 | 人間の確認ポイントを残す |
| 外部サービスとつながる | フォーム、スプレッドシート、メール、Slack | 権限とログを先に確認する |
実践までの流れ
対象業務を1つ選ぶ
入力・処理・出力に分ける
失敗時の停止条件を決める
半自動で試してから広げる
よくある失敗と直し方
| 失敗しやすい点 | 修正の考え方 |
|---|---|
| 最初から完全自動化を狙う | 通知だけ、下書き作成だけなど、人が確認できる範囲から始める |
| APIキーや個人情報の扱いを後回しにする | 権限、保存場所、共有範囲を実装前に決める |
| 動いた瞬間に完成と考える | エラー時の通知、ログ、再実行手順まで確認する |
そのまま使える整理テンプレート
この業務は、毎回「入力→判断→出力」の順で発生しています。まずは入力元を固定し、判断が必要な箇所だけ人が確認し、出力先を1つに絞って自動化します。
読者の方からよく出る疑問
初心者でも、この記事の内容をすぐ試せますか？
最初から大きな成果を狙う必要はありません。まずは1つの作業、1つのツール、1つの成果物に絞ると試しやすくなります。うまくいった型だけを残し、次の記事や次の作業へ広げるほうが安全です。
情報が古くならないか心配です。
AI関連の料金、機能名、利用規約、API仕様は変わりやすい分野です。この記事では考え方と実践手順を中心に整理していますが、実際に契約・導入・納品する前には公式情報をご確認ください。
結局、何から始めればよいですか？
まずは「自分が毎週困っている作業」を1つ選んでください。その作業を短縮するために、この記事の表から確認項目を1つ選び、30分だけ試してみるのがおすすめです。小さく試すほど、失敗しても戻しやすくなります。
実務で使える完成例・判断基準・運用フォーマット
この記事は、読んで終わりではなく、実際の作業に移せることが重要です。そこで、テーマに合わせて「完成例」「判断基準」「コピーして使える運用フォーマット」を整理します。空欄だけのテンプレートではなく、まず完成形を見てから自分用に置き換えられる構成にしています。
| 観点 | 見るべきこと | 実務での判断例 |
|---|---|---|
| 事前準備 | 先に用意するもの | アカウント、APIキー、対象データ、保存先 |
| 実行手順 | どの順番で進めるか | 最小構成で動かし、後から拡張する |
| 確認方法 | 成功したと判断する条件 | ログ、通知、出力物、表示結果を見る |
| 失敗時 | 止まった時の見直し先 | 認証、権限、列名、入力形式、回数制限 |
完成例とコピー用フォーマット
【手順実行メモ】 テーマ：Claude Codeのsettings.json完全解説｜副業自動化に使える設定一覧 想定シナリオ：読者が今日1つだけ試し、結果を記録して次の改善へつなげる場面 事前準備： - 使用ツール： - 必要なアカウント： - 入力データ： - 保存先： 実行手順： 1. 2. 3. 成功条件： - 失敗した時に見る場所： - 認証・権限 - 入力形式 - ツール側の制限 - ログ・通知
公開前・実行前の品質基準
- タイトルで約束した内容が、本文内の表・例・フォーマットで回収されている
- 読者が自分の状況に置き換えて使える
- 料金、仕様、規約など変わりやすい情報を断定しすぎていない
- 失敗した時に確認する場所が書かれている
- 次の行動が1つに絞られている
