Claude Code は Anthropic 製のコマンドラインコーディングエージェントで、コードベースの読み取り、ファイルの編集、コマンドの実行、バックエンドでの LLM API への接続が行えます。このガイドでは、セットアップ、フラグ、スラッシュコマンド、カスタムコマンド、および Novita AI への API ルーティングについて説明します。データベース、ブラウザ、コードランナーの接続については、CLI および JSON 設定に関する別の Claude MCP 設定ガイド を参照してください。
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 ですが、1 つの環境変数で任意の 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 |
バックグラウンドセッションスーパーバイザーの状態確認 |
サブコマンドを Typo した場合、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 worktree で開始 |
--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 |
インタラクティブ diff ビューアを開く |
/code-review [--fix] |
現在の diff をレビュー; --fix は結果を適用 |
/security-review |
保留中の変更に対する詳細なセキュリティパス |
/batch <instruction> |
大規模な変更を分解し、並列 worktree で実行 |
/background |
セッションを切り離してバックグラウンドエージェントとして実行 |
ユーティリティ
| コマンド | 目的 |
|---|---|
/help |
利用可能なコマンドを表示 |
/doctor |
インストールと設定の問題を診断 |
/usage |
セッションのコストとプラン使用量を表示 |
/export |
会話をプレーンテキストとしてエクスポート |
/config |
設定を開くか、値を直接設定: /config thinking=false |
/skills |
利用可能なスキルを一覧表示 |
カスタムスラッシュコマンド
カスタムスラッシュコマンド（現在はスキルと呼ばれます）を使用すると、チームで共有できる繰り返し可能な手順をパッケージ化できます。
カスタムコマンドの作成方法
.claude/skills/（プロジェクトレベル）または ~/.claude/skills/（個人用、全プロジェクトで利用可能）の下にディレクトリを作成します。
mkdir -p .claude/skills/review-pr
そのディレクトリ内に SKILL.md ファイルを作成します。
---
description: Review an open GitHub PR for security issues and test coverage gaps. Use when the user asks to review a PR or check pull request quality.
---
## Instructions
Review the pull request with these priorities:
1. Identify any security vulnerabilities: injection risks, auth gaps, data exposure.
2. Check test coverage for new code paths.
3. Flag any missing error handling at system boundaries.
Summarize findings in three sections: Security, Coverage, Other. Use ✓ for passing checks and ⚠ for issues.
これにより、/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: Summarize uncommitted changes and flag risks.
---
## Current diff
!`git diff HEAD`
## Instructions
Summarize the changes in bullet points. Flag any risks: missing error handling, hardcoded values, untested paths.
このスキルを実行すると、Claude Code は git diff HEAD を実行し、その行を実際の diff 出力に置き換えます。Claude はツールコールを通じて要求する代わりに、実際のワーキングツリーの状態を直接確認します。
Novita AI を LLM バックエンドとして使用する
Claude Code はすべての API トラフィックを ANTHROPIC_BASE_URL 環境変数を通じてルーティングします。これを Novita AI の Anthropic 互換エンドポイントに設定すると、DeepSeek、Kimi、Qwen、GLM のバリアントなど、幅広いモデルにアクセスでき、デフォルトの Anthropic エンドポイントよりもトークン単価が大幅に低くなります。
Novita AI API キーの取得
Novita AI アカウントにサインアップ して、無料トライアルクレジットを受け取ります。キー管理ページ に移動し、Create New Key をクリックして、すぐにキーをコピーします。
環境変数の設定
Mac および Linux の場合:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
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=<Your Novita API Key>
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 "find any error patterns" --output-format json
Novita AI の LLM API は、ツール使用、構造化出力、ストリーミングを含む完全な Anthropic メッセージ形式をサポートしているため、すべての Claude Code 機能が変更なしで動作します。
分離実行のための Agent Sandbox
Claude Code 上に自動化パイプラインを構築している場合、Novita AI の Agent Sandbox は、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」と入力して Open in New Tab を選択します。
VS Code 統合では、インライン diff レビュー、@ ファイル参照、編集前の計画レビュー、会話履歴がエディタパネル内で直接利用できます。拡張機能とともに統合ターミナルで Claude Code を使用することもできます。
JetBrains
JetBrains Marketplace から Claude Code プラグインをインストールし、IDE を再起動します。このプラグインは CLI が別途インストールされている必要があります。IntelliJ IDEA、PyCharm、WebStorm、その他の JetBrains IDE で、インタラクティブな diff 表示と選択コンテキストの共有を提供します。
デスクトップアプリとウェブ
Claude Code デスクトップアプリ（macOS および Windows）を使用すると、diff を視覚的にレビューし、複数のセッションを並べて実行し、定期的なタスクをスケジュールできます。claude.ai/code のウェブインターフェースでは、ローカル設定なしでブラウザでセッションを実行でき、ローカルにないリポジトリや、リモートで監視できる長時間実行タスクを開始する場合に便利です。
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 サブスクリプションなしで Claude Code を使用できますか？
はい。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 は、シンプルな API を使用して AI モデルを簡単にデプロイできる機能を開発者に提供し、さらに手頃な価格で信頼性の高い GPU クラウドをビルドとスケーリングに提供する AI クラウドプラットフォームです。
