超初心者向けGAS をローカルで開発する方法（clasp + Claude code 導入ガイド)の完全詳細解説(Mac & Windows)

はじめに

Google Apps Script（以下 GAS）は、通常ブラウザ上のエディタを使って編集します。Claude などのAIで「Vibe coding」をするときも、多くの人は AI が出力したコードをコピペして対応していると思います。私も長らくその方法で作業していました。

一方で clasp を使えば、ローカル環境で快適に開発できることは知っていましたが、まとまった時間が取れず放置していました。
ところが最近、開発がひと段落したこと、さらに Claude の プロプランで Claude code が使えるようになったことで「clasp + Claude code」の組み合わせを試してみたところ…

👉 体感で2〜3倍速く、しかもエラーが激減。
結果として「もうコピペ作業にはもう戻れない」と感じました。

この記事では、その導入手順を

• 第1回：clasp導入編

• 第2回：Claude code導入編
  に分けて解説します。

特に初心者がつまずきやすい箇所（私自身も引っかかった点）を踏まえ、Mac & Windows対応で、なるべく詳しく手順を紹介します。
なお、私の環境はMacなので具体的な内容はMac中心になります。(Windowsも持っているが全て確認した訳ではありません)

1. Node.js をインストールする

clasp を使うには Node.js が必要です。

1. Node.js 公式サイト にアクセス

2. LTS（推奨版） をダウンロードしてインストール

   • Windows → .msi インストーラを実行

   • Mac → .pkg を実行

3. インストールは標準設定のままでOK

💡 補足：
「LTS」とは Long Term Support（長期サポート版）のこと。安定性重視で初心者は必ずこちらを選びましょう。

2. バージョン確認

インストール後、ターミナル（Mac）または cmd（Windows）で以下を実行します。(node.jsをインストールするとnpmも一緒にインストールされます)

• Mac : ターミナルは「Launchpad ➡︎その他➡︎ターミナル」で表示

• Windows : 検索で「cmd」と入力する「コマンド プロンプト」を選択

node -v
npm -v

👉 どちらもバージョン番号が出れば成功です。

📖 体験談：
私は PowerShell で 「node -v」ではバージョンが表示されたが、「npm -v」 を実行したらエラーが出ました。ChatGPTに聞いて下記を実行したらエラーは解決しました。

Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

3. clasp をインストールする

次のコマンドを実行します。

npm install -g @google/clasp

• npm install → パッケージをインストール

• -g → グローバルインストール（PC全体で使えるようになる）

• @google/clasp → Google公式のclasp

👉 このコマンドは一度だけでOK。

💡 補足：
Mac で「権限エラー」が出たら、最後の手段として sudo をつけて実行します。ただし強力なコマンドなので通常は不要です。

4-1. 作業フォルダを作る(GUI)の場合

開発用フォルダを作成します。(通常のGUIで作成しても大丈夫です)

• Mac → Finderで右クリック →「新規フォルダ」

• Windows → エクスプローラーで右クリック →「新規フォルダ」

👉 フォルダ名は 英数字のみ にしてください。（例：gas-test）

💡 補足：
日本語や空白を含むと clasp でエラーの原因にな場合があります。
もちろんコマンドで下記のように入力しても大丈夫です。

4-2. 作業フォルダを作る(コマンドライン)の場合

📂 Mac / Linux の場合（ターミナル）

mkdir gas-test

• mkdir は make directory の略で「フォルダを作る」コマンドです。

• gas-test が作りたいフォルダ名です。

👉 実行後、ls で確認すると gas-test が作成されているはずです。

ls

📂 Windows の場合（PowerShell / コマンドプロンプト）

mkdir gas-test

• PowerShellでも mkdir が使えます。

• 作成後に確認するなら：(「ls」コマンドでも見れました)

dir

📂 作成したフォルダに移動する

共通して以下で移動できます：

cd gas-test

5. Google アカウントにログイン

次を実行します。

clasp login

ブラウザが開き、Google アカウントでログインすれば認証完了です。

6. Google Apps Script API の有効化

1. Google アカウントでログイン

   • ブラウザで Google Apps Script ホーム を開きます。

2. ユーザー設定ページを開く

   • 左メニューの歯車アイコン（⚙ 設定） → 「ユーザー設定」 をクリックします。

   • 直接アクセスする場合はこちら: https://script.google.com/home/usersettings

3. Apps Script API を有効にする

   • 「Google Apps Script API」 という項目があります。

   • デフォルトでは 無効 になっているので、スイッチを ON に切り替えます。

4. 設定を保存

   • 保存ボタンなどはなく、自動的に反映されます。

   • 数分待ってから、再度 clasp push などのコマンドを実行してください。

📖 体験談：
私は後で実行する「push/pull」で「Apps Script API が有効になっていません」というエラーに遭遇しました。API を有効化しても「すでにファイルは存在します」というエラーが続き、結局そのフォルダでは前に進めませんでした。
👉 新しいフォルダを作り直したら解決しました。

7. プロジェクトを扱う方法

既存プロジェクトを取り込む

作業用のフォルダに移動し下記を入力します

clasp clone <スクリプトID>

👉 スクリプトIDは GASエディタの「設定」からコピーできます。（URLから取る場合は間違えやすいので注意）

📌 スクリプトIDの確認方法

1. GASエディタから確認する方法(スタンドアロン型)

1. Google Apps Scriptエディタ を開きます（script.google.com）。

2. 左上のメニューから 「プロジェクト設定（歯車アイコン）」 をクリック。

3. 「スクリプトID」という項目があり、英数字の長い文字列が表示されます。
   例: AKfycbx12345...abcd

2. Googleドライブから確認する方法(スタンドアロン型)

• スタンドアロン型のGAS（単体で存在するプロジェクト）の場合、

https://script.google.com/home/projects/AKfycbx12345abcdEfGhIjKlMnOpQrStUvWxYz/edit

この場合、AKfycbx12345abcdEfGhIjKlMnOpQrStUvWxYz がスクリプトIDです。

3. コンテナバインド型の場合

コンテナバインド型の場合は、「拡張機能 ➡︎ Apps Script」でGASエディタが表示されるので、それがプロジェクトになります。その後は上記(1 or 2)と同じ方法でスクリプトIDを取得できます。

8. ローカルに取り込んだファイルの確認

Finder(Mac)またはエクスプローラー(Windows)でローカルのフォルダを確認して、ファイルがあれば無事終了です

9. まとめ

ここまででできることは：

• Node.js を入れる

• clasp をインストールする

• Google アカウントでログイン

• clasp cloneで既存プロジェクトをローカルにコピーする

これで GAS をローカル環境で扱える準備完了です！

次回はこの環境を使って、Claude Code で「vibe coding」を実際に体験していきます。

📖 最後の体験談：
clasp は最初こそエラーに悩まされがちですが、一度環境が整えばもうコピペの必要がなく、下記のように開発がスムーズに進みます

・clasp clone (最初だけGASのプログラムをローカルにコピー)
< その後は下記のループ >
・ エラーや変更して欲しい内容をClaude codeに依頼(vibe coding)
・ clasp push(Googleドライブに上書き)
・ GAS上で動作確認
< ここまでをループ >