3. 認証と料金

初回認証

任意のフォルダでコマンドプロンプトを開き，claude を実行する。

claude

ブラウザが自動起動し，claude.aiでのログインが求められる。認証完了後，対話セッション（以降「セッション」）が開始する。2回目以降の起動では認証は不要である。

料金体系

上限超過後，Extra usage（定額プランの上限を超えた後に有効化できる従量課金オプション）を有効にすると標準APIレートで課金される。デフォルトは無効であり，有効化しない限り追加料金は発生しない。

Extra usageの状態確認

https://claude.ai にログイン
→ 左下のアカウントアイコン → Settings → Usage
→ Extra usage の項目を確認
  「Enable」ボタンが表示されている = 無効（追加課金なし）

4. 単一ファイルでの作業

Claude Codeはプロジェクト構造を強制しない。対象ファイルのあるフォルダに移動して claude を起動し，自然言語で指示するだけでよい。

cd C:\work
claude

起動後，自然言語で指示する。

rtdetr.py の forward メソッドにバグがある。修正して

ファイルを明示的に指定したい場合は @ファイル名 構文を使う。

@rtdetr.py を読んで，推論速度を改善する案を出して

5. 日常的な開発サイクル

コマンド体系

各コマンドの動作：

• /simplify：コードの品質・冗長性・効率を自動レビュー・修正するコマンド
• /compact：会話履歴を要約圧縮し，処理できる情報量を節約するコマンド
• /clear：会話履歴を完全削除し，セッションをリセットするコマンド

/review・/cost・/permissions 等は，チーム開発・コスト管理・セキュリティ設定が必要になった段階で参照すればよい。

典型的な1サイクル

① 自然言語で指示する
  例：「rtdetr.py の forward メソッドにバグがある。修正して」

② Claudeがコードを生成・実行し，エラーを自律的に修正する
  （人間の介入は不要）

③ 動作確認後に /simplify を実行する
  コードの品質・冗長性・効率を自動レビュー・修正する

④ 次の修正へ進み，①に戻る
  会話が重くなったら /compact を挟む

6. コーディングスタイルの設定（CLAUDE.md）

CLAUDE.mdとは

CLAUDE.md（セッション開始時に自動読み込みされる設定ファイル）を次の場所に置くと，すべてのセッションに設定が適用される。プロジェクトフォルダに置く必要はない。

配置場所

C:\Users\ユーザー名\.claude\CLAUDE.md

ファイルの作成手順

.claude フォルダが存在しない場合は作成する。

mkdir %USERPROFILE%\.claude

メモ帳でファイルを新規作成する。

notepad %USERPROFILE%\.claude\CLAUDE.md

メモ帳が開いたら，後述の内容を貼り付けて保存する。

/simplify との役割分担

CLAUDE.md の内容

# Code Generation Policy

## 実装方針
- 同じ機能なら行数が少ない実装を選ぶ
- 中間変数は省略できる場合は省略する
- ループよりリスト内包表記を優先する（可読性を損なわない範囲で）
- 標準ライブラリで実現できる処理にサードパーティライブラリを使わない
- 抽象化・クラス化は指示があるときのみ行う
- フォールバック・エラーハンドリングは指示があるときのみ書く
- デバッグ用コードは残さない

## コメント方針
- 自明なコードにコメントは書かない
- コメントを書く場合は公式ドキュメント・仕様を調査し，
  コードを読むだけでは得られない技術的な根拠・挙動の理由を書く
- 例：なぜその引数・順序・アルゴリズムを選んだか，
  公式仕様上の制約や保証，既知の落とし穴
- 推測や慣習ではなく，確認済みの情報のみ書く

7. Visual Studio Code・Windsurfからの利用

コマンドプロンプトを別途開く必要はない。両エディタとも，Anthropic公式の拡張機能を導入することで，エディタのサイドパネルからGUIで操作できる。内部ではセクション2でインストールしたCLI本体が使用される。

前提

セクション2のインストールを完了していること。

Visual Studio Codeでの導入

Visual Studio Code（1.98.0以降）を開き，拡張機能パネルから「Claude Code」（発行者：Anthropic）をインストールする。

Ctrl+Shift+X → 検索欄に「Claude Code」と入力 → Anthropic製のものをインストール

インストール後，左サイドバーまたはエディタ右上にSparkアイコン（稲妻マーク）が表示される。クリックするとClaude Codeのパネルが開き，自然言語で指示を入力できる。

主な機能：

• 開いているファイルを自動的に参照する
• コードの変更はインラインdiff（変更前後の差分を左右に並べて表示する形式）で提示され，承認・却下をクリックで選択できる
• @ファイル名 でファイルを明示的に指定することもできる
• セクション5のスラッシュコマンドはパネル内で入力できる

Windsurfでの導入

WindsurfはVisual Studio Codeをベースに開発されたエディタであり，Visual Studio Code用の拡張機能がそのまま動作する。導入手順はVisual Studio Codeと同一である。

Ctrl+Shift+X → 検索欄に「Claude Code」と入力 → Anthropic製のものをインストール

なお，WindsurfにはCascade（Windsurf独自の自律型AIエージェント機能）が搭載されているが，Claude Code拡張機能とは独立した別機能である。Claude Codeを使用する場合は，拡張機能パネルからClaude Codeを明示的に起動する。

コマンドプロンプト経由での利用との比較

動作は両者で同一であり，異なるのは操作インターフェイスのみである。

既存コードをCLAUDE.mdに従って修正する

CLAUDE.mdは自動読み込みされるため，以下のように指示するだけでよい。

コマンドプロンプトの場合

対象ファイルのあるフォルダで claude を起動し，以下のように指示する。

@rtdetr.py をCLAUDE.mdに従ってリファクタリングして

Visual Studio Code / Windsurfの場合

対象ファイルをエディタで開き，Claude Codeのパネルに指示を入力する。

このファイルをCLAUDE.mdに従ってリファクタリングして

ファイルを開いておくだけで自動的に参照されるため，@ファイル名 の指定は省略できる。変更内容はインラインdiffで提示されるので，承認・却下を箇所ごとに判断できる。

8. OllamaによるローカルLLMへの切り替え（Claude Pro不要）

位置づけ

Ollama v0.14.0でAnthropicのMessages API互換性が追加された。Claude CodeはOllamaを接続先として使用できるため，Claude Proへの加入なしにローカルLLMを使用できる。この連携はOllamaとClaude Code双方の公式ドキュメントに掲載されている。

制約

ローカルLLMはAnthropicの高性能モデルと比べると応答品質が低下する。Claude Codeは大きなコンテキスト長（一度に処理できるトークン数）を必要とするため，64k以上のモデルを推奨する。

ステップ1：Ollamaのインストール（管理者権限が必要）

Ollamaの公式サイト（https://ollama.com）にアクセスし，「Download」→「Windows」を選択して OllamaSetup.exe をダウンロードする。ダウンロードしたファイルを実行し，画面の指示に従ってインストールする。

インストール後，コマンドプロンプトで動作確認する。

ollama --version

ステップ2：コーディング用モデルの取得

推奨モデルを取得する。

REM Ollama をインストール（ユーザースコープ / Inno Setup）
winget install --id Ollama.Ollama -e --silent --disable-interactivity --force --accept-source-agreements --accept-package-agreements --override "/VERYSILENT /SUPPRESSMSGBOXES /NORESTART /SP-"
REM Ollama のパス設定（システム PATH に未登録の場合のみ追加）
powershell -NoProfile -Command "$p=\"$env:LOCALAPPDATA\Programs\Ollama\"; $c=[Environment]::GetEnvironmentVariable('Path','Machine'); if((Test-Path $p) -and $c -notlike \"*$p*\"){[Environment]::SetEnvironmentVariable('Path',\"$p;$c\",'Machine')}"
rem モデルパスの設定
powershell -Command "[System.Environment]::SetEnvironmentVariable('OLLAMA_MODELS', 'C:\ollama\models', 'Machine')"
set OLLAMA_MODELS=C:\ollama\models
if exist "%USERPROFILE%\.ollama\models" robocopy "%USERPROFILE%\.ollama\models" "C:\ollama\models" /E /MOVE
if exist "%USERPROFILE%\.ollama\models" rd /s /q "%USERPROFILE%\.ollama\models"
ollama pull qwen3-coder

他の選択肢：glm-4.7，gpt-oss:20b，gpt-oss:120b（モデルが大きいほど品質は高いが，必要なVRAM・RAM量も増加する）。

ステップ3：設定

コマンドプロンプトから使用する場合

コマンドプロンプトで以下を実行する。

set ANTHROPIC_AUTH_TOKEN=ollama
set ANTHROPIC_API_KEY=
set ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3-coder

set コマンドによる設定はそのコマンドプロンプトのウィンドウを閉じると消える。起動のたびに入力したくない場合は，Windowsの「システム環境変数の編集」から同じ変数を永続的に登録する。

Visual Studio Code / Windsurf拡張機能から使用する場合

Ctrl+Shift+P →「Preferences: Open User Settings (JSON)」を選択し，以下を追記して保存する。

"claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_BASE_URL", "value": "http://127.0.0.1:11434" },
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "ollama" },
  { "name": "ANTHROPIC_API_KEY", "value": "" }
],
"claudeCode.disableLoginPrompt": true

保存後，Visual Studio Codeを再起動する。以降，Anthropicアカウントは不要になる。

Anthropic接続に戻す場合

コマンドプロンプト使用時は，そのウィンドウを閉じるだけでよい。新しいウィンドウではデフォルトのAnthropicへの接続が使われる。

Visual Studio Code / Windsurf使用時は，settings.json に追記した4行を削除してVisual Studio Codeを再起動する。