Claude Code 完全セットアップガイド：日本人開発者のための実践的導入手順

TL;DR：Claude Code は Anthropic 純正のターミナルベース AI コーディングツール。brew install --cask claude-code か npm i -g @anthropic-ai/claude-code で 1 行インストールでき、ANTHROPIC_BASE_URL を切り替えるだけで Anthropic 公式と ofox.ai 経由を行き来できる。本記事では macOS / Linux / Windows それぞれの最短セットアップ、日本円で支払いたいときの ofox.ai 連携、そして法人利用で踏むべきチェックポイントまでをまとめる。バージョンは claude --version で確認できる現行リリースを基準にしている（記載のフラグや挙動は古いバージョンでは異なる場合があるので、適宜 npm i -g @anthropic-ai/claude-code@latest または brew upgrade --cask claude-code で最新化してほしい）。

Claude Code とは何か

Claude Code はターミナルに常駐する AI コーディングエージェントだ。VSCode の Copilot のような補完ではなく、自然言語で「このバグを直して」「テストを追加して」と頼むと、コードを読んで編集してコミットメッセージまで書いてくれる。Cursor のようにエディタごと置き換える設計ではないので、既存の neovim / VSCode / IntelliJ ワークフローを壊さずに共存できるのが大きい。

似たツールとの関係を整理しておくと、Cursor がエディタ統合型、GitHub Copilot Chat が IDE 内サイドパネル、OpenAI Codex CLI がコマンド単発実行寄りなのに対し、Claude Code は 対話型エージェント + ターミナル常駐 というポジションになる。長時間にわたるリファクタや、ファイル横断のデバッグで真価を発揮する。

なぜ日本人開発者にとって導入価値が高いか

日本国内で Claude Code を使うと、特有のメリットがいくつかある。

• 日本語コードレビューの質が高い：コメント、ドキュメント、コミットメッセージのトーンが自然で、英語からの直訳臭が少ない。humanizer を別途かける必要があまりない。
• VSCode の Remote-WSL / Remote-SSH との相性：Windows 開発機で WSL2 を使う構成が多い日本企業向けに、CLI として WSL2 上で素直に動く。クリップボード周りなど環境依存の挙動はリリースごとに改善されているので、最新版を入れておくと無難。
• JIS キーボード対応が進んだ：IME 切替時のフォーカス問題が以前あったが、現行バージョンでは解消済み。
• ofox.ai 経由なら日本円でプリペイド購入できる：法人カードでドル建て課金が通らない、為替リスクを期末で確定させたい、といった経理側の要件に応えられる。

逆に注意したいのは、Anthropic 公式プランは現状クレジットカード払いのみで、領収書は英語の PDF になる点。日本の経理処理では「適格請求書（インボイス）」が必要なケースが増えており、その場合は中継サービス側で日本語インボイスが発行される ofox.ai のようなルートが選ばれる。

システム要件と前提条件

公式が動作保証しているのは以下の通り。

事前に git と任意のエディタ（VSCode / Cursor / neovim）が動く状態にしておけば、それ以外は Claude Code 側でインストール時に整える。

インストール手順

macOS

Homebrew が入っていれば一発。

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

Claude Code は Homebrew Cask として配布されているので、--cask フラグを忘れると Formula 側に同名パッケージがなくインストールが失敗する。Homebrew は 自動更新されないので、月 1 回程度 brew upgrade --cask claude-code を回す運用にする。Apple Silicon でも Intel Mac でも同じ手順。

Linux（Ubuntu / Debian）

ネイティブインストーラがいちばん速い。

curl -fsSL https://claude.ai/install.sh | bash

apt や snap で Node.js を別途用意する必要はなく、自己完結したバイナリが入る。社内プロキシ環境なら https_proxy を設定してから実行する。署名付きの apt / dnf / apk リポジトリも公式で提供されているので、社内ポリシーで curl | bash を避けたい場合はそちらを使う。

Linux（Alpine / musl 系ディストリビューション）

Alpine Linux 3.19 以降は公式サポート対象。ただし musl libc 環境のため、ネイティブインストーラを使う場合は依存ライブラリと ripgrep を別途入れた上で組み込みの ripgrep を無効化する必要がある。

apk add libgcc libstdc++ ripgrep
curl -fsSL https://claude.ai/install.sh | bash

そして ~/.claude/settings.json に以下を追加する。

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

apk add claude-code で Alpine 公式リポジトリ経由のインストールも可能。Docker の Alpine ベースイメージで CI 用途に使う構成と相性が良い。

Windows（ネイティブ）

WinGet があれば 1 行。

winget install Anthropic.ClaudeCode

Git をリポジトリ操作に使う前提なので、Git for Windows を入れておくのが無難。社内 PC で Git の追加インストール権限がない場合は、まずは WSL2 の方が選択肢として軽い。

Windows（WSL2 推奨構成）

WSL2 上の Ubuntu に入れる場合は、Linux と同じインストーラを使う。クリップボード経由の画像貼り付けはターミナル / WSLg の組み合わせで挙動が変わるので、うまく動かないときは最新版に上げてから iTerm2 相当の Windows Terminal Preview / WezTerm で再確認するのが早い。

# WSL2 内で
curl -fsSL https://claude.ai/install.sh | bash

npm（汎用）

社内ポリシーで curl | sh を禁止されている環境向け。

npm i -g @anthropic-ai/claude-code

認証：Anthropic 公式 vs ofox.ai 経由

ここが日本人開発者にとっていちばん分岐するポイント。

Anthropic 公式

任意のプロジェクトで claude を起動するだけで、初回はブラウザが自動的に開いて OAuth ログイン画面に遷移する。

claude

ブラウザでサインインすると、トークンが macOS なら Keychain、Linux / Windows なら ~/.claude/.credentials.json（mode 0600）に保存される。ブラウザに自動で戻らずログインコードが表示された場合は、ターミナルの Paste code here if prompted プロンプトに貼り付ける（WSL2 / SSH / コンテナでよく起きる）。Claude Pro / Max / Team / Enterprise のいずれかの有料プランが必要で、無料の Claude.ai プランは Claude Code を含まない。

別アカウントへ切り替えたいときは、Claude Code 起動中にスラッシュコマンド /logout を打って再ログインする。CI / GitHub Actions などブラウザログインが使えない環境向けには、claude setup-token で 1 年有効の OAuth トークンを発行して CLAUDE_CODE_OAUTH_TOKEN に渡す方法も用意されている。

ofox.ai 経由（日本円課金 / インボイスが必要なケース）

環境変数を 2 つ書き換えるだけで、API バックエンドが ofox 側に切り替わる。

export ANTHROPIC_BASE_URL="https://api.ofox.ai/anthropic"
export ANTHROPIC_API_KEY="sk-xxx"   # https://app.ofox.ai のコンソールで発行

~/.zshrc か ~/.bashrc に追記すれば永続化する。Windows PowerShell なら $env:ANTHROPIC_BASE_URL = ... で同様に設定できる。

ofox は Anthropic ネイティブプロトコル（/v1/messages 系のエンドポイント）をそのまま中継するので、Claude Code 側の挙動は公式と変わらない。claude を起動して 1 回プロンプトを投げ、応答が返ってくれば OK。

公式の OAuth トークンが残っていてもバックエンド切替には影響しない（ANTHROPIC_AUTH_TOKEN / ANTHROPIC_API_KEY の方が優先される）が、混乱を避けたければ Claude Code 起動中に /logout で公式トークンをクリアしてから ofox 用の API キーを設定するとわかりやすい。

初回起動と最低限覚えるコマンド

任意のリポジトリのルートで claude を実行する。インタラクティブモードに入って、自然言語で指示できるようになる。

cd ~/dev/my-app
claude

最初の数日で覚えておくと効くスラッシュコマンド：

• /init — リポジトリを読んで CLAUDE.md を生成。プロジェクトのコーディング規約や用語集をここに書いておくと、以降のセッションで毎回読み込まれる
• /clear — 会話履歴をクリア（コンテキストが膨らみすぎたとき）
• /compact — 会話を圧縮して長セッションを継続
• /review — 現在の差分をレビュー
• /permissions — どのツール（Bash / Edit / Write）を許可するかの設定

シェルから直接ワンショットで叩きたいときは：

claude -p "src/api/auth.ts のバグを修正して、対応するテストを追加"

-p （print mode）は CI / cron / GitHub Actions に組み込みやすい。

VSCode / Cursor との連携

code コマンドが PATH に通っていれば、Claude Code は自動で VSCode 拡張をインストールする提案をしてくる。これを入れると：

• エディタで開いている差分が Claude 側に共有される
• Cmd+Esc でエディタから直接 Claude Code を呼び出せる
• 画像のドラッグ＆ドロップが効く

Cursor を使っている場合も同じ拡張機能で動作する。両方を併用しても支障はない（Claude Code は CLI、Cursor は IDE という役割分担）。

法人利用時のチェックポイント

会社のリポジトリに対して使うときに、最低限見ておきたい項目。

1. 個人情報保護法上の取り扱い

API に送信したコードは Anthropic の利用規約上、学習に使われないと明記されている。とはいえ「越境データ移転」に該当するため、個人情報を含むテストデータをそのまま投げないこと。アクセス範囲を絞るには次の 3 つを組み合わせる。

• .gitignore を整備する：Claude Code は既定で .gitignore を尊重するので、config/secrets.yml や data/customer_*.csv、.env* などは Git 管理外にしておけば自動的にエージェントの読込対象から外れる。
• /permissions でツール権限を絞る：セッション内で「Read は許可、Bash(rm:*) は拒否」のように、ファイルパス単位 / コマンド単位の許可リストを設定できる。
• より厳密に制御したいケース：PreToolUse 系のフック（Anthropic 公式ドキュメントの Hooks セクション参照）を書くと、特定パスへのアクセスを実行前に止められる。サードパーティ製の claudeignore 風フックも公開されているので、社内ポリシーに合わせて選定する。

2. 監査ログ

Anthropic 公式プランでは個人単位のログしか残らない。法人で「誰がいつ何を AI に投げたか」を残したい場合は、ofox.ai のような中継ゲートウェイを通す構成にすると、API キー単位の利用ログを管理画面で確認できる。

3. 社内ネットワーク

プロキシ経由の場合は HTTPS_PROXY / https_proxy を設定する。社内 CA 証明書を信頼させる必要があれば、NODE_EXTRA_CA_CERTS に PEM ファイルへのパスを通すか、OS 側の証明書ストアにルート CA を入れた上で動作確認する。社内ポリシーで curl | sh 系の自己完結バイナリが使えない場合は、後述の npm 経路でインストールするのが無難。

4. プラン選定

トラブルシューティング

実際にハマりやすい順に並べる。

command not found: claude PATH が通っていない。Homebrew なら eval "$(/opt/homebrew/bin/brew shellenv)" を .zshrc に追記。npm グローバルなら npm config get prefix の bin を PATH に追加。

401 Unauthorized が出る ANTHROPIC_API_KEY か ANTHROPIC_BASE_URL が古い値で残っている。env | grep ANTHROPIC で確認し、必要なら unset してから再設定する。

WSL2 でクリップボード画像が貼れない 古いバージョン由来のことが多い。claude --version を確認し、npm i -g @anthropic-ai/claude-code@latest（または brew upgrade --cask claude-code）で最新化する。それでも貼れないときは、Windows Terminal / WezTerm 側のクリップボード共有設定（WSLg / WSLENV）を確認する。

プロンプトが日本語入力中に途切れる ターミナルエミュレータ側の IME ハンドリング問題。iTerm2 / Windows Terminal / WezTerm のいずれかに切り替えると安定する。標準の Terminal.app でも動くが、長文入力時は他のエミュレータを推奨。

claude が応答しない / フリーズする /compact でコンテキストを圧縮するか、Ctrl+C で中断して /clear してからやり直す。大規模リポジトリでは CLAUDE.md で node_modules や dist をスキャン対象から除外しておく。

次のステップ

セットアップが終わったら、最初の 1 週間は以下を試すと Claude Code の挙動が掴める。

• 既存リポジトリで /init を走らせて CLAUDE.md を生成、プロジェクト固有のルールを追記する
• claude -p を Git の pre-commit フックに組み込んで、コミットメッセージの自動生成を試す
• VSCode 拡張を入れて、PR レビューを /review でやってみる
• .gitignore と /permissions を整備して、社内コードで安全に動かせる範囲を確定させる

ここまで来れば、Cursor や Copilot Chat とは違う「ターミナル常駐型エージェント」の使い方が体に馴染んでくるはずだ。コーディングのワークフロー全体を Claude Code に渡し切る必要はなく、長時間の自動化タスクや横断的なリファクタにだけ呼び出す、くらいの使い分けが現実的だと思う。

---

関連リンク

• Anthropic Claude Code 公式ドキュメント
• ofox.ai モデル一覧
• ofox.ai API ドキュメント