※ この記事の日本語には、少し不自然な部分があるかもしれません。AIの言語サポートを利用しながら作成しています。
目次
- はじめに
- 1. 3つのモード — 最初に正しく選ぶ
- 2. よく使う7つのスラッシュコマンド
- 3. コンテキスト管理 — 一番大切なスキル
- 4. CLAUDE.md — AIとの契約書
- 5. セキュリティ — AIに秘密情報を読ませない
- 6. 権限 — 信頼にはレベルがある
- 7. 毎日使う3つのコンボ
- 8. 小さなコツ — でも時間を節約できる
- 9. モデル選択 — いつも最強のモデルを使わない
- 10. One-shotモードで自動化
- まとめ
- 最後に
はじめに
この記事は、Claude Codeを使い始めた方、または使っているけど「もっと効率的に使いたい」と考えている開発者を対象としています。
筆者について：私は現在、日本市場向けのシステム開発を手がけるTOMOSIA VIETNAMでエンジニアとして働いています。Claude Codeを毎日使う中で、本当に必要なコマンドだけをまとめた「自分用チートシート」を作りました。
この記事の目的：
- Claude Codeのコマンドをすべて覚える必要はないことを伝える
- 実際の仕事で使う15個のコマンドに絞って紹介する
- なぜそのコマンドを使うのか、いつ使うのかを説明する
想定読者：
- Claude Codeを始めたばかりの方
- コマンドが多すぎて混乱している方
- 毎日の仕事でClaude Codeを効率的に使いたい方
Claude Code チートシート — 私が毎日本当に使うコマンド
概要： Claude Codeには何十ものコマンドとショートカットがあります。でも実際に使ってみると、本当に必要なのは約15個だけだと気づきました。この記事は私のチートシートです。すべてをリストするのではなく、毎日使うものと、その理由を紹介します。
1. 3つのモード — 最初に正しく選ぶ
Claude Codeには3つの実行方法があります。間違ったモードを選ぶことが、初心者によくある最大の失敗です。
| モード | コマンド | いつ使うか |
|---|---|---|
| REPL（対話） | claude |
複数ステップのデバッグ、コードベースの探索、学習 |
| One-shot | claude -p "..." |
簡単な質問、自動化、CI/CD |
| Pipe | cat file | claude -p "..." |
ログファイルの処理、diffのレビュー |
実際の例
# 複数ステップのデバッグ → REPL
claude
# 簡単な質問 → one-shot
claude -p "explain this error: TypeError: undefined is not a function"
# diffのレビュー → pipe
git diff main | claude -p "review this diff for bugs and security issues"
# ログの分析 → pipe
cat errors.log | claude -p "analyze these errors and suggest fixes"
私の教訓： 1行の質問にREPLを使わない。複数ファイルの修正にone-shotを使わない。
2. よく使う7つのスラッシュコマンド
何十もの / コマンドの中で、私がよく使うのは次の7つだけです。
| コマンド | 効果 | いつ使うか |
|---|---|---|
/init |
プロジェクト用のCLAUDE.mdを作成 |
新しいプロジェクトで初めて作業する時 |
/cost |
使用トークンとコストを表示 | 20〜30分ごと |
/compact |
会話履歴を圧縮 | コンテキストが**50〜70%**の時 |
/clear |
すべてのコンテキストを削除 | 関係ないタスクに切り替える時 |
/context |
コンテキストウィンドウの使用量を表示 | AIが「忘れた」と感じた時 |
/model |
セッション中にモデルを変更 | もっと強いモデル、または安いモデルが必要な時 |
/resume |
前のセッションに戻る | 途中の作業を続ける時 |
生死を分ける違い：/compact vs /clear
これは最もよくある誤解です：
-
/compact→ 履歴を圧縮し、現在のタスクのコンテキストを保持する -
/clear→ すべてを削除し、最初からやり直す
私のルール：
- 作業の途中 →
/compact - 別のプロジェクトに切り替え →
/clear
⚠️ 作業中に
/clearを使わないでください。 AIが理解していたタスクの文脈がすべて失われます。
3. コンテキスト管理 — 一番大切なスキル
この記事から一つだけ学ぶなら、コンテキスト管理を学んでください。
Claude Codeのコンテキストウィンドウには限界があります。いっぱいになると、回答の質がはっきり下がります。AIが前に話したことを「忘れ」始めます。
コンテキストの健康状態チェック表
| レベル | 品質 | 行動 |
|---|---|---|
| 0〜50% | 良い | 作業を続ける |
| 50〜70% | まあまあ |
/compactの準備 |
| 70〜85% | 下がり始める | すぐに/compactを実行 |
| 85〜95% | 悪い | compactまたはclearが必要 |
| 95%以上 | 信頼できない |
/clearして最初からやり直す |
私の習慣
# 20〜30分ごとに1回チェック
/cost
# コンテキストが50〜70%なら
/compact
# 複雑なタスクの途中なら、フォーカスを指定できる
/compact Preserve the auth decisions
なぜ/costが大切か？ トークンとお金の両方がわかるからです。以前、セッションを長く開きすぎて、気づかないうちに通常の3倍のコストがかかったことがあります。
4. CLAUDE.md — AIとの契約書
CLAUDE.mdはプロジェクトで最も重要なファイルです。Claudeに「このプロジェクトは何か、ルールは何か、何をしてはいけないか」を伝えます。
必須の6つのセクション
# Project: [プロジェクト名]
## 1. Project Overview
Tech stack: Node.js 20, Express, PostgreSQL, Redis
Architecture: packages/ ディレクトリのモノレポ
## 2. Architecture Rules
- Routes → Services → Repositories → Database
- ビジネスロジックは必ずservicesに置く。routesには絶対に置かない
- 共通型は packages/shared/ に置く
## 3. Coding Conventions
- ファイル: kebab-case (user-service.ts)
- クラス: PascalCase (UserService)
- 関数: camelCase (getUserById)
- エラー処理: Promise<Result<T, AppError>>
- import: @/ プレフィックスの絶対パス
## 4. Commands
npm run dev # 開発サーバー起動 (port 3000)
npm test # 全テスト実行
npm run lint # ESLint + Prettierチェック
npm run db:migrate # マイグレーション実行
## 5. Constraints（禁止事項）
- `any` 型を使わない — 必ず型を定義する
- 確認なしで依存関係をインストールしない
- routeハンドラにビジネスロジックを置かない
- .env ファイルをコミットしない
- マイグレーションなしでDBスキーマを変更しない
## 6. Context（内部知識）
- Redisキーには必ずバージョンプレフィックスを付ける: v1:user:123
- JWTは15分で期限切れ、refresh tokenは7日
- 古い /api/v1 ルートはモバイルアプリ互換のため維持
- Payment gatewayのサンドボックスは TEST_ プレフィックスのキーを使う
理想的なサイズ
| サイズ | トークン | 品質 |
|---|---|---|
| 300〜500語 | 約400〜650 | 短すぎる — エッジケースが抜ける |
| 500〜800語 | 約650〜1000 | ほとんどのプロジェクトに最適 |
| 800〜1200語 | 約1000〜1500 | 十分 — 大きなプロジェクト向け |
| 1200語以上 | 1500以上 | 長すぎる — 効果が減る |
⚠️
CLAUDE.mdは1000語以下にしてください。 プロジェクトメモリに使うトークンは、実際の作業に使えないトークンです。
ファイルの優先順位
| 場所 | 範囲 | 優先度 |
|---|---|---|
~/.claude/CLAUDE.md |
グローバル（全プロジェクト） | 最低 |
./CLAUDE.md |
プロジェクトルート | メイン — これを使う |
./src/CLAUDE.md |
ディレクトリ単位 | 最高（ルートを上書き） |
5. セキュリティ — AIに秘密情報を読ませない
これは多くの人が見落とす最も重要な部分です。
黄金のルール
# .gitignore — 絶対にコミットしない
.env
.env.local
.env.*.local
.env.example パターン — Claudeが読んでも安全
# .env.example — gitにコミット、Claudeが読める
DATABASE_URL=postgresql://username:password@localhost:5432/dbname
API_KEY=your_api_key_here
STRIPE_KEY=sk_test_placeholder
# .env — 本当の秘密情報、gitignore、Claudeは絶対に読まない
# DATABASE_URL=postgresql://realuser:s3cr3t@prod.db:5432/prod
🔴 Claudeに
.envファイルを直接読ませないでください。 必ずダミー値の.env.exampleを使ってください。秘密情報が漏れたら、すぐにrotateしてください。
6. 権限 — 信頼にはレベルがある
Claude Codeには権限の仕組みがあります。私は次のように分類しています。
| コマンドの種類 | 行動 |
|---|---|
ls, pwd, cat, grep, find
|
✅ 自由に許可（読み取りのみ） |
git status, git log, git diff
|
✅ 許可（gitの読み取りのみ） |
git commit -m "..." |
⚠️ メッセージをレビューしてから承認 |
npm install <package> |
⚠️ パッケージ名を先に確認 |
src/ 内のファイル書き込み |
⚠️ パスと内容を確認 |
rm, git push --force
|
❌ 意図がない限り常に拒否 |
curl, wget
|
❌ 常に拒否 — データ流出の危険 |
~/.ssh/, ~/.aws/ の操作 |
❌ 常に拒否 — 機密ディレクトリ |
CLIからツールアクセスを制限
# 読み取りと一部のgitコマンドだけ許可
claude --allowedTools "Read" "Bash(git *)"
7. 毎日使う3つのコンボ
| コンボ | ワークフロー | いつ |
|---|---|---|
/cost → /compact
|
チェック → 圧縮 | 定期メンテナンス（30分ごと） |
/clear → /init
|
リセット → 設定 | 新しいプロジェクトを始める時 |
/compact → 作業 → /cost
|
圧縮 → 続行 → 確認 | 長い作業セッション |
新しいプロジェクトのセットアップ
cd my-project
claude # セッション開始
/init # CLAUDE.mdを作成
# 上の6つのセクションでCLAUDE.mdを編集
/cost # 初期使用量をチェック
長いセッションのプロトコル
# 20〜30分ごと:
/cost # コンテキストをチェック
# コンテキストが50〜70%の時:
/compact # スペースを解放し、タスクのコンテキストを保持
# 関係ないタスクに切り替える時:
/clear # 完全にリセット
8. 小さなコツ — でも時間を節約できる
入力ショートカット
| 方法 | 何をするか |
|---|---|
\ + Enter |
改行（複数行入力） |
Shift+Enter |
改行（/terminal-setup実行後） |
! npm test |
Bashモード — AIが介入せずにシェルコマンドを実行 |
@src/utils/auth.js |
ファイルを参照、Tabで自動補完 |
Ctrl+V |
クリップボードから画像を貼り付け |
最も重要なキーボードショートカット
| ショートカット | 効果 |
|---|---|
Escape |
現在のターンを中断 — セッションとコンテキストはそのまま |
Escape × 2 |
Rewind — メッセージ選択メニューでundo |
Ctrl+C × 2 |
セッションを終了 |
Shift+Tab |
権限モードを切り替え（Normal → Auto-Accept → Plan） |
💡
Escapeは私が一番よく使うショートカットです。 AIが間違った方向に進んだら、Escapeで止めます — コンテキストは失われません。Ctrl+Cで再起動しないでください。
9. モデル選択 — いつも最強のモデルを使わない
| モデル | コスト | 用途 |
|---|---|---|
| Haiku | $ | フォーマット、タイポ修正、簡単な質問 |
| Sonnet | $$ | ほとんどのタスクのデフォルト — 機能、デバッグ、レビュー |
| Opus | $$$ | アーキテクチャ、複雑なデバッグ、セキュリティ、新しい問題 |
私の原則：
- デフォルト → Sonnet
- 簡単な修正 → Haiku
- アーキテクチャ、深い推論が必要 → Opus
セッション中は/model、CLIからはclaude --model sonnetで変更できます。
10. One-shotモードで自動化
あまり使われませんが、CI/CDで非常に強力な部分です。
# 自動化用のJSON出力
claude -p --output-format json "list all TODO comments in src/"
# agenticターン数を制限（無限ループを防ぐ）
claude -p --max-turns 3 "fix all lint errors"
# USDでコストを制限
claude -p --max-budget-usd 5 "refactor the auth module"
なぜ--max-budget-usdが大切か？ AIがループで実行し、コストが制御できなくなるのを防ぐからです。
まとめ
Claude Codeには多くのコマンドがあります。でもすべてを覚える必要はありません。
私が毎日使う15個のコマンド：
| グループ | コマンド |
|---|---|
| モード |
claude, claude -p, cat file | claude -p
|
| スラッシュ |
/init, /cost, /compact, /clear, /context, /model, /resume
|
| 入力 |
\ + Enter, !（bashモード）, @（ファイル参照） |
| キーボード |
Escape, Escape × 2, Shift+Tab
|
| CLIフラグ |
--model, --max-budget-usd, --allowedTools
|
最も重要な3つのこと：
-
コンテキスト管理 —
/costと/compactを頻繁に使う -
良い
CLAUDE.mdを書く — 1000語以下、6つのセクション -
秘密情報を守る — AIに
.envを絶対に読ませない
始めたばかりなら、まず上の3つに集中してください。他のコマンドは自然に覚えていきます。
最後に
ここまでお読みいただき、誠にありがとうございます。
もし**「システム開発を依頼したい」「技術的な相談をしたい」「AIを活用した課題解決のアイデアがある」** といったお悩みがございましたら、ぜひ私たちTOMOSIA VIETNAMにご相談ください。
私たちの主なサービス
- 💻 ソフトウェア受託開発（Web・アプリ・システム）
- 🤖 AIソリューション（チャットボット、画像処理、LLM応用）
- 📱 モバイルアプリ開発（iOS / Android）
- 🔌 Fintech / IoT開発
- 🔧 ブリッジSE（BrSE）支援（日本語でのコミュニケーションをスムーズに）
私たちの強み
- ISO/IEC 27001（情報セキュリティ）認証取得済み – 安心して任せていただけます
- 日本語対応チーム – 日本の文化・ビジネス習慣を理解したメンバーが直接対応
- 「Win-Win, Happy Together」の文化 – 長期的なパートナーシップを大切にします
🔗 公式サイト: tomosia.com
まずはお気軽に、一言ご連絡ください。私たちと一緒に、「ベトナムの知恵」で世界に挑戦しませんか？