クイックスタート

5 分で Claude Code の基本を習得

API キーが必要ですか？ 登録する →·エンドポイントと Base URL →

⚡ まだ未接続？コマンド 1 行で設定完了：curl -fsSL https://qcode.cc/install/claude-code.sh | bash（Windows：irm https://qcode.cc/install/claude-code.ps1 | iex）。詳細は ワンクリック設定スクリプト。

まだ Key がありませんか？まずプランを選んで Key を取得してください。どの選択肢でも Key の使い方は同じなので、以下の手順は変わりません。

インストールと環境変数の設定が完了したら、5 分で Claude Code の基本機能を習得しましょう。

Claude Code の起動¶

ターミナルでプロジェクトディレクトリに移動して実行：

cd /path/to/your/project
claude

Claude Code のインタラクティブインターフェースが表示され、会話を開始できます。

基本的な操作¶

1. コードを理解する¶

> このプロジェクトのアーキテクチャは？
> src/auth/login.ts の仕組みを説明して
> データベースを呼び出している箇所をすべて見つけて

2. コードを生成する¶

> ユーザー登録の API エンドポイントを作成して
> UserService クラスのユニットテストを追加して
> React ログインフォームコンポーネントを作成して

3. 既存のコードを編集する¶

> utils.js をリファクタリングして可読性を向上させて
> handleSubmit 関数のメモリリークを修正して
> すべてのパブリック関数に TypeScript 型を追加して

4. 問題をデバッグする¶

> ログイン後にユーザーが 404 にリダイレクトされるのはなぜ？
> このエラーを分析して：TypeError: Cannot read property 'id' of undefined
> API レスポンスが遅い原因を調査して

5. Git 操作¶

> 変更したファイルを表示して
> これらの変更を適切なコミットメッセージでコミットして
> PR の説明を作成して

@ でファイルを参照¶

@ シンボルを使用して特定のファイルを正確に参照し、Claude に内容を直接読み込ませることができます：

> @src/components/Header.tsx をレビューしてパフォーマンスを最適化して
> @src/v1/api.js と @src/v2/api.js を比較して
> @package.json に基づいてプロジェクトの依存関係を分析して

ヒント：@ を入力後に Tab キーを押すとファイルパスを自動補完できます。

パイプ入力¶

他のコマンドの出力を Claude Code に渡して分析できます：

# git の変更を説明
git diff | claude "これらのコード変更を説明して"

# ログエラーを分析
cat error.log | claude "これらのエラーを分析して解決策を提供して"

# PR の変更をレビュー
gh pr diff 123 | claude "この PR のコード品質をレビューして"

よく使うスラッシュコマンド¶

セッション中に / コマンドを使用：

キーボードショートカット¶

プロジェクト設定の初期化¶

初回使用時に /init を実行して、Claude にプロジェクトを分析させ設定を生成させます：

> /init

これにより CLAUDE.md ファイルが作成され、以下が含まれます：

• プロジェクトの技術スタックとアーキテクチャ概要

• よく使うビルドとテストコマンド

• コードスタイルガイドライン

• プロジェクト固有の規約

CLAUDE.md の目的：Claude Code は起動時にこのファイルを自動的に読み込み、AI がプロジェクトのコンテキストをより良く理解できるようになります。

実践例¶

例 1：新機能を追加¶

> ユーザーアバターアップロード機能を追加したい：
  1. JPG/PNG 形式をサポート
  2. ファイルサイズ制限 2MB
  3. アップロード後に 200x200 に自動クロップ
  4. S3 に保存

例 2：バグを修正¶

> ユーザーからのフィードバック：「保存」ボタンをクリックするとページがフリーズする
> @src/pages/EditProfile.tsx の問題を調査して

例 3：コードレビュー¶

> /review
> セキュリティの問題とパフォーマンスのボトルネックに焦点を当てて

例 4：スマートコミット¶

> この変更をコミットして、適切なコミットメッセージを付けて

Claude は自動的に：

1. すべての変更を分析

2. 適切なコミットメッセージを生成

3. コミットを完了

効率的な使い方のヒント¶

1. 具体的に：制約を含めて何が欲しいか明確に説明

2. 分割する：複雑なタスクを小さなステップに分割

3. 早めに中断：出力が期待どおりでない場合はすぐに Esc を押す

4. 参照を活用：AI に推測させるのではなく @ でファイルを指定

5. コンテキストを維持：Claude は同じセッション内の以前の会話を記憶

主な設定項目¶

クイックスタートで覚えておくのは次の 4 か所だけです。残りは必要になったときに見ます。

変数の全一覧は環境変数の設定、一括設定はワンクリック設定スクリプトを参照してください。

セッション管理：公式コマンドをいくつか¶

2026-10-15 時点の Claude Code 公式ドキュメントによると次のとおりです。

• /usage はセッションの費用と使用量を表示し、/cost はそのエイリアスです。
• claude --continue は現在のディレクトリの直近のセッションを再開し、claude --resume は一覧から選べます。セッション内では /resume も使えます。
• ファイルを編集させずに計画だけ見たいときは Shift+Tab で権限モードを切り替えます。ステータスバーに ⏸ plan mode on と出ればプランモードで、計画を承認するまで編集は行われません。

よくあるエラーと切り分け¶

どの層の問題か分からないときは、接続先と API 形式の第 5 節の curl テストを実行してください。400 または 401 が返れば経路は通っています。

よくある質問¶

リクエストが本当に QCode を通っているか確認するには？¶

probe.qcode.cc に API キーを入力すると、直近のリクエストのモデルとトークンが見えます。何も表示されなければ QCode に届いていないので、環境変数を見直してください。

このセッションにいくらかかったかはどこで見られますか？¶

セッション内では /usage（または /cost）で現在のセッションの使用量を確認できます。アカウント全体の消費は QCode のコンソールで確認します。QCode はトークン単位の課金で、モデルごとの単価は qcode.cc/models にあります。

ターミナルを閉じても前回の会話を続けられますか？¶

はい。同じプロジェクトのディレクトリで claude --continue を実行すると直近のセッションに戻れます。一覧から選ぶ場合は claude --resume です。

最初に選ぶモデルは？¶

日常のコーディングは claude-sonnet-5 から始め、難しい作業では /model でより強いモデルに切り替えます。比較はモデルの選び方を参照してください。

GPT や中国系モデルを使いたい場合は？¶

Claude Code 自体は Anthropic インターフェースなので、中国系モデルはそのまま選べます。GPT 系は Codex CLI を使います。設定は Codex 完全ガイドを参照してください。

次のステップ¶

Claude Code の基本を習得しました！次は：

1. CLI テクニック で 34 の実践的なヒントを探索

2. ワークフロー で生産性を向上

3. Codex 統合 で別の AI ツールを使用

企業版 →