Claude Code は、Anthropic が提供するコマンドラインコーディングエージェントで、コードベースを読み取り、ファイルの編集、コマンドの実行、バックエンドの LLM API への接続を行います。このガイドでは、CLI の完全なドキュメント（セットアップ方法、利用可能なフラグとスラッシュコマンド、カスタムスラッシュコマンドの作成方法、デフォルトの Anthropic エンドポイントの代わりに Novita AI に API 呼び出しをルーティングする方法）を説明します。
Claude Code とは
Claude Code は、CLI、VS Code 拡張機能、JetBrains プラグイン、デスクトップアプリ、ブラウザインターフェースとして利用できるエージェンティックコーディングツールです。すべてのインターフェースは同じ基盤エンジンを共有しています。Claude Code は LLM API バックエンドに接続し、プロジェクトを読み取り、テストの作成、ファイルをまたいだリファクタリング、プルリクエストの作成、git 管理などのマルチステップタスクを実行します。
CLI は最も柔軟なインターフェースです。Unix の慣習に従っており、ログをパイプで渡したり、-p フラグを使って CI で実行したり、他のツールと連携したりできます。設定はファイルに保存されるため（CLAUDE.md、.claude/settings.json、環境変数）、自動化されたコンテキストでも予測可能な動作をします。
内部的には、Claude Code はすべてのリクエストを Anthropic 互換の API エンドポイントに送信します。デフォルトのエンドポイントは api.anthropic.com ですが、単一の環境変数で任意の Anthropic 互換プロバイダー（Novita AI を含む）にリダイレクトできます。
Claude Code のセットアップ
インストール
macOS、Linux、WSL での推奨方法はネイティブインストーラーです。
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell の場合:
irm https://claude.ai/install.ps1 | iex
ネイティブインストールはバックグラウンドで自動更新されます。
npm を使用する場合は、Node.js 18 以降が必要です。
node --version # 18 以降である必要があります
npm install -g @anthropic-ai/claude-code
Homebrew（macOS）は安定版リリースチャンネルを追跡します。
brew install --cask claude-code
Homebrew は自動更新されません。最新バージョンが必要な場合は brew upgrade claude-code を実行してください。
初回実行
プロジェクトディレクトリに移動し、インタラクティブセッションを起動します。
cd your-project
claude
初回使用時に、Claude Code はログインを促します。認証後、プロジェクトを読み取り、指示を待ちます。
プロジェクトのセットアップ
新しいリポジトリでは /init を実行して、スターター CLAUDE.md ファイルを生成します。Claude Code は各セッションの開始時に CLAUDE.md を読み取るため、コーディング規約、推奨ライブラリ、アーキテクチャメモ、レビューチェックリストを記述するのに最適な場所です。
/init
/init の後は、/memory を使用してファイルを編集するか、自動メモリを有効にします。これにより、Claude がプロジェクトについてセッション間で保存した観察結果が保持されます。
CLI コマンドリファレンス
Claude Code のトップレベルシェルコマンドは、セッションの開始、認証の管理、バックグラウンドタスクの処理を行います。最も便利なコマンドの一部を以下に示します。
| コマンド | 説明 |
|---|---|
claude |
カレントディレクトリでインタラクティブセッションを開始 |
claude "query" |
初期プロンプトでセッションを開始 |
claude -p "query" |
クエリを実行して終了（非インタラクティブ / SDK モード） |
cat file | claude -p "query" |
ファイルの内容をクエリにパイプ |
claude -c |
カレントディレクトリで最新のセッションを継続 |
claude -r "name" "query" |
名前または ID でセッションを再開 |
claude update |
最新バージョンに更新 |
claude install stable |
特定のバージョンをインストールまたは再インストール |
claude auth login |
Anthropic アカウントにサインイン |
claude auth login --console |
サブスクリプションではなく API キー課金でサインイン |
claude auth status |
認証状態を表示 |
claude agents --json |
エージェントビューを開き、アクティブなセッションを JSON で表示 |
claude mcp |
MCP サーバーを設定 |
claude daemon status |
バックグラウンドセッションスーパーバイザーの状態を確認 |
サブコマンドを間違えて入力した場合、Claude Code は最も近い候補を提案します: claude udpate と入力すると Did you mean claude update? と表示されます。
CLI フラグリファレンス
フラグはセッションの Claude Code の動作を変更します。claude の後に任意の呼び出しで指定します。特によく使われるフラグをいくつか紹介します。
| フラグ | 説明 |
|---|---|
-p, --print |
非インタラクティブモード。応答を表示して終了 |
-c, --continue |
最新の会話を読み込む |
-r, --resume |
ID または名前でセッションを再開 |
--model |
このセッションのモデルを設定（sonnet、opus、haiku、または完全なモデル ID） |
--permission-mode |
特定の権限モードで開始: default、plan、auto、acceptEdits、bypassPermissions |
--add-dir |
追加のディレクトリへのファイルアクセスを許可 |
--system-prompt |
システムプロンプトを完全に置き換える |
--append-system-prompt |
デフォルトのシステムプロンプトに追加 |
--max-turns |
-p モードでのエージェントのターン数を制限 |
--max-budget-usd |
-p モードでの API 支出を制限 |
--output-format |
-p モードの出力形式: text、json、stream-json |
--bg |
バックグラウンドエージェントとして開始し、すぐに戻る |
--worktree, -w |
分離された git ワークツリーで開始 |
--bare |
フック、スキル、プラグイン、MCP の自動検出をスキップしてスクリプト呼び出しを高速化 |
--verbose |
完全なターンごとの出力を表示 |
--mcp-config |
JSON ファイルから MCP サーバーを読み込む |
--effort |
推論の努力レベルを設定: low、medium、high、xhigh、max |
--print + --output-format json の組み合わせはスクリプティングの標準パターンです。予算制約のある CI パイプラインでは、--max-budget-usd と --max-turns を組み合わせて使用します。
スラッシュコマンドドキュメント
スラッシュコマンドはアクティブなセッション内で実行します。/ と入力するとすべてのコマンドが表示され、/ の後に文字を入力してフィルタリングできます。コマンドはメッセージの先頭でのみ機能します。
セッションとコンテキスト管理
| コマンド | 目的 |
|---|---|
/clear |
新しい会話を開始。以前のセッションは /resume で再開可能 |
/compact |
会話を要約してコンテキストウィンドウのスペースを解放 |
/context |
コンテキスト使用状況を可視化し、最適化の提案を表示 |
/resume |
名前またはピッカーから以前のセッションを再開 |
/branch |
会話をフォークして別の方向を試す |
/rewind |
コードと会話をチェックポイントまでロールバック |
プロジェクト設定
| コマンド | 目的 |
|---|---|
/init |
プロジェクト用のスターター CLAUDE.md を生成 |
/memory |
CLAUDE.md ファイルを編集し、自動メモリを管理 |
/mcp |
MCP サーバー接続を対話的に管理 |
/agents |
サブエージェント設定を構成 |
/permissions |
ツールの許可、確認、拒否ルールを設定 |
/hooks |
フック設定を表示 |
開発ワークフロー
| コマンド | 目的 |
|---|---|
/plan |
大規模な変更の前に計画モードに入る |
/model |
アクティブなモデルを切り替える |
/effort |
推論の努力レベルを調整 |
/diff |
インタラクティブな差分ビューアを開く |
/code-review [--fix] |
現在の差分をレビュー。--fix は結果を適用 |
/security-review |
保留中の変更に対してセキュリティパスを実行 |
/batch <instruction> |
大きな変更を分解し、並列ワークツリーで実行 |
/background |
セッションを切り離してバックグラウンドエージェントとして実行 |
ユーティリティ
| コマンド | 目的 |
|---|---|
/help |
利用可能なコマンドを表示 |
/doctor |
インストールと設定の問題を診断 |
/usage |
セッションのコストとプランの使用状況を表示 |
/export |
会話をプレーンテキストとしてエクスポート |
/config |
設定を開くか、値を直接設定: /config thinking=false |
/skills |
利用可能なスキルを一覧表示 |
カスタムスラッシュコマンド
カスタムスラッシュコマンド（現在はスキルと呼ばれます）を使用すると、チームで共有可能な繰り返し可能な手順をパッケージ化できます。
カスタムコマンドの作成方法
.claude/skills/（プロジェクトレベル）または ~/.claude/skills/（個人用、全プロジェクトで利用可能）の下にディレクトリを作成します。
mkdir -p .claude/skills/review-pr
そのディレクトリ内に SKILL.md ファイルを作成します。
---
description: セキュリティ問題やテストカバレッジのギャップについてオープンな GitHub PR をレビューします。ユーザーが PR のレビューやプルリクエストの品質確認を依頼したときに使用します。
---
## 指示
以下の優先順位でプルリクエストをレビューしてください。
1. セキュリティの脆弱性を特定する: インジェクションリスク、認証の欠陥、データ漏洩。
2. 新しいコードパスのテストカバレッジを確認する。
3. システム境界でのエラーハンドリングの欠落を指摘する。
結果は「セキュリティ」「カバレッジ」「その他」の 3 セクションにまとめてください。合格項目には ✓、問題がある項目には ⚠ を使用してください。
これにより、/review-pr コマンドが作成され、直接呼び出すことができます。
/review-pr
また、説明に一致する質問をすると、Claude は自動的にスキルを読み込みます。
スキルの場所と優先順位
スキルには優先順位があります。エンタープライズは個人設定より優先され、個人設定はプロジェクト設定より優先されます。プロジェクトスキルは .claude/skills/ に配置します。個人スキル（すべてのプロジェクトで利用可能）は ~/.claude/skills/ に配置します。
~/.claude/skills/ → 個人用、全プロジェクト
.claude/skills/ → このプロジェクトのみ
.claude/commands/ 内のカスタムコマンドも引き続き機能します。.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md の両方が /deploy を作成し、同じように動作します。
動的コンテキスト注入
スキルは、Claude がプロンプトを確認する前にライブデータを注入できます。! プレフィックスを使用するとシェルコマンドを実行し、その出力をインライン化します。
---
description: 未コミットの変更を要約し、リスクをフラグします。
---
## 現在の差分
!`git diff HEAD`
## 指示
変更内容を箇条書きで要約してください。リスク（エラーハンドリングの欠落、ハードコードされた値、未テストのパス）があればフラグを立ててください。
このスキルを実行すると、Claude Code は git diff HEAD を実行し、その行を実際の差分出力で置き換えます。Claude はツール呼び出しでリクエストする必要なく、実際のワーキングツリーの状態を確認できます。
Novita AI を LLM バックエンドとして使用する
Claude Code はすべての API トラフィックを ANTHROPIC_BASE_URL 環境変数を介してルーティングします。これを Novita AI の Anthropic 互換エンドポイントに設定すると、デフォルトの Anthropic エンドポイントよりも大幅に低いトークン単価で、DeepSeek、Kimi、Qwen、GLM バリアントを含む幅広いモデルにアクセスできます。
Novita AI の API キーを取得する
Novita AI アカウントに登録すると、無料トライアルクレジットが提供されます。キー管理ページに移動し、「新しいキーを作成」をクリックし、キーをすぐにコピーします。
環境変数を設定する
Mac および Linux の場合:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<あなたの Novita API キー>"
export ANTHROPIC_MODEL="deepseek/deepseek-v4-flash"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek/deepseek-v4-flash"
Windows（コマンドプロンプト）の場合:
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<あなたの Novita API キー>
set ANTHROPIC_MODEL=deepseek/deepseek-v4-flash
set ANTHROPIC_SMALL_FAST_MODEL=deepseek/deepseek-v4-flash
Mac/Linux で永続化するには、export 行を ~/.bashrc または ~/.zshrc に追加します。
ANTHROPIC_SMALL_FAST_MODEL は、ファイル検索やクイックサマリーなどの高速な内部タスクに Claude Code が使用する軽量モデルを制御します。同じモデル ID に設定すると、すべてのトラフィックが 1 つの課金アカウントにまとめられます。
Claude Code を起動する
環境変数を設定した状態で、通常どおり Claude Code を起動します。
cd your-project
claude
Claude Code は、指定したモデルで Novita AI のエンドポイントに接続します。インタラクティブセッションは同じように動作します。すべての CLI フラグ、スラッシュコマンド、カスタムスキルは、どのバックエンドを使用しているかに関係なく同じように動作します。
スクリプティングや CI の場合も、同じアプローチが適用されます。
cat logs.txt | claude -p "エラーパターンを見つけてください" --output-format json
Novita AI のLLM APIは、ツール使用、構造化出力、ストリーミングを含む完全な Anthropic メッセージ形式をサポートしているため、すべての Claude Code 機能がそのまま動作します。
分離実行のためのエージェントサンドボックス
Claude Code 上に自動化パイプラインを構築する場合、Novita AI のエージェントサンドボックスは、プログラムでエージェントを実行するための分離された firecracker バッキングの実行環境を提供します。これは、CI ワークフロー、バックグラウンドエージェント、および開発マシン上で直接実行するのではなく実行分離が必要なマルチエージェントセットアップに関連します。
IDE ツールとしての Claude Code
Claude Code はエディタに直接統合されます。これが「Claude Code は IDE である」と言われる所以です。つまり、スタンドアロンの IDE ではなく、既存の環境に組み込まれるコーディングエージェントです。
VS Code と Cursor
VS Code Marketplace から Claude Code 拡張機能をインストールするか（「Claude Code」で検索）、またはCursor マーケットプレイスからインストールします。インストール後、コマンドパレット（Cmd+Shift+P / Ctrl+Shift+P）を開き、「Claude Code」と入力して「新しいタブで開く」を選択します。
VS Code 統合により、インライン差分レビュー、@ファイルメンション、編集前の計画レビュー、エディタパネル内の会話履歴が追加されます。また、拡張機能と一緒に統合ターミナルで Claude Code を使用することもできます。
JetBrains
JetBrains Marketplace からClaude Code プラグインをインストールし、IDE を再起動します。プラグインは CLI が別途インストールされている必要があります。IntelliJ IDEA、PyCharm、WebStorm、その他の JetBrains IDE で、インタラクティブな差分表示と選択コンテキスト共有を提供します。
デスクトップアプリと Web
Claude Code デスクトップアプリ（macOS および Windows）を使用すると、差分を視覚的にレビューし、複数のセッションを並べて実行し、定期的なタスクをスケジュールできます。claude.ai/code の Web インターフェースは、ローカルセットアップなしでブラウザでセッションを実行できます。ローカルにリポジトリがない場合や、リモートで監視できる長時間実行タスクを開始する場合に便利です。
FAQ
ANTHROPIC_BASE_URL とは何ですか？なぜ重要なのですか？
ANTHROPIC_BASE_URL は、Claude Code がリクエストを送信する API エンドポイントを指定します。デフォルトは api.anthropic.com です。これを https://api.novita.ai/anthropic に設定すると、すべてのトラフィックが Novita AI の Anthropic 互換エンドポイントにルーティングされ、異なる価格帯の代替モデルを使用できます。コードの変更やプラグインは不要で、環境変数だけで設定できます。
CLI フラグとスラッシュコマンドの違いは何ですか？
CLI フラグ（--model、--permission-mode、--max-turns など）は、シェルから claude バイナリを起動するときに設定します。セッションが開始される前に設定を構成します。スラッシュコマンド（/model、/plan、/compact など）はアクティブなセッション内で実行され、会話の途中で動作を変更します。
Claude Code を Claude サブスクリプションなしで使用できますか？
はい。claude auth login --console を使用すると、Anthropic Console の API キー課金でサインインでき、サブスクリプションではなく従量課金制になります。ANTHROPIC_BASE_URL を介して Novita AI にルーティングする場合、Novita AI アカウントのみが必要で、Anthropic アカウントは課金されません。
カスタムスラッシュコマンドと CLAUDE.md の違いは何ですか？
CLAUDE.md の内容は各セッションの開始時に読み込まれ、コンテキスト全体に保持されます。スキル（カスタムコマンド）は呼び出されたときにのみ読み込まれるため、長い参照資料は実際に必要になるまでトークンコストが発生しません。CLAUDE.md には、Claude が常に知っておくべきプロジェクトの事実（コーディング規約、ビルドコマンド、アーキテクチャメモ）を記述します。スキルには、オンデマンドで実行する手順（PR レビューチェックリスト、デプロイ手順、テスト生成ワークフロー）を記述します。
Claude Code は CI で動作しますか？
はい。非インタラクティブモードで構造化出力を得るには、claude -p "query" --output-format json を使用します。支出を制限するには --max-budget-usd を、実行時間を制限するには --max-turns を追加します。--bare フラグは、スクリプトコンテキストでの起動を高速化するために、フック、スキル、プラグインの自動検出をスキップします。Claude Code は、公式ワークフローテンプレートを通じて GitHub Actions および GitLab CI/CD とも統合します。
Novita AI は AI クラウドプラットフォームであり、シンプルな API を使用して AI モデルを簡単にデプロイする方法を開発者に提供するとともに、スケーリングのための手頃で信頼性の高い GPU クラウドを提供します。
