Claude Code 基本的な使い方

この章では、Claude Code を日常開発で使う際に最もよく使う中核機能について説明します。Claude との対話方法、コードの読み取りと修正、コマンド実行、ファイル処理、そして効率を大幅に向上させる実用的なテクニックを含みます。

基本的な対話方法

1、インタラクティブモード（最もよく使う）

プロジェクトディレクトリで Claude Code を起動し、インタラクティブモードに入ると、質問や指示を直接入力できます：

cd /path/to/your/project
claude

インタラクティブモードでは、自然言語を直接入力するだけでよく、特別なフォーマットは必要ありません：

このプロジェクトは何をするものですか？

帮我找出 src/auth.ts 里的 bug

给 UserService 添加一个 getUserById 方法

用 @ファイルを指定することもできます。例えば、claude-test ディレクトリに test.html があるとします。

claude-test に入ってみましょう：

cd claude-test

そして質問します：

@test.html 这个文件是干嘛的

2、単発タスクモード

1つのタスクだけを実行する場合、インタラクティブモードに入る必要はなく、コマンドの後ろにタスクの説明を直接付けられます：

claude "解释一下 package.json 里的 scripts 字段"

実行が完了すると自動的に終了するため、シェルスクリプトでの使用やクイックな問い合わせに適しています。

3、単一クエリモード（-p）

使用する-pパラメータを指定して一度きりのクエリを実行します。Claude の回答はターミナルに直接出力されるため、他のコマンドと組み合わせて使うのに適しています：

claude -p "这段代码有什么问题" < src/utils.ts

# 将 Claude 的分析结果保存到文件
claude -p "分析项目依赖的安全风险" > security-report.md

4、前回の会話を続行（-c）

Claude Code は会話履歴を保存します。使用-cパラメータを使うと、現在のディレクトリで直近の未完了の会話を続行でき、コンテキストを再構築する必要はありません：

claude -c

コードの理解と分析

1、プロジェクト全体の把握

初めてのプロジェクトに入ったときは、まず Claude に全体分析をさせることができます：

このプロジェクトのアーキテクチャはどのようになっていますか？

プロジェクトで使用している主要な技術と依存関係は何ですか？

プロジェクトのディレクトリ構造を紹介してください

Claude Code はプロジェクトのファイルを自動的に読み取って分析します。読み取るファイルを手動で指定する必要はありません。参照すべき内容を Claude 自身が判断します。

2、特定のファイルやモジュールの分析

解释一下 src/middleware/auth.ts 的工作原理

UserRepository 类里有哪些方法？分别是做什么的？

这个 SQL 查询语句是什么意思？

3、コードの呼び出しチェーンの追跡

ユーザーがログインする際のコードの実行フローはどうなっていますか？エントリーポイントからデータベースまですべて列挙してください

findUserByEmail 这个函数在哪里被调用？

このインターフェースのデータは最終的にどのデータベーステーブルに保存されますか？

4、複雑なロジックの理解

この再帰関数はどういう意味ですか？例を挙げて説明してもらえますか？

为什么这里要用 useCallback？不用会怎样？

この正規表現はどのような形式の文字列にマッチしますか？

コードの修正

1、新機能の追加

必要な機能を説明すると、Claude が適切な場所を見つけて実装します：

在 UserService 里添加一个 updatePassword 方法，需要验证旧密码

给登录接口添加请求频率限制，同一 IP 每分钟最多 5 次

创建一个 formatCurrency 工具函数，支持传入货币代码参数

2、バグの修正

問題の症状を説明すると、Claude が原因を特定し、修正案を提示します：

ユーザーがログアウトした後、ページをリフレッシュしてもログイン状態のまま表示されます。原因を特定して修正してください

この関数は入力が空の配列の場合にエラーになります。修正してください

控制台报错 "Cannot read properties of undefined (reading 'map')"，帮我定位并修复

3、コードのリファクタリング

把这个 500 行的组件拆分成更小的子组件

将 callback 风格的异步代码改为 async/await

これらの関数には大量の重複コードがあります。共通関数に抽出してください

4、変更内容の確認

Claude Code はファイルを変更する前に必ず diff を表示して確認させます。Claude が修正案を提示した後に議論することができます：

コードはまだ変更しないで、どのように修正する予定かだけ教えてください

先ほどの修正には問題があります。並行処理に対応していません。やり直してください

这个方案可以，但把函数名改成 validateUserCredentials

Claude Code はファイルを変更する前に必ず変更内容を表示し、確認を求めます。次のいずれかを選択できます。受け入れる（yes）、拒否する（no）または、確認する前に議論を続けることもできます。すべての変更を一度に受け入れなければならないと思う必要はありません。まず確認して、問題がなければ承認してください。

コマンドとテストの実行

1、Claude にコマンドを実行させる

Claude Code はターミナルで直接コマンドを実行できます。やりたいことを自然言語で説明するだけです：

テストを実行して、失敗があるか確認してください

安装 dayjs 这个依赖

プロジェクトをビルドして、エラーが発生していないか確認してください

Claude はプロジェクト設定（例：package.json内の scripts やCLAUDE.md内のコマンド）に基づいて、正しいコマンドを選択して実行します。

2、特定のテストを実行

运行 auth 模块的测试

すべてのテストを実行し、カバレッジレポートを生成してください

このテストはなぜ失敗しましたか？修正してください

3、コマンド出力の確認

Claude はコマンド出力をコンテキストとして使用し、出力内容に基づいて次のアクションの提案を直接行います：

运行 npm run build，如果有报错帮我修复

跑一下 lint，把所有警告都修复掉

ファイル操作

1、新しいファイルの作成

创建 src/utils/date.ts，实现日期格式化相关的工具函数

新建一个 Docker Compose 配置文件，包含 PostgreSQL 和 Redis 服务

创建 .github/workflows/ci.yml，配置 GitHub Actions 自动运行测试

2、ファイルとコンテンツの検索

プロジェクトにファイルアップロードを処理するコードはありますか？どこにありますか？

哪些地方用到了 localStorage？

找出所有使用了 console.log 的文件

3、一括変更

把所有文件里的 http://api.example.com 替换成 https://api.example.com

把 src/components/ 下所有组件的 PropTypes 改为 TypeScript 类型定义

给 src/api/ 目录下所有接口函数添加 JSDoc 注释

Git 操作

Claude Code は Git と深く統合されており、自然言語でほぼすべての Git 操作を実行できます。

1、変更の確認

どのファイルを変更しましたか？

今回の変更の内容は何ですか？

最近 10 次提交都改了什么？

2、コードのコミット

今回の変更をコミットしてください

把这次的修改提交，commit 信息说明修复了登录验证的 bug

Claude は実際の変更内容に基づいて、規約に沿ったコミットメッセージを自動生成します。ショートカットコマンドも使用できます：

claude commit

3、ブランチ管理

新建一个 feature/user-profile 分支

切换到 develop 分支

把 main 分支的最新改动合并进来

4、マージコンフリクトの処理

マージコンフリクトの解決を手伝ってください

このファイルにコンフリクトがあります。どのバージョンが正しいか確認してください

コンテキスト管理のコツ

1、ファイルを手動で指定

使用@ファイルパス構文を使うと、Claude にどのファイルを参照すべきかを明確に伝えられ、推測を避けられます：

参考 @src/types/user.ts 里的类型定义，给 UserService 添加类型注解

对照 @docs/api-spec.md 里的规范，检查接口实现是否符合要求

2、コンテキストをクリア

会話が長時間にわたった場合や、まったく異なるタスクに切り替える場合は、コンテキストをクリアしてやり直すことをお勧めします：

/clear

クリアすると Claude の「記憶」は初期状態に戻り、新しいセッションは以前の会話内容の影響を受けません。

3、コンテキストの圧縮

Claude が以前の内容を「忘れ」始めたと感じる場合や、会話が長くなった場合は、コンテキストを圧縮できます：

/compact

これにより、Claude は現在の会話内容を簡潔な要約にまとめ、コンテキストのスペースを解放しつつ、重要な情報を保持して作業を続けられます。

4、タスクの適切な分割

複雑なタスクは一度にすべて説明せず、いくつかのステップに分けて段階的に進めると効果的です：

❌ 悪い例：Claude にあまりにも多くの要求を一度に投げる：

"ユーザーモジュール全体のリファクタリングを手伝ってください。型アノテーションの追加、ファイルの分割、データベースクエリの最適化、キャッシュの追加、テストの作成、ドキュメントの更新を含みます"

✅ 良い例：論理的な順序で独立したステップに分割する：

第一步："分析 src/user/ 目录的现有结构，告诉我有哪些问题"
第二步："先给所有函数添加 TypeScript 类型注解"
第三步："把超过 200 行的文件拆分成更小的模块"
第四步："优化数据库查询，添加必要的索引"

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

インタラクティブモードで、入力/と入力すると、利用可能なすべてのコマンドのリストが表示されます。以下は最もよく使うスラッシュコマンドです：

実用的なテクニック

1、まず Claude に分析させてから実行する

複雑な問題に直面したら、まず Claude に方針を説明させ、方向性が正しいことを確認してから実行します：

コードは変更しないで、まずログイン失敗の可能性のある原因を分析し、調査手順を列挙してください

この機能をどのように実装する予定ですか？まず実装案を説明してください。確認後にコードを書きます

2、エラーメッセージとログを提供する

エラーが発生した場合は、エラーメッセージをそのまま会話に貼り付けてください。Claude がエラー内容に基づいて問題を特定します：

运行时报了这个错误，帮我分析原因：
TypeError: Cannot read properties of null (reading 'userId')
    at getUserProfile (src/services/user.ts:42:18)
    at async ProfileController.getProfile (src/controllers/profile.ts:15:20)

3、スクリーンショットで UI の問題を説明する

Claude Code はマルチモーダル入力をサポートしており、スクリーンショットを直接会話に貼り付けて、UI関連の問題を説明できます：

[スクリーンショット貼付] このボタンをクリックしても反応がありませんが、コンソールにエラーはありません。調査を手伝ってください

[粘贴设计稿截图] 按照这个设计实现 Header 组件

4、「続行」をうまく使う

Claude の回答が途中で切れた場合、またはまだ言い終わっていないと感じた場合は、「続けて」と言うだけでOKです：

続けてください

他にもありますか？

残りの部分も実装してください

5、変更内容の説明を求める

重要なコードの変更については、Claude に各変更箇所の理由を説明するよう求めることができます：

修正が完了したら、各変更の目的を説明してください

这里为什么要用 Promise.allSettled 而不是 Promise.all？

6、Claude の操作範囲を制限する

Claude に他のファイルを勝手に変更してほしくない場合は、範囲を明確に限定できます：

只修改 src/auth.ts 这一个文件，不要改其他地方

コードを読むだけで変更しないでください。このモジュールのパフォーマンスボトルネックを分析してください

一般的なワークフロー例

ワークフロー1：新規プロジェクトを素早く把握する

ワークフロー2：バグを修正する

ワークフロー3：新機能を追加する

ワークフロー4：コードレビュー

# 审查特定文件
> 帮我审查 src/payment/processor.ts 这个文件，
> 重点关注错误处理、边界情况和安全风险

# 审查 git 改动
> 审查我这次的所有改动，看看有没有明显的问题

# 针对性检查
> 这段代码有没有 SQL 注入的风险？

注意事項

ファイル変更について：Claude Code は変更前に diff を表示して確認を求めます。考えなしにすべて受け入れないでください。特にコアロジックに関わる変更は、diff の内容をよく読んでから受け入れるかどうかを判断してください。

機密ファイルについて：にCLAUDE.md 或 .claude/settings.jsonおいて、Claude が読み取りまたは変更できないファイルを明確に指定します（例：.env、キーファイルなど）、意図しない情報漏えいを防ぎます。

大規模なタスクについて：1つの会話に未完了のタスクを溜めすぎないようにしてください。Claude が焦点を失いやすくなります。1つのタスクを完了してから次のタスクを開始するか、/clearを使用して最初からやり直してください。

コード品質について：Claude が生成したコードは常に最適な解決策とは限りません。重要なモジュールについては、実行完了後に code review を行うことをお勧めします。各変更の目的を理解し、プロジェクトの設計原則に適合していることを確認してください。