AI コーディング

Claude Code をインストールして安全に初回起動する

インストール、認証、gateway、可逆的な初回変更、Git 検証を含む Claude Code の現行ガイドです。

BT

BetterToken

編集チーム
2 分で読めます

Claude Code はターミナルと開発環境で動く Anthropic の coding agent です。最新クライアントを入れ、小さな Git プロジェクトで default または plan から始め、最初の変更は必ず git diff で確認します。

Claude Code 用の独立した従量 API が必要なら、独自 API Key を作成して BetterToken Claude Code ガイドに従います。BetterToken は Claude Code の Anthropic-compatible API 経路であり、Claude Chat/Cowork を有効化せず、Claude subscription の代替でもありません。

インストール前に用意するもの

ターミナル、変更してよい小さな Git プロジェクト、できればクリーンな git status を用意します。公式 login には対応する Claude または Console アカウントが必要で、gateway は別の provider 経路です。Key をソース、スクリーンショット、shell history に入れません。

macOS、Linux、WSL の Native Install

Anthropic が推奨する Native Install は次です。

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

この手順は client を入れるだけで、browser login や provider 設定は行いません。古い npm 手順ではなく、他の方法と依存関係は現行 Docs で確認します。

Windows の PowerShell、CMD、WSL

PowerShell:

irm https://claude.ai/install.ps1 | iex

CMD:

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

ネイティブ Windows では Claude Code が Bash を使えるよう Git for Windows が推奨されます。WSL では不要です。Linux client を WSL 内に入れ、可能ならプロジェクトも WSL filesystem に置きます。

client と認証状態を確認する

新しい terminal を開いて実行します。

claude --version
claude auth status

次に claude を起動し、公式 browser login を完了します。account を切り替えるときは session 内の /login を使います。API Key を通常の prompt や repository に保存しません。

third-party gateway を設定する

gateway には API Key、対応する Model ID、正確な Base URL が必要です。BetterToken の場合は現行ガイドを使い、Anthropic-compatible Base URL に https://bettertoken.ai を指定します。これは raw Messages の HTTP URL ではなく、client が protocol path を追加します。Key、model、URL を同時に変えず、小さな request で確認します。

読み取り専用で最初の project を開く

cd path/to/test-project
git status
claude --permission-mode plan

「構造、entry point、起動 command を説明して。ファイル変更と network command はしないで」と依頼します。Plan mode は読み取りと探索を行いますが source を編集しません。

可逆的な最初の変更を一つ行う

README.md にローカル開発の短い節を追加する。README.md だけを変更し、依存関係を入れず、network を使わず、commit しない。

許可する action を確認した後、実行します。

git diff -- README.md

対象 file、内容、secret、想定外の configuration や dependency 変更を確認します。

permission mode と安全境界

default は読み取りを許可し、編集と command の前に確認します。plan は source を編集せず調査します。acceptEdits は edit と通常の filesystem 操作を自動許可し、auto は background safety check を持つ research preview です。bypassPermissions は隔離 container または VM 専用です。初回は default か plan にします。

成功信号と API の検証

正しい作業 folder、成功した login または provider request、許可した一 file だけの変更、理解できる diff が初回成功の条件です。BetterToken は Dashboard と Usage History の model、status、input/output/cache token も確認します。これは API 経路の確認であり、Chat/Cowork の entitlement ではありません。

層ごとにトラブルシュートする

claude が見つからなければ terminal を開き直し、古い npm command ではなく公式 installation help を使います。login の問題は Claude login、Console/API、gateway を分けて考えます。provider error は Key、Base URL、Model ID の順に確認します。編集範囲が広ければ拒否し、Plan mode に戻って一 file、network 禁止、commit 禁止を指定します。

次の段階と公式ソース

README の diff がきれいなら、次は一つの test または小さな fix に進みます。scope と autonomy は一つずつ増やします。deployment、API、remote system は local file のようには元に戻せません。

Sources

LLM ワークフローを最適化しませんか？

単一 API でモデルを接続し、キーと AI コストを管理できます。