Contents
1. ダウンロードとインストール
| OS | 推奨ダウンロード形式 | インストーラ例 |
|---|---|---|
| Windows | ClaudeCode-Setup-<version>.exe（署名付き） |
ClaudeCode-Setup-1.4.3.exe など |
| macOS | ClaudeCode-<version>.dmg（Gatekeeper 対応） |
ClaudeCode-1.4.3.dmg |
⚠️ 注意
-<version>はリリースごとに変わります。公式ダウンロードページで「最新バージョン」を必ず確認してください。
- ファイル名は将来的に変更される可能性があります。
1‑1. Windows のインストール手順
- ブラウザで https://code.claude.com/ にアクセスし、Download for Windows をクリック。
- ダウンロードした
ClaudeCode-Setup-<version>.exeを右クリック → 管理者として実行。 - インストーラが表示する指示に従いインストール先を選択（デフォルトは
C:\Program Files\Claude Code）。 - 完了後、スタートメニューに「Claude Code」ショートカットが作成されます。
ポイント：インストーラは Anthropic が Microsoft のコードサイニングで署名しているため、実行前にプロパティのデジタル署名を確認できます。
1‑2. macOS のインストール手順
- 同サイトで Download for macOS をクリックし、
ClaudeCode-<version>.dmgを取得。 .dmgをダブルクリックしてマウントし、表示されたウィンドウから「Claude Code」アイコンを/Applicationsフォルダーへドラッグ＆ドロップ。- 初回起動時に Gatekeeper が警告したら、システム環境設定 → セキュリティとプライバシー → 「このまま開く」 を選択。
ポイント：公式パッケージは Apple の notarization に合格しているため、通常の Gatekeeper 警告は表示されませんが、万一警告が出た場合は署名情報を確認してください。
2. アカウント認証とトークン管理
2‑1. Anthropic アカウントでのサインイン
| 手順 | 内容 |
|---|---|
| 1 | Claude Code 起動 → Sign in with Anthropic ボタンをクリック。 |
| 2 | 既定ブラウザが開き、Anthropic のログインページへ遷移。未登録の場合は「Create account」からメール認証で新規作成。 |
| 3 | ログイン後に 二要素認証（2FA） を有効化すると、次回以降のサインイン時にワンタイムコードが要求されます。 |
公式情報：Anthropic の OAuth フローは公式ドキュメント（https://code.claude.com/docs/ja/authentication）で公開されています。実装内容は随時更新されるため、最新手順を必ず確認してください。
2‑2. API キーの取得と安全な保存
- Anthropic ポータル（https://claude.ai/）にログインし、右上メニュー → API Keys → Create new key。
- 表示されたキーは一度だけコピーできるので、忘れずに保存します。
- Claude Code の左下設定アイコン → Token Settings → Add API Key に貼り付けて保存。
保存方式について（※公式情報の確認が必要）
- アプリはローカルストレージにキーを 暗号化して格納 すると公表しています。
- 暗号化アルゴリズムとして AES‑256、鍵管理には OS が提供する keytar（macOS の Keychain / Windows Credential Manager）を利用していると記載されていますが、正確な実装は公式リポジトリやドキュメントで再確認してください。
ベストプラクティス
- 不要になったキーは必ず Anthropic ポータル から削除する。
- ローカルに保存したキーはアプリの設定画面から随時削除・再入力できるようにしておく。
3. ユーザーインターフェイス概観
3‑1. Chat タブ（対話型 Q&A）
- テキストベースのチャットウィンドウで、自然言語による質問・コードレビューが可能。
/exportコマンドで会話内容を Markdown ファイルとしてローカル保存できる。
3‑2. Code タブ（統合エディタ）
| 機能 | 説明 |
|---|---|
| エディタ | VS Code ライクな構文ハイライト、行番号、折りたたみ機能を搭載。 |
実行ボタン (▶︎) |
Python・Node.js などインストール済みランタイムでコードを即時実行し、下部の Result ペインに標準出力とエラーメッセージを表示。 |
| ファイル操作 | ドラッグ＆ドロップまたは Import ボタンで .py,.js,.ts など任意のファイルを読み込み、Save to file でローカルに保存可能。 |
| フォルダ監視 | Settings → Folder Watch にディレクトリを登録すると、内部で chokidar（Node.js）相当の監視が有効化され、ファイル更新時に自動リロードされます。 |
注意：フォルダ監視は OS の権限に依存します。管理者権限が必要な場所を指定した場合は、アプリを「管理者として実行」してください。
3‑3. Cowork タブ（自律タスクオーケストレーション）
- ユーザーの指示（例：「Node.js プロジェクトのユニットテストを作成して実行」) を受け取り、以下のフローを自動で遂行します。
- 必要なパッケージインストール (
npm install jest) - テストコード生成
- ローカル環境でテスト実行 (
npm test) -
成功/失敗のレポートとログを Result ペインに表示、Export Result で zip ダウンロード可能
-
ワークフローは内部でタスクキューと状態管理（JSON ストア）を使用し、途中で不足する情報があればユーザーへプロンプトします。
4. 実務で活用できる具体的機能
4‑1. コード入力・即時実行（Code タブ）
|
1 2 3 4 5 6 |
手順例 1️⃣ エディタ上部に .py ファイルをドラッグ → 内容が自動ロード 2️⃣ 必要なら import 文や関数定義を追加 3️⃣ キーボードショートカット **Ctrl+Enter** または ▶︎ ボタンで実行 4️⃣ Result ペインに標準出力・例外スタックトレースがリアルタイム表示 |
- デバッグ支援：エラーメッセージの行番号がハイライトされ、クリックで該当コードへジャンプできます。
4‑2. フォルダ監視とインポート／エクスポート
| 操作 | 手順 |
|---|---|
| フォルダ監視設定 | Settings → Folder Watch → 「Add」→ 監視したいディレクトリを選択。 |
| 自動リロード | 監視対象のファイルをエディタで開いた状態で保存すると、Code タブが即座に最新内容へ更新。 |
| 全体エクスポート | Code タブ右上の Export All → 保存先フォルダ選択 → プロジェクト全体を zip にまとめて出力。 |
4‑3. カスタムショートカットと常駐モード
- 左下歯車アイコン → Keyboard Shortcuts → Add Shortcut
Ctrl+Shift+Space（例） を入力し、アクション Toggle Claude Code Window を選択。- 設定保存後、ショートカットでウィンドウがトグル表示されると同時に、タスクトレイのアイコンが常駐します。
メリット：作業中に他アプリへ切り替える手間がなく、瞬時に AI アシスタントを呼び出せます。
4‑4. Cowork によるコード生成・テスト自動化例
|
1 2 3 4 5 6 |
ユーザー入力: 「CSV を読み込んで月別売上を集計し、pytest のテストも作成して実行してください」 1️⃣ Cowork が pandas のインポートと `aggregate_sales(csv_path)` 関数を生成。 2️⃣ 同時に `tests/test_aggregate.py` に pytest 用テストケース（正常系・異常系）を作成。 3️⃣ 仮想環境で `pytest -q` を実行し、結果 (4 passed) を取得。 4️⃣ 「All tests passed」レポートとコード一式を zip 形式で **Export Result** → ダウンロード可能。 |
- この流れは「指示 → 実装 → テスト → レポート」の エンドツーエンド 自動化として、反復作業の削減に大きく貢献します。
5. 業務シナリオ別活用例 & トラブルシューティング
5‑1. CI/CD スクリプト自動生成
| シナリオ | 入力例 | 出力例 |
|---|---|---|
| GitHub Actions ワークフロー作成 | 「Node.js プロジェクトの CI 用 YAML を書いて」 | .github/workflows/ci.yml に checkout, setup-node, npm ci, npm test, npm run build が自動生成。 |
| ローカルでの検証 | Cowork が act コマンドを使ってローカルシミュレーション実行 → 成功/失敗レポートを提示。 |
ポイント：生成された YAML はそのままリポジトリにプッシュでき、手動で書くよりヒューマンエラーが減少します。
5‑2. ドキュメント自動生成（Chat タブ活用）
- 「この Python モジュールの API リファレンスを Markdown で作成」 と入力すると、関数・クラスごとの説明・型情報・サンプルコードが自動出力されます。
- 出力は Copy ボタンでクリップボードにコピー、または /export コマンドで
api.mdとして保存可能。
5‑3. データ解析パイプライン構築
- Import →
sales_2024.csvをロード。 - Chat タブで「pandas と seaborn で月別売上棒グラフを作成」指示。
- Code タブに自動生成されたスクリプトが表示され、▶︎ 実行で結果画像が右側プレビューに即座に表示。
- Export → PNG ファイルとして保存し、レポート資料へ貼り付け可能。
参考：本機能はローカルファイルへの直接アクセスを前提としているため、ブラウザ版では実現できません（公式ガイド未確認のため要注意）。
5‑4. よくあるエラーと対処法
| エラー | 想定原因 | 推奨対処 |
|---|---|---|
| ログイン失敗 | API キー未設定、期限切れ、2FA 無効化 | Settings → Token Settings で最新キーを貼り付け、アプリ再起動 |
| フォルダ監視が機能しない | 監視ディレクトリが管理者権限必要な場所 | アプリを「管理者として実行」または監視対象をユーザーフォルダーに変更 |
| ファイルパスエラー（Windows） | バックスラッシュのエスケープ漏れ | r"C:\\path\\file.py" のように raw 文字列か、/ に置換 |
| 実行タイムアウト | 無限ループまたは重い処理 | Result ペイン左上の Terminate ボタンで停止し、コードを分割してテスト |
エラーメッセージは画面左上に表示されます。表記された内容と上記対策を照らし合わせてすぐに修正してください。
5‑5. デスクトップ版 vs ブラウザ版比較
| 項目 | Claude Code（デスクトップ） | Claude Code（ブラウザ） |
|---|---|---|
| オフライン利用 | 可（ローカル実行環境） | 不可 |
| ファイル I/O 速度 | 高速（直接ディスクアクセス） | アップロード/ダウンロードが必要 |
| 常駐モード | トレイアイコンでバックグラウンド起動可能 | タブを開いている間のみ利用 |
| ショートカット | ユーザー定義可能（全 OS で統一） | ブラウザ拡張や OS のキーボード設定に依存 |
| OS キーストア連携 | keytar で Keychain / Credential Manager と連携 |
なし（ローカル保存は不可） |
結論：頻繁にファイル操作・オフライン作業が必要なプロジェクトでは、デスクトップ版を選択する方が生産性とセキュリティの両面で有利です。
5‑6. ローカルデータ・API キーの安全管理
- 暗号化ストレージ
-
設定 → Security → Encrypt local data をオンにすると、保存されたコードや設定ファイルが AES‑256 で暗号化されます（公式ドキュメントで確認要）。
-
OS キーストア利用
-
keytarライブラリを通じて OS の鍵束へアクセスし、API キーは平文でディスクに残りません。実装の詳細は GitHub リポジトリ（公開されている場合）や公式 API 仕様書で必ず確認してください。 -
ベストプラクティス
- 端末を共有する環境では、使用後に Settings → Security → Clear stored data でローカルキーを削除。
- 組織の情報セキュリティポリシーに合わせて、鍵管理プロセス（例：定期的なキー再生成）を導入。
6. 注意点・確認すべき項目
| 項目 | 確認方法 |
|---|---|
| 最新インストーラ名・バージョン | 公式ダウンロードページの「Latest Release」欄 |
| 暗号化方式と keytar の使用有無 | https://code.claude.com/docs/ja/security（または公式リポジトリの README）を参照 |
| 外部リンク先情報の正確性 | Qiita 記事・他サイトは執筆時点での内容が変わる可能性があるため、必ず公式ドキュメントと突き合わせて利用 |
| 2FA の有効化手順 | Anthropic アカウント設定画面 → 「Security」タブ |
これらを定期的に見直すことで、情報の古さや誤認によるリスクを最小限に抑えられます。
7. まとめ（要点だけ）
- インストールは公式サイトから最新バージョンの署名付きインストーラを取得し、指示通り実行するだけで完了。
- 認証は Anthropic アカウント＋2FA が必須。API キーは暗号化されたローカルストレージ（keytar）に安全保管できるが、公式情報の確認を忘れずに。
- UIは Chat／Code／Cowork の三本柱で構成され、コード実行・自律タスク・対話がシームレスに統合。
- 業務活用例として CI/CD スクリプト生成、ドキュメント自動作成、データ解析パイプラインの構築が容易になる。
- トラブルシューティングはエラー表を参照しつつ、権限・パス・タイムアウトに注意。
- セキュリティは AES‑256 暗号化と OS キーストア連携でキー漏洩リスクを低減できる（公式確認必須）。
本ガイドは「2026年4月時点」の情報をベースにしています。製品やドキュメントが更新された際は、必ず 公式サイト と 最新の開発者向けマニュアル をチェックしてください。