初心者向け / 実体験ベース / v1
デスクトップ版Claude Code入門
Spreadsheet・GASで小さな仕組みを作る
Claude Chatは使ったことがある。でも、システムやプログラムは作ったことがない。そんな人が、ターミナルを使わずにClaudeのデスクトップアプリからClaude Codeを始めるためのガイドです。
最初に安心してほしいこと
最初からプログラマーになる必要はありません。
Claude Codeに「何を作りたいか」を伝え、分からない言葉を質問し、変更前後を確認する。まずはこの役割で十分です。ただし、AIが作ったものを本番に反映する前には、人間が確認する習慣を持ちます。
このページでいう「Code」は、Claude Codeのことです。Claude Chatと競争させるのではなく、Chatを相談役、Codeを作業場所として使い分けます。
まず言葉を4つだけ覚える
| 言葉 | かんたんな意味 |
|---|---|
| Spreadsheet | Googleの表計算ソフト。表、入力欄、集計結果を置く場所です。 |
| GAS | Google Apps Script。Spreadsheetを自動処理するためのJavaScriptに似た仕組みです。 |
| ウェブアプリ | URLを開くと画面や処理を使えるようにしたGASの公開方法です。 |
| Claude Code | 自分のフォルダにあるコードを読み、編集し、テストを手伝うClaudeです。 |
| デスクトップアプリ | Claudeをパソコンのアプリとして使うもの。上部の「Code」からClaude Codeを開きます。 |
| CLI | 「コマンドライン」の略。黒い画面に文字で命令する操作方法です。今回は必須ではありません。 |
たとえば、Spreadsheetをデータ置き場、GASを自動処理、ウェブアプリを利用者向けの入口、と考えると分かりやすくなります。
CLIって何？ 今回は使わなくていいの？
CLIは、パソコンの黒い画面（ターミナル）に文字で命令を入力する方法です。Claude CodeにはCLI版もありますが、これは開発者がよく使う入口です。
今回の初心者向け手順では、Claude CodeのCLIを最初から使いません。
Claudeのデスクトップアプリをインストールし、上部の「Code」タブを選び、フォルダを画面から指定します。クリック中心で進められるため、まずはこちらを使うほうが分かりやすいです。
ただし、GASのコードをGoogleからパソコンへ取り出す準備で、claspという道具を使う場合があります。そのときだけ、デスクトップアプリ内の「ターミナル」や、Macのターミナルを使います。CLI版Claude Codeをインストールする必要はありません。
Claude ChatとClaude Codeは何が違うの？
| やりたいこと | 向いている場所 | 理由 |
|---|---|---|
| アイデアを相談する | Claude Chat | 会話しながら考えを整理しやすい |
| コードの意味を聞く | どちらでも | 短いコードならChatでも十分 |
| フォルダ全体を調べる | Claude Code | ファイルを一つずつ貼らなくてよい |
| 複数ファイルを変更する | Claude Code | 関連箇所を探して差分を作れる |
| 変更前に戻す | Claude Code＋Git等 | 変更履歴を残しやすい |
Chatは相談室、Codeは作業場。 Chatで「こういう仕組みを作りたい」と考え、Codeで実際のファイルを確認しながら進めるイメージです。
なぜ初心者でもClaude Codeが役立つのか
1. コードを全部コピーして貼らなくてよい
Chatでは、AIに見せたいコードを自分でコピーする必要があります。Codeでは、許可したフォルダの中をClaude Codeが調べ、必要なファイルを自分で見つけます。
2. 「どこを直したか」が見える
AIの回答をコピーして貼るだけだと、元のコードとの差が分からなくなりがちです。Codeでは、変更したファイルや差分を確認してから進められます。
3. 作ったものを後から説明できる
コードだけでなく、README、使い方、テスト、変更履歴も同じ場所に置けます。「自分しか分からない仕組み」になりにくいのが大きな利点です。
4. 小さく試して、戻せる
最初から全部作り直すのではなく、「この画面の文言だけ変える」「この入力チェックだけ追加する」と小さく進めます。失敗しても、変更前の状態に戻せるようにしておきます。
導入前に準備するもの
- Googleアカウント
- ClaudeのPro / Max / Team / Enterpriseなど、Claude Codeを使える契約
- Claudeのデスクトップアプリを動かせるMacまたはWindowsのパソコン
- 既存GASウェブアプリのバックアップ
- コードを置く作業用フォルダ
Linuxではデスクトップ版ではなくCLIを使います。
このページはMacまたはWindowsのデスクトップアプリ向けです。Windowsでローカルファイルを扱う場合は、Gitのインストールが必要になることがあります。
デスクトップアプリでの導入手順
- まず今のウェブアプリを触らずに確認する
現在の公開URL、何を入力するものか、どのSpreadsheetに書き込むものかをメモします。分からない項目があっても、ここでは変更しません。 - GASのバックアップを作る
Apps Scriptの画面でプロジェクトを開き、現在のコードを保存しておきます。可能ならSpreadsheet自体もコピーし、コピー側を検証用にします。 - Claudeのデスクトップアプリをインストールする
Anthropic公式のダウンロードページからアプリを入れます。Macならアプリケーション、WindowsならスタートメニューからClaudeを起動します。
- Claudeのデスクトップアプリにログインする
普段Claude Chatで使っているアカウントでログインします。 - 上部の「Code」を選ぶ
「Chat」は通常の会話、「Cowork」は別の作業モード、「Code」はパソコン上のコードを扱うモードです。今回はCodeを選びます。
- 「Local」を選ぶ
Localは、自分のパソコンにあるファイルを使うモードです。RemoteやCloudは別の環境で動くため、最初は選ばないでください。 - 「Select folder」を押す
Claude Codeに見せるフォルダを選びます。最初は、今回のGASだけを入れた専用フォルダを選ぶのがおすすめです。
- 最初は「見るだけ」と頼む
いきなり修正を頼まず、何があるか説明してもらいます。Claude Codeは、フォルダ内のファイルを読みながら説明できます。
このフォルダのGASプロジェクトを変更せずに調査してください。
私はプログラミング初心者です。
1. どんなファイルがあるか
2. どのファイルが最初に動くか
3. Spreadsheetのどこを読み書きするか
4. ウェブアプリとしてどの入口があるか
5. 分からないことと、確認が必要なこと
を、専門用語を説明しながら教えてください。- 小さな変更を1つだけ頼む
たとえば「画面の見出しを変える」「入力が空なら警告を出す」など、結果を確認しやすい作業から始めます。 - 変更内容を説明してもらう
「変更したファイル」「変更前後の違い」「確認方法」「元に戻す方法」を必ず聞きます。 - 検証用のウェブアプリで試す
既存の公開URLをいきなり上書きせず、コピーしたSpreadsheetや検証用デプロイで画面・入力・書き込みを確認します。
GASをパソコンに取り込むときだけ使うCLI
デスクトップ版Claude Codeを使うだけなら、CLI版Claude Codeのインストールは不要です。ただし、Google Apps Scriptのコードをローカルフォルダへ取り込むために、Google公式の clasp を使うことがあります。
- Node.jsを準備する
claspを動かすための土台です。Node.jsを入れると、npmという道具の管理コマンドが使えるようになります。 - claspをインストールする
Claude Desktopの統合ターミナル、またはMacのターミナルで実行します。
npm install @google/clasp -g
clasp login- Apps ScriptのスクリプトIDを指定する
Apps Scriptの「プロジェクトの設定」にあるスクリプトIDを使います。
clasp clone <ここにスクリプトID>ここで分からなくなったら、Claude Chatに画面やエラーを見せて相談できます。CLIは「Claude Codeを使うための資格試験」ではありません。
ウェブアプリを壊さないための順番
バックアップ → 調査 → 小さな変更 → 検証用デプロイ → 実機確認 → 本番反映
Claude Codeに任せるのは、主に調査・コード編集・説明・テスト準備です。公開URLの変更、権限設定、トリガー、本番デプロイは、内容を理解してから人間が承認します。
GASのウェブアプリでは、コードが正しくても次の設定が違うと動きません。
- 誰として実行するか
- 誰がアクセスできるか
- どのバージョンを公開しているか
- Spreadsheetへの権限があるか
- 入力した値をどこへ保存するか
これらはコードの中だけでは決まらないため、Claude Codeの報告を読んだうえで、Apps Scriptの画面と実際のURLを人間が確認します。
初心者が最初にClaude Codeへ聞いてよい質問
- 「このファイルは何をしているの？」
- 「この関数は、いつ呼ばれるの？」
- 「この変更でSpreadsheetのどの列が変わるの？」
- 「この作業をする前に、何をバックアップすべき？」
- 「まだ変更せず、選択肢とリスクだけ説明して」
- 「専門用語を使ったら、その場で意味も説明して」
よくあるつまずき
| 困ったこと | まずすること |
|---|---|
| ターミナルが怖い | コマンドを1行ずつ実行し、表示された結果を確認する。分からないまま複数行をまとめて実行しない。 |
npm が見つからない | Node.jsが入っているか確認する。Claude Chatにエラー全文を貼って相談する。 |
| どのフォルダにいるか分からない | Claude Codeに「現在のフォルダと、ここで触るファイルを説明して」と頼む。 |
| コードを変更されたくない | 「変更せずに調査」「コマンド実行なし」と明示する。 |
| ウェブアプリが動かない | コードだけでなく、デプロイ先、実行ユーザー、アクセス権、Spreadsheet IDを確認する。 |
まとめ
初心者にとってClaude Codeの価値は、魔法のように全部作ってくれることではありません。自分のコードを一緒に読み、分からない言葉を説明し、変更前後を見せ、少しずつ作業を進められることです。
最初の目標は「すごいシステムを完成させる」ではなく、既存GASをバックアップし、ローカルで眺め、Claude Codeに変更なしで説明してもらうことです。
公式情報
- Claude Code Desktop Quickstart — デスクトップアプリ、Codeタブ、Localフォルダ
- Claude Code CLI Quickstart — CLIを使いたくなった人向けの補足
- Set up Claude Code — 対応環境と導入方法
- Google Apps Script: clasp — ローカル開発、同期、バージョン、デプロイ
導入方法・対応環境・利用条件は更新される可能性があります。実際の導入時は公式ページの現行記載を確認してください。