メインコンテンツへスキップ
見出し画像
Photo byroute75th

Claudeで始めるPython開発環境(備忘録)

    この記事で分かること

    • コードを書く環境として、どのプラットフォームを選べばよいかの判断基準/それぞれのシステムのわかりやすい説明

    • 初心者がまず始めるのにおすすめの組み合わせ

    • VS CodeにClaude(Claude Code)を導入する方法

    はじめに


    AIが身近になり、プログラミングでもAIの手を借りられることが当たり前になってきました。
    エラーの意味を聞いたり、書きたい処理の書き方を相談したりと、これまで検索や質問サイトで時間をかけていた部分を、AIがその場で手伝ってくれます。

    中でもPythonは、データ分析から作業の自動化まで、いま求められる作業の多くをこなせる言語です。情報系の分野ではPythonを使う人が多く、AIそのものの開発にもよく使われています。
    そして今では、そのAIがコードを書く作業を手伝ってくれるようになりました。Pythonを学ぶ人にとって、AIは心強い相棒になりつつあります。

    AIの選択肢としては、GoogleのGeminiも十分に候補になります。
    特にGoogle Colab(ブラウザだけでPythonを実行できるGoogleのサービス)で作業している場合は、Geminiがコードのセルを直接手伝ってくれます。セル単位で動けば十分という使い方なら、とても便利です。
    有料のGoogle AI Pro(月額2,900円)に加入すれば上位モデルも使え、最近はColabの有料特典も含まれるようになりました。決して使えない選択肢ではありません。

    ただ、筆者が使っていて気になったのは、「とりあえず動けばよい」という方向に寄りやすいことです。小さな処理ならそれでも困りませんが、デバッグや実装を重ねるうちに話が噛み合わなくなったり、前のやり取りを踏まえているのか分からなくなったりすることがありました。
    この傾向は、筆者の体感では時間帯や時期によっても変わり、安定しない印象です。
    初心者ほど、AIの答えが正しいのかを自分で見分けるのが難しいため、この不安定さは大きな負担になります。

    そこで、コードに強いAIを中心に、目的に合わせてできるだけコンパクトな環境を作ってみよう、というのがこの記事の趣旨です。
    ここでいう「コンパクト」とは、使う道具の数と契約を最小限にして、迷わず続けられる状態のことです。

    なお、今回はCursor(AI機能を組み込んだコードエディタ)を扱いません。Cursorでも最新のClaudeやGPTは使えますが、他社のモデルを使うには上位プランと従量課金が必要です。
    コードにしか使わないツールにそこまで費用をかけるよりも、一つの契約で普段のチャットにもコーディングにも使えるClaudeのほうが、初心者には気軽だと考えました。

    コードを書く環境について(手元のPC、Codespaces、Claude Code on the web、claude.aiのチャット)

    最初の分かれ道:手元のPCか、仮想PCか

    コードを書いて動かすには、それを実行するコンピュータが必要です。その選び方は、大きく二つに分かれます。

    一つは、いま使っている自分のパソコン(手元のPC)で動かす方法です。
    もう一つは、インターネットの向こう側にあるコンピュータを借りて動かす方法です。この借りるコンピュータを、ここでは「仮想PC」と呼びます。
    画面に映っているのは自分のパソコンですが、実際の計算は遠くのコンピュータが行い、その結果だけが送られてくる仕組みです。

    たとえるなら、手元のPCは自宅のキッチン、仮想PCはレンタルキッチンです。自宅のキッチンは、いつでも無料で使えて、道具の置き場所も自分好みにできます。ただ、コンロが小さければ大量の料理は作れません。レンタルキッチンは、広い調理台や大きなオーブンを必要なときだけ借りられますが、使った時間に応じて料金がかかり、ネットという「道」がなければたどり着けません。

    どちらを選んでも、書いたコードはGitHubに預けておけば同じように取り出せます。そのため、「最初は手元で始めて、重くなったら仮想PCに移る」という切り替えも難しくありません。

    選択肢1:手元のPC + VS Code + Claude Code

    自分のパソコンにVS Codeを入れ、拡張機能としてClaude Codeを追加する方法です。もっとも基本的な形で、追加の費用はClaudeの契約だけです。

    パソコンの性能が足りていれば、まずはこの形で十分です。動作が重い、待ち時間が長いと感じたら、次の選択肢を検討します。

    選択肢2:GitHub Codespaces(仮想PCをVS Codeで使う)

    GitHub Codespacesは、GitHubが貸し出している仮想PCです。GitHubに預けたコードを、そのまま仮想PCの上で開けます。見た目も操作もいつものVS Codeとほとんど同じなので、手元のPCから移っても戸惑いません。

    個人のGitHubアカウントには毎月の無料枠があり、計算時間は120コア時間、保存容量は15GBまで無料です。コア時間は「性能×時間」で数える単位で、いちばん小さい2コアの仮想PCなら、月に60時間使える計算になります。無料枠を超えたときは、支払い方法を登録していなければ自動で止まるので、知らないうちに料金がかかる心配はありません。

    選択肢3:Claude Code on the web(作業ごと任せる)

    Claude Code on the webは、Anthropicのクラウドの上でClaude Codeが動く仕組みです。ブラウザやスマートフォンから「この機能を追加して」と頼むと、Claude CodeがGitHubのコードを取り出して作業し、結果を返してくれます。

    自分で仮想PCを用意する必要がなく、パソコンを開かずに作業を頼めるのが強みです。その代わり、コードがGitHubに預けてあることが前提になります。

    選択肢4:claude.aiのチャット(試作と相談)

    いつものClaudeのチャット画面でも、短いコードを書いて実際に動かすところまでできます。環境の準備がいらないので、小さなスクリプトを試したり、エラーの意味を聞いたりするのに向いています。

    ただし、作ったものを長く育てていく場所としては向きません。気に入ったコードができたら、GitHubに預けて選択肢1〜3のどれかに移すのがおすすめです。

    費用の目安:Claudeは一つの契約でまとめられる

    Claude Codeを使うには、Claudeの有料プラン(Pro以上)が必要です。無料プランではチャットは使えますが、Claude Codeは含まれていません。

    その代わり、Proプラン以上に入れば、普段のチャットとClaude Codeを一つの契約で使えます。VS CodeなどのエディタでのClaude Codeも、この契約の範囲に含まれます。チャットとClaude Codeは使用量の上限を共有しているので、片方をたくさん使うと、もう片方で使える量が減る点だけ覚えておきましょう。

    コードを書く道具について(VS Code、Claude Code、GitHub、uv)

    コードエディタとは

    コードエディタとは、プログラムのコードを書くための専用の編集ソフトのことです。
    文字を書くだけならメモ帳でもできますが、コードエディタはコードを色分けして読みやすくしたり、書き間違いをその場で知らせてくれたりします。

    料理にたとえるなら、コードエディタは調理台です。まな板の上でも料理はできますが、包丁やボウルが手の届く場所にそろった調理台のほうが、ずっと作業がはかどります。

    そもそも、コードを書く場所は一つではありません

    Pythonのコードを書く場所には、大きく分けて次のような種類があります。

    • パソコンにインストールしたコードエディタ(VS Codeなど)→PC

    • ブラウザで動くノートブック(Google Colabなど)→仮想PC

    • AIのチャット画面(ClaudeやGeminiなど)→仮想PC

    どこで書いても、最終的にはコードを「.py」か「.ipynb」というファイルにして保存します。
    .pyは上から順に実行するふつうのプログラムのファイル、
    .ipynbはコードと実行結果を一つずつ区切って並べられるノートブック形式のファイルです。
    料理でいえば、.pyは完成した一皿、.ipynbは工程ごとに写真が付いたレシピノートのようなものです。
    どこで作っても、出来上がるものは同じです。

    違うのは、そこにたどり着くまでの経緯です。
    コードがどこで実行されるのか、AIがどこまで手伝ってくれるのか、書いたファイルをどう管理するのか。この違いによって、場面ごとに使い分けることになります。

    この記事では、VS Codeを中心に、Claude Code、GitHub、uvを組み合わせる形をおすすめします。それぞれをキッチンの道具にたとえて説明します。

    VS Code:道具がそろった調理台

    VS Codeは、Microsoftが無料で提供しているコードエディタです。世界中で広く使われていて、困ったときに調べられる情報も豊富です。

    調理台としてのVS Codeの強みは、拡張機能という追加の道具を自由に取り付けられることです。.ipynbのノートブックを開く道具、Pythonの書き間違いを見つける道具、AIを呼び出す道具などを、必要に応じて増やしていけます。

    Claude Code:隣で手を動かしてくれる助手の料理人

    Claude Codeは、Anthropicが提供している、コードを書く作業に特化したClaudeです。VS Codeには拡張機能として取り付けられます。

    チャットのAIは、「この順番で作るといいですよ」とレシピを教えてくれるところまでが基本です。一方でClaude Codeは、実際に調理台に立ち、ファイルを書き換えたり、コードを実行して味見をしたりまで進めてくれます。たとえるなら、口で教えてくれる料理の先生ではなく、隣で一緒に手を動かしてくれる助手の料理人です。
    既定の設定では、ファイルを変える前に確認を求めてくれるので、知らないうちに作り変えられて困ることはありません。

    GitHub:どのキッチンからでも開ける、履歴付きのレシピ帳

    GitHubは、コードをインターネット上に保管しておくサービスです。保管するたびに「いつ、何を変えたか」の履歴が残り、うまくいかなくなったときは前の状態に戻せます。

    たとえるなら、書き直すたびに前の版も残しておいてくれるレシピ帳です。「先週の味付けのほうがよかった」と思えば、いつでもその版に戻せます。
    しかも、このレシピ帳はインターネット上に置いてあるので、自宅のキッチンからでも、レンタルキッチンからでも同じように開けます。後で説明する「手元のPCと仮想PCを使い分ける」ときに、この性質が効いてきます。

    uv:材料リストどおりに食材をそろえる仕入れ係

    Pythonでデータ分析をするときは、Pandas(表のデータを扱う道具)やmatplotlib(グラフを描く道具)といった追加のパッケージを使います。パッケージは、料理でいえば食材や調味料にあたります。

    uvは、このパッケージを準備して管理してくれるツールです。たとえるなら、材料リストを渡すと必要な食材を全部そろえてくれる仕入れ係です。
    どのパッケージを使うかを材料リストとして記録しておけるので、別のキッチンに移っても、同じ食材を同じようにそろえ直せます。
    昔からあるpipという方法でも同じことはできますが、uvのほうが動作が速く、手順も少ないため、これから始める人にはおすすめです。

    迷ったらこの順番で(おすすめの始め方と、次に移るタイミング)

    迷ったらこの順番で

    ここまでで、道具と環境の選択肢がそろいました。とはいえ、最初から全部を使いこなす必要はありません。おすすめは、まず自宅のキッチンで始めて、足りなくなったら外の設備を借りるという順番です。

    ステップ0:下準備(レシピ帳と契約をそろえる)

    どの環境を選ぶにしても、最初に次の二つを用意しておきます。

    • GitHubのアカウント(無料)

    • Claudeの有料プラン(Pro以上)

    GitHubは、どのキッチンからでも開けるレシピ帳でした。最初にここへコードを預ける習慣をつけておけば、後から環境を変えたくなったときも、作りかけのコードをそのまま持っていけます。

    ステップ1:手元のPCで始める

    まずは自分のパソコンにVS Codeを入れ、Claude Codeを取り付けて、作業を始めてみましょう。追加の費用はかからず、ネットが不安定な場所でも作業できます。

    最初の数週間は、ここで「コードを書いて、動かして、GitHubに預ける」という一連の流れに慣れることを目標にします。小さなデータの分析や、練習用のスクリプトであれば、たいていのパソコンで問題なく動きます。

    ステップ2:重くなったらGitHub Codespacesへ移る

    使っているうちに、次のようなサインが出てきたら、仮想PCに移るタイミングです。

    • VS Codeの起動や、コードの実行に毎回長く待たされる

    • 大きなデータを読み込むと、パソコン全体が固まる

    • パソコンのファンが回りっぱなしになり、ほかの作業ができない

    このときは、GitHubに預けてあるコードを、そのままGitHub Codespacesで開きます。調理台(VS Code)の見た目も使い方もほとんど同じなので、場所が自宅のキッチンからレンタルキッチンに変わるだけです。無料枠の範囲であれば、費用もかかりません。

    ステップ3:パソコンを開けないときはClaude Code on the webに頼む

    外出先にいるときや、パソコンを開くほどではない小さな修正を頼みたいときは、Claude Code on the webが便利です。スマートフォンのブラウザから「このグラフの色を変えて」と頼んでおけば、Claude Codeがクラウドの上で作業を進めてくれます。

    キッチンにたとえるなら、助手の料理人に「この料理を仕込んでおいて」と電話で頼んでおくようなものです。帰ってきたら、仕上がりを確認するだけで済みます。

    どのステップでも:claude.aiのチャットは相談役として使う

    いつものClaudeのチャットは、環境を問わず相談役として使えます。「このエラーはどういう意味?」「Pandasでこの集計をするにはどう書けばいい?」といった質問や、短いコードの試作に向いています。

    助手の料理人(Claude Code)が手を動かす係なら、チャットは料理の先生です。手を動かす前に考え方を整理したいときは、チャットで相談してから作業に戻ると、迷いが少なくなります。

    まとめ

    コードを書く場所はいくつかありますが、どこで書いても出来上がるファイルは同じです。違うのは、そこまでの道のりだけです。

    迷ったら、まずは手元のPCにVS CodeとClaude Codeを入れて始めてみてください。コードをGitHubに預けておけば、重くなったときも、外出先から頼みたいときも、同じコードのまま場所だけを変えられます。

    VS CodeへのClaude Codeの導入手順は、別の記事でまとめる予定です。

    この記事が参加している募集

    あなたへのおすすめ