GASをclaspでローカル開発する方法
｜Claude CodeでGASを書く

claspとは｜GASを手元のファイルとして扱う公式CLI

claspは、Googleが公式に提供しているコマンドラインツール（ターミナルで文字を打って操作するツール）です。GASのプロジェクトを自分のPCにダウンロードし、編集し、またクラウドへアップロードできます。名前は「Command Line Apps Script Projects」の頭文字です。

GASのコードがローカルのファイルになると、何が変わるのか。実務でいちばん効くのは次の4点です。

逆に、10行のスクリプトを1つ書くだけならブラウザのエディタで十分です。claspが効いてくるのは「ファイルが3つ以上に分かれてきた」「同じ仕組みを複数の部署に展開したい」「AIに任せる範囲を増やしたい」というタイミングです。

導入手順｜インストールとApps Script APIの有効化

必要なのはNode.js（JavaScriptをPC上で動かす実行環境）が入ったPCと、Googleアカウントだけです。ターミナルで次を実行します。

# 1. clasp をインストール（Node.js が必要）
npm install -g @google/clasp

# 2. バージョン確認（3系かどうかをここで確かめる）
clasp --version

# 3. Google アカウントでログイン（ブラウザが開く）
clasp login

clasp loginを実行するとブラウザが開き、Googleアカウントの認可画面が出ます。許可すると、以降はそのアカウントの権限でGASプロジェクトを読み書きできます。

新しくプロジェクトを作る場合はclasp create-scriptを使います。

# ゼロから作る場合（スプレッドシートに紐づくプロジェクト）
mkdir my-gas-project && cd my-gas-project
clasp create-script --title "経費集計ツール" --type sheets --rootDir ./src

# --type に指定できる主な値
#   standalone … 単体のスクリプト
#   sheets / docs / slides / forms … 各ファイルに紐づくスクリプト
#   webapp … Web アプリ

--rootDirでコードの置き場所を指定しておくと、プロジェクト直下が設定ファイルだけになって見通しが良くなります。あとから.clasp.jsonで変更もできます。

既存プロジェクトの取り込みとpush・pull

すでに動いているGASをローカルに持ってくるところから始めるのが現実的です。スクリプトIDは、GASエディタの「プロジェクトの設定」画面で確認できます。エディタのURLに含まれる長い文字列でも構いません。

# 既存の GAS プロジェクトを手元に取り込む
# scriptId はエディタの「プロジェクトの設定」で確認できる
clasp clone-script 1AbCdEf...スクリプトID... --rootDir ./src

# 取り込まれるファイルの例
#   .clasp.json          … どのプロジェクトと繋がっているかの設定
#   src/appsscript.json  … プロジェクトのマニフェスト
#   src/コード.js         … 既存のスクリプト

あとは、この2つのコマンドを行き来するだけです。pushがローカル→クラウド、pullがクラウド→ローカルです。

# ローカルの変更をクラウドへ反映する
clasp push

# 保存するたびに自動で push する（開発中に便利）
clasp push --watch

# クラウド側の内容をローカルへ取り込む（作業開始前に実行する）
clasp pull

# ブラウザのエディタを開く
clasp open-script

# 実行ログをターミナルで見る
clasp tail-logs --watch

pushは上書きです。ブラウザのエディタで直接直した内容は、ローカルにpullしていなければpushで消えます。claspを使い始めたら「クラウド側は直接編集しない」をチームのルールにするのが、いちばん確実な事故防止策です。

プロジェクト構成｜.clasp.jsonとappsscript.json

claspのプロジェクトには、役割の違う2つの設定ファイルがあります。混同しやすいので整理しておきます。

{
  "scriptId": "1AbCdEf...スクリプトID...",
  "rootDir": "./src",
  "scriptExtensions": [".js", ".gs"],
  "htmlExtensions": [".html"],
  "filePushOrder": ["src/config.js", "src/main.js"]
}

{
  "timeZone": "Asia/Tokyo",
  "dependencies": {},
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/spreadsheets",
    "https://www.googleapis.com/auth/script.external_request"
  ]
}

# push したくないファイルを .claspignore に書く（.gitignore と同じ書き方）
**/**
!src/**/*.js
!src/**/*.html
!src/appsscript.json

clasp 3系の変更点｜コマンド名とTypeScript

claspは3系でコマンド体系が整理されました。ネット上の解説記事は2系のものが多く残っているため、手順どおりに打ったのに動かない、という混乱が起きやすい状態です。まずclasp --versionで自分の環境を確認してください。

細かい仕様はバージョンによって動きます。困ったらclasp --helpで、いま自分が入れているバージョンのコマンド一覧を確認するのが確実です。記事の情報より手元のヘルプが正しい、と考えてください。

Claude CodeなどAIエージェントと組み合わせる

ここがclaspを入れる最大の理由になりつつあります。Claude Codeのようなターミナルで動くAIコーディングツールは、ローカルのファイルを直接読んで書き換えます。つまりclaspでGASのコードをローカルに置いた瞬間、GASもAIに任せられる対象になります。

# よくある開発ループ
clasp pull                      # 1. 最新のコードを手元に取り込む
# 2. AI に依頼する（例）
#    「src/main.js の集計処理を、getValues の一括読み込みに書き換えて。
#      列の位置はヘッダー名から探す形にして、6分の実行時間制限も考慮して」
clasp push                      # 3. 書き換わったファイルを反映
clasp tail-logs --watch         # 4. 実行しながらログを確認

ブラウザのエディタだけで作業する場合、AIの回答を毎回コピーして貼り付ける手間が発生します。ファイルが5つ、10つと増えるほど、この往復が重くなります。claspがあれば「直して」と言ってpushするだけです。

# GAS プロジェクトの前提（AI に読ませる指示ファイルの例）

## 環境
- Google Apps Script（V8 ランタイム）。Node.js のモジュールは使えない。
- require / import は使わない。ファイルをまたいだ関数はそのまま呼べる。

## 守ること
- シートの読み書きは getValues / setValues で一括。ループ内の getValue 禁止。
- 実行時間は最大6分。超えそうな処理は分割してトリガーで続きを実行する。
- API キーはコードに直書きせず PropertiesService から読む。
- 外部 API は UrlFetchApp を使う（fetch は使えない）。

## 変更後
- clasp push で反映するので、ファイルは src/ 配下に置く。

実務での運用｜Git管理・デプロイ・事故防止

claspを入れたあと、運用で押さえておきたいポイントを挙げます。

まとめ

claspでやることは、突き詰めればclone-scriptで取り込み、pullして直してpushする、これだけです。最初の関門はApps Script APIの有効化、いちばんの注意点はpushが上書きであることの2点に集約されます。

そのうえで得られる価値は、Git管理とAI活用です。GASのコードがローカルのファイルになれば、Claude Codeのようなツールにプロジェクト全体を読ませて修正を任せられます。前提を書いた指示ファイルを1つ置き、破壊的な処理だけは自分の目で確認する——この運用に乗せられれば、GAS開発のスピードは体感で変わります。

なお、clasp 3系はコマンド名やTypeScriptの扱いが2系から変わっています。ネットの記事と挙動が違うと感じたら、clasp --helpで手元のバージョンの正解を確認するのが最短です。