「同じ作業を、毎回ゼロから手作業でやり直している」。業務のなかには、こういう繰り返しの手続きが意外とたくさんあります。タスク管理ツールへの登録、決まったフォーマットのレポート作成、外部サービスへのデータ投入。手順そのものは決まっているのに、毎回同じ操作を繰り返している。

Claude Desktop の スキル を使うと、こうした「一度やった手順」をそのまま手順書として保存し、次回からは自然な言葉の指示だけで再現できます。この学習編では、その考え方の中心にある「API」と「スキル化」を、非エンジニアの方に向けてかみ砕いて解説します。

ひとことで言うと：API は「サービスを外から操作するための窓口」。一度その窓口を使ってやった一連の作業をスキルにして保存しておくと、次からは「あれをやって」と言うだけでAIが同じ手順を再現してくれる。毎回の手作業と"車輪の再発明"をまとめて減らせます。
操作はすべて Claude Desktop アプリで行います。 本シリーズは、アプリを開いて上部の「Code」タブから操作する前提です。ターミナル（黒い画面）やコマンドの打ち込みは使いません。この記事は考え方の解説で、実際の画面操作は実践編で扱います。

このシリーズ（Claude Code を学ぶ）

  1. 基礎 ― 全体像と拡張機能の地図
  2. Skills（学習編）― 繰り返す手順を覚えさせる
  3. Skills（実践編）― 作って、つまずいて、直す
  4. Subagents（学習編）― 作業を別の文脈に切り出す
  5. Subagents（実践編）― 温泉宿を調べて比較する
  6. Hooks（学習編）― 特定のタイミングで自動実行する
  7. Hooks（実践編）― 編集したら自動でチェックを走らせる
  8. MCP（学習編）― 外部サービスへの接続口
  9. MCP（実践編）― Google ドライブ連携でつまずいた話
  10. Plugin（学習編）― 作った部品をひとつの箱にまとめる
  11. Plugin（実践編）― 便利設定を箱に詰めて配る
  12. Marketplace（学習編）― 箱を並べて配る
  13. Marketplace（実践編）― お店に公開し、取り込む
  14. 番外編 ― 拡張機能の選び方チートシート
  15. 拡張編① Agent Teams（学習編）― 複数のAIをチームで動かす
  16. 拡張編② Agent Teams（実践編）― 3人チームで多角的にレビューする
  17. 「これ実行していい？」が毎回つらい ― 権限モードと許可のバイパス
  18. マネジメント層のためのデスクトップアプリ入門 ― 非エンジニアのClaude Code
  19. API活用をスキル化する（学習編）― 反復作業を手順書にして再現する（この記事）
  20. API活用をスキル化する（実践編）― タスク登録の流れを丸ごと再現する
  21. AIに動画をつくらせる（学習編）― スキルパックと外部APIの仕組み
  22. AIに動画をつくらせる（実践編）― スキルパックで動画を1本つくる
  23. Planモードと /goal（学習編）― 先に計画・完了条件で自走
  24. Planモードと /goal（実践編）― ストップウォッチで試す
  25. ルーチン（学習編）― 定期的な確認作業をAIに任せる
  26. ルーチン（実践編）― 朝の確認作業を自動化する

そもそも「API」ってなに？

API（エーピーアイ）は、ひとことで言えば サービスの操作窓口 です。私たちが普段アプリの画面をマウスでクリックして操作するのに対して、API は「プログラムから同じ操作を頼むための入り口」だと考えてください。

たとえばタスク管理ツールに「新しいタスクを追加する」という操作があるとします。画面から手で追加することもできますが、その裏には必ず「タスクを1件追加してください」とプログラムからお願いできる窓口（API）が用意されています。Claude Desktop は、この窓口を通じてサービスを直接操作できます。画面をクリックして操作する代わりに、AIに"窓口越しに"作業を頼める——これが API 活用の出発点です。

反復作業は「手順書」にして繰り返す

API を使った作業も、一度やってみると「①窓口の場所を調べて、②必要な情報をそろえて、③この順番で頼む」という決まった流れが見えてきます。この流れを毎回ゼロから組み立て直すのは、まさに"車輪の再発明"です。

そこで登場するのが スキル です。スキルは「こういうときは、こういう手順でやる」という手順書をAIに持たせておく仕組み。一度うまくいった作業をスキルにしておけば、次からはその手順を毎回説明する必要がありません。

Claude Desktop の Code タブで、作業フォルダの .claude フォルダ内に skills が生成された状態のファイル一覧。
▲ スキルは作業フォルダの .claude フォルダ内に保存される

スキルにすると、何が変わるか

観点毎回手作業スキル化したあと
手順の説明毎回ゼロから指示し直す「あれをやって」で通じる
ミス手順を思い出す過程で抜け漏れ決まった手順で安定
引き継ぎ頭の中にしかない手順書として残り、共有できる
応用似た作業もまた一から少し書き換えれば流用できる

秘密の情報は「.env」に置く

外部サービスの窓口（API）を使うときは、たいてい アクセストークン と呼ばれる"合鍵"が必要になります。これは他人に知られてはいけない秘密の情報です。

Claude Desktop では、こうした秘密情報を .env（ドットエンブ） という専用ファイルにまとめて保管するのが定石です。トークンやプロジェクト名などを .env に書いておけば、次回以降もAIがそこを参照して作業を再現できます。

トークンをチャット欄に貼り付けないこと。 秘密情報は .env ファイルを直接開いて書き込みます。チャットに直接貼るのはセキュリティ上おすすめできません。画面共有や録画のときにも、.env の中身は映さないよう注意してください。

スキルとサブエージェントの役割分担

「決まった手順の再現」はスキルの役目ですが、Claude Desktop には サブエージェント という仕組みもあります。ざっくり言えば、スキルが「手順書」、サブエージェントは「その作業だけを任せる担当者」です。反復作業はスキルにまとめ、切り出したい調査・確認は担当者に振る——という使い分けができると、AIに任せられる仕事の幅が広がります。

▶ 実践編につづく

次回は実際に手を動かします。タスク管理サービスの API を使ってタスクを登録し、その一連の流れをスキルにして、別のセッションで自然な言葉だけで再現するまでを、Code タブの操作手順に沿って確かめます。

API活用をスキル化する（実践編）― タスク登録の流れを丸ごと再現する →

まとめ

  • API は サービスの操作窓口。画面をクリックする代わりに、AIに窓口越しの作業を頼める。
  • 一度うまくいった一連の手順は スキルとして保存し、次からは自然な言葉の指示だけで再現する。
  • スキルは作業フォルダの .claude フォルダに保存され、手順書として残り共有もできる。
  • トークンなどの秘密情報は .env ファイルに保管し、チャットには貼らない。
  • 反復手順はスキル、切り出したい作業はサブエージェント、と役割を分けると効率的。