Claude Code 完全チュートリアル
インストールからマスターまで — Claude Code の包括的ガイド：セットアップ、機能、モデル選択、実践例
Claude Code 完全チュートリアル¶
このチュートリアルでは、2026年最強のAIプログラミングアシスタント Claude Code を基礎から高度なテクニックまで解説します。
1. Claude Code とは¶
Claude Code は Anthropic の公式 CLI エージェント型プログラミングアシスタントです。
- 自律的な計画立案：タスクを理解し、実行計画を作成
- コードの直接操作：ファイルの読み取り、編集、作成
- ターミナル実行：テスト、ビルド、依存関係のインストール
- 深いプロジェクト理解：200K トークンコンテキスト（Opus 4.6 は最大 1M）
- サブエージェント：複雑なタスクを並列処理
QCode.cc を通じて使用する理由¶
- アジア太平洋ノードで低レイテンシー
- 公式価格比 最大80%オフ
- Claude Code と Codex で クォータを共有（1つのプラン）
2. インストールと設定¶
npm install -g @anthropic-ai/claude-code
# ~/.bashrc または ~/.zshrc に追加
export ANTHROPIC_BASE_URL=https://asia.qcode.cc/api
export ANTHROPIC_API_KEY=cr_あなたのキー
claude --version # 確認
3. はじめての使用¶
cd ~/my-project
claude
> このプロジェクトのアーキテクチャを分析してください
Claude が自動的にファイルを読み取り、構造化された分析結果を提供します。
権限モード¶
| モード | 説明 |
|---|---|
| デフォルト | 各操作で確認 |
--allowedTools |
指定ツールのみ許可 |
--dangerously-skip-permissions |
全確認スキップ（隔離環境のみ） |
4. コア機能¶
Plan Mode（計画モード）¶
> /plan
> JWT を使ったユーザー認証を追加したい
主要コマンド¶
| コマンド | 機能 |
|---|---|
/model |
モデル切り替え |
/plan |
計画モードに入る |
/compact |
コンテキスト圧縮 |
/cost |
コスト確認 |
/clear |
コンテキストクリア |
/init |
CLAUDE.md 生成 |
5. CLAUDE.md 設定¶
/init # 自動生成
# MyApp
## 技術スタック
- React 19 + TypeScript + Vite
## コマンド
- 開発: `pnpm dev`
- テスト: `pnpm test`
## コーディング規約
- 関数コンポーネントのみ
- any 型禁止
6. モデル選択¶
| モデル | 特徴 | 入力価格 | 推奨シーン |
|---|---|---|---|
| Opus 4.6 | 最強推論力 | $5.00/M | アーキテクチャ、複雑なデバッグ |
| Sonnet 4.6 | 最適バランス | $3.00/M | 日常コーディング |
| Haiku 4.5 | 最速・最安 | $1.00/M | フォーマット、簡単な質問 |
/model opus # Opus に切り替え
/model sonnet # Sonnet に切り替え
推奨: Sonnet 70% + Opus 15% + Haiku 15%
7. 実践例¶
新しいプロジェクトの理解¶
> プロジェクトを分析: 技術スタック、主要モジュール、データフロー
Plan Mode で機能実装¶
> /plan
> レート制限を追加: ユーザーあたり60リクエスト/分、Redis バックエンド
複雑なバグのデバッグ¶
/model opus
> 同時注文で在庫がマイナスになる。競合条件を分析して
8. Claude Code + Codex 併用¶
| Claude Code | Codex CLI | |
|---|---|---|
| スタイル | インタラクティブ対話 | 自律実行 |
| 得意分野 | 推論・計画 | バッチ実行・自動化 |
| 設定ファイル | CLAUDE.md | AGENTS.md |
QCode.cc で 1 つのプランで両方使用可能、切り替えコストゼロ。
9. FAQ¶
Q: インストールエラー？
sudo npm install -g @anthropic-ai/claude-code
Q: 接続タイムアウト？
echo $ANTHROPIC_BASE_URL # https://asia.qcode.cc/api であることを確認
Q: コストが心配？ → Sonnet を日常使用（Opus より 60% 安い）、/cost で確認