Contents
Claude Code 事前準備（Prerequisites）
導入前に整えるべき基本環境と前提をまとめます。ここで挙げる項目を満たすと、インストール・認証・最初の実行でのつまずきを減らせます。セキュリティや承認の要件は後段の専用節で詳細に扱います。
主要用語の定義
ここで使う主要用語を短く定義します。用語は本文内で繰り返し参照します。
- Plan Mode：大規模変更を分解して逐次実行・レビューできる運用モード。人による承認ポイントを設けられます。
- Skill：小さな自動化ユニット（入出力を持つ処理）。関数やスクリプトのように再利用可能です。
- Hooks：GitイベントやCIトリガー等の外部イベント連携を指します。
- MCP（Model Control Plane）：モデル選択・ポリシー・アクセス制御を一元管理する仕組みです。
- CLAUDE.md：プロジェクト単位のデフォルト設定やプロンプトの起点となる設定ファイル（仕様はツール版によって異なる可能性があります）。
対応プラットフォームと最小要件
対応OSや必須ツール、ランタイムの最小条件を整理します。事前に確認しておくとインストールがスムーズです。
- サポートOS：Windows / macOS / Linux（ディストリビューション差異あり）
- 必須ツール：Git、curl/wget、シェル（bash/zsh）、パッケージマネージャ（Homebrew、apt、winget等）
- ランタイム：プロジェクトによってNode.jsやPythonが必要になるためREADMEでバージョン確認
- Windowsの留意点：WSLを推奨するケースが多い
- macOSの留意点：Apple Silicon と Intel のバイナリ差異に注意
組織的な権限と承認
導入時に必要な組織的手続きの概要を示します。特に企業での利用では事前承認が重要です。
- 機密データを扱う場合はDPO/セキュリティ部門の承認を得ること
- APIキー発行・保管ポリシーの明文化（シークレット管理手法の指定）
- 監査ログや利用ポリシーの配置場所と責任者の決定
アカウント作成と料金プラン（Claude Code / Anthropic）
アカウント作成の一般的な流れと、料金・管理機能の確認ポイントを説明します。企業利用ではSSOや組織管理、SLAの有無が選定に影響します。
登録手順（一般的な流れ）
アカウント作成の基本手順と注意点を示します。手順はサービス側の仕様変更で変わるため、公式画面を必ず確認してください。
- 公式サイトで登録（メール/SAML/SSO等）し、メール確認またはSSOで認証を完了する
- ダッシュボードで組織設定、APIキーの発行、チームメンバー招待を行う
- APIキーは最低限の権限で発行し、用途ごとに分けて管理する
公式サイト（サインイン／料金ページ）例：
https://claude.ai/
料金プラン確認と管理機能
料金や無料枠の仕様は頻繁に更新されるため、必ず公式料金ページを参照してください。企業利用で確認すべき点を挙げます。
- 無料枠の制限（呼び出し回数・トークン数・商用利用可否）
- エンタープライズ機能（SSO、SAML、監査ログ、SLA、組織請求）
- 使用量のアラート設定と請求上限の設定方法
ブランド表記と一次情報の参照
"Claude Code" の表記に関しては曖昧さがあるため注意してください。ここでは「Claude を使ったCLI／ワークフロー拡張」を指す呼称として扱います。公式の製品名やリリース情報は必ず一次ソースで確認してください。参考（公式／一次情報）：
- Anthropic 公式（製品紹介・ブログ）: https://www.anthropic.com/news/introducing-claude
- 公式サイト（ダッシュボード／ドキュメントへ）: https://claude.ai/
- 公式ドキュメント：Anthropic のドキュメントページ（最新のCLIリファレンス等を参照してください）: https://www.anthropic.com/docs
リリース日や採用動向などの日時情報は、必ず公式リリースノートやブログで裏付けを取得してください。
インストールと初期設定（CLI／デスクトップ／認証／CLAUDE.md）
インストール手順と認証設定、CLAUDE.md の最小例、初期動作確認方法を示します。ここでは初心者がそのまま試せるOS別最小コマンドと期待出力の例示を含みます。記載のコマンド名・フラグは実装差異があり得るため、公式CLIリファレンスも併せて確認してください（公式ドキュメント参照: https://www.anthropic.com/docs）。
macOS（Homebrew）最小クイックスタート（例示）
macOS 上でHomebrew経由の最小インストール例です。これは例示であり、実際は公式手順を優先してください。
インストール例（Homebrew）:
|
1 2 3 |
brew update brew install claude-cli # 例示コマンドです。実際のパッケージ名は公式を確認してください。 |
期待される確認コマンドと例示出力:
|
1 2 3 4 5 6 7 8 |
# PATH にインストールされたか確認 which claude # 例: /usr/local/bin/claude # バージョン確認 claude --version # 例: claude 0.3.1 |
上記はあくまで例示です。パッケージ名や結果は公式ドキュメントと照合してください。
Ubuntu / Debian（apt/wget）最小クイックスタート（例示）
Linuxでの一般的な手順例を示します。ディストリビューション・パッケージにより手順は異なります。
インストール例（debパッケージを使う想定）:
|
1 2 3 4 |
# 例示: 公式のdebをダウンロードしてインストールする手順 wget https://example.com/claude-cli.deb sudo apt install ./claude-cli.deb |
確認コマンドと例示出力:
|
1 2 3 4 5 6 |
which claude # 例: /usr/bin/claude claude --version # 例: claude 0.3.1 |
公式配布方法が異なる場合があります。必ず公式ダウンロードページを優先してください。
Windows（PowerShell / WSL）最小クイックスタート（例示）
WindowsではWSLを利用するか、winget等でインストールする例を示します。
PowerShell（winget例）:
|
1 2 |
winget install --id Claude.CLI # 例示。実際のIDは公式を確認してください。 |
WSL 推奨例（Ubuntu環境）:
|
1 2 3 4 |
# WSL上でLinux手順に従う which claude claude --version |
PowerShellでの環境変数設定（例）:
|
1 2 |
$env:CLAUDE_API_KEY="YOUR_API_KEY" |
認証設定（環境変数とCI設定）
認証情報は環境変数やOSのシークレットストアで管理します。CIではリポジトリシークレットを使ってください。
ローカル（Unix系シェル）の例:
|
1 2 |
export CLAUDE_API_KEY="YOUR_API_KEY" |
PowerShell の例:
|
1 2 |
$env:CLAUDE_API_KEY = "YOUR_API_KEY" |
CI の例（GitHub Actions の環境変数受け渡し）:
|
1 2 3 |
env: CLAUDE_API_KEY: ${{ secrets.CLAUDE_API_KEY }} |
APIキーは機密情報のため、公開リポジトリやスクリーンショットで共有しないでください。詳細は後述のセキュリティ節を参照してください。
CLAUDE.md の最小構成（例示）
CLAUDE.md はプロジェクトのデフォルト設定やプロンプトを置く想定例です。フォーマットはツールバージョンで変わる可能性があるため、以下は例示です。
|
1 2 3 4 5 6 7 8 9 |
# CLAUDE.md（例） project: sample-app default_model: claude-3 plan_mode: true skills: - ./skills/echo notes: | プロジェクト固有の指示やポリシーをここに記載します。 |
機密情報は含めないでください。環境固有のキーは環境変数で管理します。
ハンズオン：ローカルで使える最小サンプル（再現可能）
ここでは外部配布リポジトリに頼らず、誰でもローカルで作成して動かせる最小サンプルを示します。CLIが未導入でも動作確認できる「ローカル実行」と、CLI連携の「例示コマンド」を両方提示します。
ローカルで作る最小サンプル（外部アクセス不要）
まずは外部APIを使わずにSkill構造を模した最小サンプルを作成して動かします。動作確認の目的はファイル構成や基本フローを理解することです。
手順（UNIX系の例）:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
mkdir -p sample-claude/skills/echo cat > sample-claude/skills/echo/handler.py << 'PY' #!/usr/bin/env python3 import sys def main(): text = sys.stdin.read().strip() or "hello" print({"reply": f"echo: {text}"}) if __name__ == "__main__": main() PY # 実行（入力を渡す例） echo "new feature: add login" | python3 sample-claude/skills/echo/handler.py |
期待出力（例）:
|
1 2 |
{"reply": "echo: new feature: add login"} |
このサンプルは外部APIに頼らずSkillの入出力設計を学ぶための最小例です。
CLI統合の最小フロー（例示）
CLIが導入済みの場合の最小実行フロー例を示します。以下はあくまで例示であり、実際のコマンドやフラグは公式CLIリファレンスを参照してください（https://www.anthropic.com/docs）。
例（イメージ）:
|
1 2 3 4 5 6 |
# プロジェクト初期化（例示） claude init # サンプルSkillをCLIで実行する（例示） claude run skill/echo --input "新機能: 認証追加" |
想定される簡易的な出力例（例示）:
|
1 2 |
{"status":"ok","skill":"echo","result":{"reply":"echo: 新機能: 認証追加"}} |
実際の出力はCLIのバージョンや設定により異なります。必ず公式ドキュメントのコマンドリファレンスを確認してください。
CI連携（GitHub Actions の最小例）
GitHub Actionsでの最小的な実行ワークフロー例を示します。シークレットはGitHub側で設定してください。
.github/workflows/claude.yml（例示）:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
name: Claude Skill run on: [push] jobs: run-skill: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - name: Install dependencies run: | # 例示: CLIのインストール手順は公式を参照 echo "install steps..." - name: Run skill env: CLAUDE_API_KEY: ${{ secrets.CLAUDE_API_KEY }} run: | claude run skill/echo --input "CI実行: テスト" |
CI上でのシークレット使い方はプラットフォームの仕様に従ってください。
運用・セキュリティ・法務（データ利用／ログ／ライセンス）
運用段階で必須となるセキュリティ運用、データ送信ポリシー、ログ保持、及び自動生成コードのライセンス管理をまとめます。セキュリティ関連の注意はここに集約しています。
データ送信とログ保持の確認
プロバイダがどの範囲でデータを保持・利用するかは契約やドキュメントで明示されています。以下を必ず確認してください。
- プロバイダのデータ利用方針（入力データの保存／学習利用の有無、保持期間）
- 企業契約ではログ保持期間や削除要件をSLAや契約書で明記する
- 機密コードや個人情報は必要最小限にし、可能であればローカル処理やオンプレの代替を検討する
公式のポリシー確認先（例）:
https://www.anthropic.com/docs
組織承認と機密データの扱い
機密データを扱う場合の運用手順です。組織レベルでのルール化が重要です。
- 機密データ分類フローを定め、送信可否の判定基準をドキュメント化する
- 機密データ送信にはDPO／セキュリティ承認を必須化する
- シークレットは暗号化ストアやCIのシークレット管理を使い、平文保存を禁止する
自動生成コードの著作権・ライセンス管理
自動生成されたコードの取り扱いは法務リスクを伴います。以下の運用を推奨します。
- 生成コードも必ずコードレビューし、著作権・ライセンス上の問題がないか確認する
- 外部ライブラリや依存のライセンスを自動スキャンする（例: Node / Python のツール）
-
Node.js（例）:
npx license-checker --summary -
Python（例）:
pip install pip-licenses
pip-licenses -
依存性の脆弱性スキャン:
- npm:
npm audit - Python:
pip-audit
- npm:
- SBOM（ソフトウェア部品表）の作成やSCAツール導入を検討する
- ライセンス方針（例: 商用利用可否、再配布条件）を事前に決めておく
法務的な判断は社内の法務担当と連携してください。生成物の扱いに関してはケースバイケースで判断が必要です。
サードパーティ配布ページの注意
公式以外のダウンロードサイト（例: TechSpot 等）には非公式ビルドや改竄のリスクがあります。ダウンロードは公式配布を最優先とし、やむを得ずサードパーティを利用する際は次を確認してください。
- 配布元の信頼性、署名、チェックサムの有無
- インストール前にウイルススキャンやハッシュ確認を行う
- 企業ポリシーで外部バイナリ導入の承認プロセスを設ける
例: TechSpot のページは参考情報だが、公式サイトを優先して確認することを推奨します（https://www.techspot.com/downloads/7833-claude-desktop-app.html）。
トラブルシュートとFAQ（代表的なエラーと診断）
よくある問題と具体的な診断手順を示します。エラー出力例やログ確認、verboseモードの利用法など、初心者が実行しやすいコマンドを中心にまとめます。以下は例示です。実際のメッセージやパスは環境・バージョンにより異なります。
代表的なエラーと具体対応（例示）
認証エラー（例）
|
1 2 |
Error: 401 Unauthorized: Invalid API key |
対処例（Unix系）:
|
1 2 3 4 5 |
# 環境変数が正しく設定されているか確認 echo $CLAUDE_API_KEY # PowerShell の場合 echo $env:CLAUDE_API_KEY |
APIキーが空／無効ならダッシュボードで再発行し、正しい環境変数に設定してください。
コマンド未検出（例）
|
1 2 |
bash: claude: command not found |
対処例:
|
1 2 3 4 |
which claude echo $PATH # インストール先がPATHに含まれていない場合はPATHを追加する |
権限エラー（例）
|
1 2 |
Error: EACCES: permission denied, access '/usr/local/bin/claude' |
対処例:
|
1 2 3 4 |
# 所有者／許可を確認し、必要なら再インストールまたはchmod/chownで修正 sudo chown $(whoami) /usr/local/bin/claude chmod +x /usr/local/bin/claude |
使用量／クォータ超過（例）
|
1 2 |
Error: Quota exceeded |
対処例:
- ダッシュボードで利用状況を確認
- リクエスト頻度を下げる（バッチ化・キャッシュ化）
- プラン変更を検討
出力品質・期待と違う場合:
- CLAUDE.md やプロンプトを明確化する
- 少ないトークンで短いテストを繰り返す
- Plan Mode のステップを小さく分割して検証する
ログとverboseでの調査（例示）
CLIに用意されている verbose / debug オプションやログファイルを活用します。以下は一般的な調査の流れです。
- CLIでの詳細表示（例）
|
1 2 3 |
claude --verbose run ... claude --debug run ... |
- ログファイルの例示パス（環境により異なります）:
|
1 2 3 4 |
~/.claude/logs/claude.log # Windows (PowerShell) の例示 $env:USERPROFILE\.claude\logs\claude.log |
- ログを検索する例:
|
1 2 |
tail -n 200 ~/.claude/logs/claude.log | grep -i error |
ログの保存場所・形式はツールのバージョンや設定で異なるため、公式ドキュメントでログパスを確認してください。
よくある質問（短答）
Q: APIキーはどこに保存すれば良いですか？
A: ローカルは環境変数かOSのシークレットストア、CIはプラットフォームのシークレット機能を使ってください。公開リポジトリに書かないことが最重要です。
Q: CLIのコマンドが公式ドキュメントと違う場合は？
A: バージョン差や配布形態でコマンド名・フラグが変わることがあります。必ず所持バージョンの公式リファレンスを確認してください（https://www.anthropic.com/docs）。
Q: 生成コードをそのまま使って良いですか？
A: 生成コードも必ずコードレビューとテストを実施し、依存ライセンスやセキュリティのスキャンを行ってから採用してください。
まとめ
- Claude Code（Claudeを活用したCLI/ワークフロー拡張）は導入前にOS・ランタイム・権限を整えると早く動かせます。
- 公式ドキュメントとリリースノートで配布方法やCLIの仕様を必ず確認してください。
- APIキーはシークレット管理を徹底し、機密データ送信は組織承認のもとで行ってください。
- 自動生成コードはコードレビュー・テスト・依存ライセンスチェックを必須にしてください。
- トラブル時は --verbose / --debug とログ確認、環境変数・PATHのチェックを基本手順として実施してください。
参考リンク（公式や一次情報）
- Claude（サインイン／公式）: https://claude.ai/
- Anthropic（製品紹介／ブログ）: https://www.anthropic.com/news/introducing-claude
- Anthropic ドキュメント（CLI、ポリシー等の確認先）: https://www.anthropic.com/docs
（注）本文中のコマンドやファイル名、出力例は例示です。実際のコマンド・オプション・出力はツールのバージョンや配布形態により異なるため、導入時は公式CLIリファレンスと配布ページを必ず参照してください。