Claude Code導入チェックリスト｜インストールから最初のテスト追加まで

更新日：2026年11月13日

Claude Codeを起動した後、すぐに普段の開発リポジトリを渡す必要はありません。空の練習フォルダーに小さな関数とテストを作り、読み取り→テスト追加→差分確認の順に試します。 完了条件は、変更内容とテスト結果を自分で説明できることです。

対象はターミナル・Git・Pythonの基本操作ができる開発者です。本稿のコマンド例はmacOS向けです。Python・Gitの教材操作はローカルで検証しましたが、Claude Codeの新規インストール・ブラウザー認証・AIによるテスト生成は今回未検証です。画面の文章や生成コードを再現保証するものではありません。本記事に広告・アフィリエイトリンクはありません。

1．利用方法と費用の出どころを確認する

公式クイックスタートで、OSに合うインストール方法と利用可能なアカウントを確認します。Claudeの対応サブスクリプション、Claude Console、組織の対応クラウド経由などで認証経路が異なります。会社の利用では管理者指定の方法を使ってください。

インストールできたことと、推論を利用できる契約・残高があることは別です。Consoleを使う場合などは、課金先と利用上限も確認します。契約・認証の選び方は公式の認証案内を参照してください。

macOSでHomebrewを利用している場合、公式に案内されている選択肢は次です。未導入の場合だけ実行します。Homebrewを使わない人、Windows・Linuxの人は公式ページの該当手順を選んでください。

brew install --cask claude-code
claude --version

バージョンが表示されれば、CLIを呼び出せています。command not foundなら再インストールを繰り返す前に、新しいターミナルを開いてPATHを確認します。Node.jsの確認を全員の前提にせず、選んだインストール方式の要件に従います。

10月の確認環境はmacOS（Darwin arm64）、Python 3.14.2、Git 2.50.1、既存のClaude Code 2.1.30です。11月13日はPython 3.9.7で教材を再実行し、CLIの2.1.30表示とヘルプを再確認しました。claude --versionとヘルプの表示のみ確認しており、最新公式資料の全機能をこの版で検証したという意味ではありません。

「導入できた」を3段階に分けて記録する

スマートフォンでは表を左右にスクロールできます。

/statusの表示を外へ共有する必要はありません。個人・組織アカウントやAPIキーの設定が複数ある場合、想定した課金経路かを確認します。認証できないときはCLIの再インストールを繰り返すより、公式の認証案内と組織の管理者に沿って調べます。公式の認証経路と/statusの説明

Homebrewで導入したCLIは、公式クイックスタートでは自動更新されない方式として案内されています。新機能の手順と手元の版が合わない場合は、導入方式を確かめてから更新方法を選びます。この記事の確認環境は既存の2.1.30で、最新の画面・コマンド全部を実機確認したものではありません。公式の導入・更新方法

2．空の練習フォルダーを作る

以下はまだAIを呼びません。同名フォルダーが存在する場合は停止するので、別の名前を選んで最初から進めます。以下の exit 1 は失敗時にそのシェルを終了し、後続操作を防ぐためのものです。

mkdir claude-first-test || exit 1
cd claude-first-test || exit 1
git init
printf '__pycache__/\n' > .gitignore
python3 --version
git --version

このフォルダーに、次の内容を name_tools.py としてUTF-8で保存します。実際の顧客データは使いません。

def normalize_name(value: str) -> str:
    return " ".join(value.strip().split()).title()

続いて test_name_tools.py を保存します。

import unittest
from name_tools import normalize_name

class NameTests(unittest.TestCase):
    def test_spaces(self):
        self.assertEqual(normalize_name("  ada   lovelace "), "Ada Lovelace")

if __name__ == "__main__":
    unittest.main()

変更前のテストとGitの基準点を作ります。コミット用の名前・メール設定がない人は、自分の環境の設定を確認してからコミットしてください。

python3 -m unittest -v
git add name_tools.py test_name_tools.py .gitignore
git commit -m "Add practice function and baseline test"
git switch -c practice/add-tests

ローカルで検証した基準テストは Ran 1 test と OK になりました。Gitのブランチ名やコミットIDは環境ごとに異なります。テストが失敗したらAIの起動前に、ファイル名・保存先・コピー漏れを確認します。

Claude Codeを利用できない場合も、ここまで練習できる

契約や組織の利用許可を用意できない場合は、段階2の基準テストまで進め、段階4に掲載した2つのテストを自分で追加します。python3 -m unittest -v で3件の合格を確認し、git diff -- name_tools.py test_name_tools.py で「関数は変わらず、空文字と日本語のテストだけが増えた」と説明できれば、手作業の演習は完了です。段階3の起動・依頼文の入力は飛ばします。

記録には「手作業で追加／AI生成は未実施」と書きます。Claude Codeの操作習得やAIの生成品質を確認した結果には数えません。契約を用意した後に、別の練習フォルダーで段階2からやり直すと、手作業の結果と混同せず比較できます。

次はAI修正の切り分け演習で、APIキーやネット接続を使わず「失敗→修正→同じ失敗の再現」を確かめられます。PythonやGitの操作で止まった場合は、そのエラーを解決してから先へ進みます。

3．練習フォルダーから起動し、読み取りだけ依頼する

ターミナルの作業場所を確認してから起動します。

pwd
claude

初回は画面の案内で認証します。起動したフォルダー、アカウント、利用する権限モードを確認してください。権限を一律に飛ばす設定は使いません。認証画面の詳細は版と契約によって変わるため、本稿では固定の画面文言を成功条件にしません。

Claude Codeの入力欄へ、次を渡します。これは依頼文の例で、今回取得した実際の応答ではありません。

name_tools.py と test_name_tools.py を読んで、関数の動作と
既存テストが確認していることを説明してください。
ファイル変更・コマンド実行・外部接続はしないでください。
空文字と日本語入力の期待結果も、コードを読んで説明してください。

人が確認する答えは、前後の空白を除き、連続する空白を一つにして、英字の単語をタイトル形式にすることです。空文字は空文字、日本語の " 山田 太郎 " は "山田 太郎" になります。この処理は教材用で、人名表記の一般的な正規化仕様として採用するものではありません。

4．関数を変えず、テストを2件追加する

説明を確認したら、作業範囲を絞って依頼します。

test_name_tools.py だけに、空文字と日本語入力のテストを追加してください。
期待結果は normalize_name("") == "" と、
normalize_name("  山田   太郎 ") == "山田 太郎" です。
name_tools.py は変更せず、依存追加・コミット・外部接続はしないでください。
テストを実行する場合は python3 -m unittest -v を使い、結果を示してください。

AIが示す実行結果だけで完了とせず、終了後に自分のターミナルでも確認します。

python3 -m unittest -v
git status --short
git diff --stat
git diff -- name_tools.py test_name_tools.py
git diff --cached -- name_tools.py test_name_tools.py

期待する状態は、既存1件と追加2件の合計3テストが合格し、関数本体が変わっていないことです。次の2メソッドは編集部が用意してローカル実行した確認例です。AIの生成結果の転載ではありません。クラス NameTests 内へ追加できます。

    def test_empty(self):
        self.assertEqual(normalize_name(""), "")

    def test_japanese(self):
        self.assertEqual(normalize_name("  山田   太郎 "), "山田 太郎")

ローカルでは追加後 Ran 3 tests・OK を確認しました。未ステージとステージ済みの差分を両方読みます。??の新規ファイルの本文は通常のgit diffには出ないため、エディターでも確認してください。AIが同じ名前のメソッドを出す必要はありませんが、入力と期待結果は一致させます。関数まで書き換えた、テストを削った、依存を追加した場合は採用を保留し、その差分を確認してから修正を依頼します。

止まったときは、段階ごとに切り分ける

結果を残し、次の作業を決める

実施日／OS／Python・Git・Claude Codeの版：
導入方法／CLIの起動可否：
認証経路・課金先を自分で確認：済・未確認
実施方法：Claude Codeで生成・手作業で追加
基準1テスト／追加後3テストの結果：
変更ファイル／関数本体の変更有無：
未追跡・未ステージ・ステージ済みの確認：
止まった段階／次に確認すること：

キー・トークン・メールアドレスなどを記録欄へコピーする必要はありません。認証確認だけで終わった場合や、手作業でテストを足した場合は、その段階を記録し、AIで課題を完了した結果とは分けます。

最初の作業を終えるチェック

入力した指示、追加テスト、差分、自分で実行した結果を残します。コミットする前にGit差分レビューの練習で、未追跡・未ステージ・ステージ済みを確認してください。

毎回同じテスト手順を伝えるのが負担なら、CLAUDE.mdの保存と確認へ進みます。操作や実装のどこで止まったかを記録できれば、独学と講座の選び方でも、必要な支援を具体的に比較できます。

出典と検証範囲

公式情報再確認・教材再検証：2026年11月13日。

• Claude Code Quickstart：導入、バージョン確認、起動の公式手順。
• Claude Code Authentication：認証経路の確認。

Python教材、Gitでの基準点と作業ブランチ、既存CLIの版表示を確認しました。新規導入・認証・AIによる生成と応答は未検証です。提示した依頼文と期待結果は、読者が自分の環境で照合するための教材です。

2026年11月13日は既存CLIの2.1.30表示とヘルプ、Python教材の基準1件→追加後3件、Git差分を再確認。新規インストール、ブラウザーでの再認証、Claude Codeによる生成は実施していません。