Claude Code：Anthropic AIプログラミングアシスタント完全ガイド

Claude Code は Anthropic 推出のエージェント式 AIプログラミングアシスタント，直接でターミナル中実行する，している変革する開発者编写、デバッグと維持するコードの方式。と驻留で IDE 内の传统 AI コード补全ツール異なる，Claude Code 采用たエージェントアプローチ：それ理解するあなたの全体の项目，実行するコマンド，編集するファイル，甚至管理する git 操作する——すべてを通じて当然言語正话完了する。本包括的ガイドカバーたから初始設定するまで加速する開発するストリーム程の高级ワークフロー，ヘルプあなた精通 Claude Code の一切。

とは Claude Code？

エージェント特徴：それだけでなく仅は提案するコード补全，そしては正任务入行推理，計画多步骤解决方案，かつもって最も少の人工乾预実行する。

Claude Code の核心実行するで読み取る-求值-出力する循环（REPL）モデル上。あなた用当然言語説明するしたいする必要がある完了するの目标，Claude Code できる分析するあなたのコードライブラリ，提出方案，かつ実行する工作。それ読み取るファイルもって理解するコンテキスト，编写または変更するコード，実行するテストするもって検証する正しく性，かつ迭代直まで任务完了する。これ種類エージェントワークフロー大幅減らすたで重构、テスト作成、修正 bug と生成ドキュメントなど日常開発する任务上花费の時間。

Claude Code のコンテキスト感知は其最も強力の機能の一つ。を通じてインデックス项目ファイル，それ構築するた正コードライブラリアーキテクチャ、依赖リレーション、エンコードする仕様甚至テストするフレームワークの包括的理解する。これは以下を意味します Claude Code いいえで孤立ファイル上操作する——それ理解する一つのファイル中のより改どのように影響する项目的其余部分的に，これさせる其で大规模重构と横切注目する点側面を持つできないの代わりに代の价值。

Claude Code 始める

設定する Claude Code 非常に簡単，だけ需いくつ分。あなた必要とする系统上インストールするた Node.js，一つの Anthropic API キー，ならびに一つのターミナル。させる私たち段階的に理解するインストールすると設定するたことがある程。

インストールする

claude コマンド可から任意のターミナルできる话中使用：

npm install -g @anthropic-ai/claude-code

インストールする完了する後，を通じて確認するバージョン来検証する Claude Code はいいえ正しくインストールする：

claude --version

もしあなた看までバージョン号，説明インストールする成功。该包を含むすべての必する必要があるの依赖项，あなた已準備はいいですか入行認証。

認証

Anthropic 制御する台获取一つの。獲得する API キー後，あり两種類認証方式：

1. 環境変数（推奨する）：で shell 設定ファイル中設定する ANTHROPIC_API_KEY 環境変数，に使用される持久認証。
2. 初回実行ヒント：でターミナル中実行する claude，それできるヒントあなたインタラクティブ入力する API キー。

# Set API key as environment variable (add to ~/.bashrc or ~/.zshrc for persistence)
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxxx"

に対して团队環境，考慮する使用キー管理する器または CI/CD 平台の環境変数設定する来安全に注入 API キー，そしてなし需硬エンコードする。

初回実行

でターミナル中ナビゲーションまで任意の项目目次かつ起動する Claude Code：

cd my-project
claude

初回実行时，Claude Code できるインデックスあなたの项目ファイルもって構築するコンテキスト。此たことがある程できる扫描目次结构，読み取る設定ファイル，かつ構築する正コードライブラリの理解する。に対して大型项目，これかもしれない必要とするいくつ秒。インデックス完了する後，あなたする看まで Claude Code ヒント符，できる直ちに使用当然言語と之交互。

コア機能

Claude Code 提供するた丰富の機能集，远超簡単のコード生成。毎项機能すべてを目的とする支持する真实の開発するワークフロー。

ターミナルベースのインターフェース

Claude Code 完全実行するであなたのターミナル中，これは以下を意味しますそれと现ありのに基づく shell のワークフローなし缝統合する。なし需切り替えるまで異なるの編集する器または GUI。あなたできるする Claude Code と vim、neovim、tmux または任意の其彼ターミナルツール一起使用。ターミナル界面支持する丰富のフォーマットする、コード块中の構文ハイライトするならびに確認のインタラクティブヒント。なぜならそれでターミナル中実行する，Claude Code できるを通じて SSH、で Docker コンテナ中と远程サーバー上工作——任意のあなたあり shell のに方。

REPL 式の交互モデルを意味するあなたで全体のできる话中と Claude Code 保持正话。あなたできる提出後续问题，要件変更する前にの工作，かつで解决複雑问题时段階的に構築するコンテキスト。

マルチファイル編集

Claude Code の突出できる力の一つはで単个操作する中編集する多个ファイル。時にあなた要件 Claude Code 実装する一つの跨多个ファイルの機能时——例えば追加する一つの新規の API エンドポイント，必要とするより改ルーティングハンドラー、服务层、データベースモデルとテストする——それできるで一つの连贯の操作する中計画と実行するすべてのより改。これ消を除いて逐个編集するファイルの繁琐来回，かつ確保するコードライブラリの一貫性。

Claude Code で適用するより改前にできる表示するすべての提案するより改の diff，させるあなたあり机できるレビューする、受け取るまたは拒否する変更する。此レビューする步骤に対して維持するコード质量と確保する AI の出力する適合するあなたの意图非常に重要です。

Git統合

Claude Code と git 奥行き統合する，するバージョン管理と見なす開発するワークフローの一など公民。時に Claude Code 完了する任务时，それできる自动暂存より改のファイルかつ作成するあり意义の送信メッセージ，説明するより改た何么ならびになぜより改。仅此機能すぐにできる节省大量の時間，かつ確保するあなたの git 历史保持明確にと情報丰富。

を除いて送信以外，Claude Code まだできる作成すると切り替えるブランチ、查看 diff、解决マージコンフリクトならびに理解する项目的完全 git 历史。あなたできる问诸如"表示する最も近三次送信中より改た何么"または"のためにこの機能作成する一つの新規ブランチかつ送信より改"などの问题，Claude Code できるのためにあなた処理する git 操作する。

# Claude Code can generate commit messages like:
git commit -m "refactor: extract authentication logic into dedicated middleware

- Move JWT verification from route handlers to auth middleware
- Add token refresh logic in separate utility module
- Update tests to cover new middleware and utility functions
- Remove duplicate auth code from three route handlers"

プロジェクトコンテキスト認識

Claude Code 構築するた超越ファイル内容の项目丰富インデックス。それ理解するあなたの依赖图、インポートする结构、設定ファイル、テストする設定する、コード確認する规すなわちとエンコードする仕様。時にあなた要件 Claude Code 入行より改时，それできる参照これらのコンテキストもって確保する其出力すると现ありコードライブラリ一致。例えば，もしあなたの项目使用有効化た严格パターンの TypeScript，Claude Code する生成適切にタイプのコード。もしあなた使用 Jest 入行テストする，それするもって Jest 構文テスト作成，そしていいえ Mocha または Vitest。

CLAUDE.md ファイル，へ Claude Code 提供するについてあなたの設定、エンコードする標準、アーキテクチャ决策と任意のカスタマイズする约定の明確にディレクティブ。此ファイル充時に Claude Code で毎回できる话中引用するの持久系统ヒント。

Bashコマンド実行

により Claude Code でターミナル中実行する，それできる直接実行する bash コマンド。これは以下を意味しますそれできる実行するテストする套件、実行する構築するコマンド、インストールする依赖、起動する開発するサーバーならびに実行する開発する期间所需の任意の其彼 shell コマンド。Claude Code 使用コマンド出力する来検証する其工作——例えば，编写コード後それできる実行するテストする套件もって確認すべてのテストするを通じて，もしあり任意の失敗，それできる分析するテストする出力するかつ自动修正问题。

画像とファイル分析

Claude Code 支持するする图のようなと各種類ファイルタイプとして其コンテキストの一部分的に入行分析する。あなたできるを含む UI 設計するの截图、間違いメッセージまたは图表，Claude Code できる解读それ们もって指导コード生成。それまだできる読み取ると分析する CSV ファイル、ログファイルと其彼データフォーマット，もってヘルプデバッグとデータ処理する任务。

主要コマンドとワークフロー

Claude Code 提供するた多个コマンド来管理するできる话、制御するコンテキストかつ十分に利用该ツール。掌握これらのコマンドするさせるあなたのワークフローより一層効率的。

/init を使ったプロジェクト設定

/initCLAUDE.md ファイル。此ファイルとして持久ディレクティブ，Claude Code で毎回できる话開始する时読み取る，確保するすべての交互の一貫性。

# Run this once when setting up Claude Code for a project
claude
> /init

CLAUDE.md かもしれないを含むあり閉あなたの技术スタック、エンコードする仕様、首选ライブラリ、テストするフレームワーク、アーキテクチャパターンならびにについてあなた希望する Claude Code 行のために方式の任意の特定ディレクティブの情報。あなたできる随时手动編集する此ファイルもって追加するまたは最適化するディレクティブ。

/clear と /compact を使ったコンテキスト管理

随ているあなた使用 Claude Code，正话できる积累コンテキスト——あなたのプロンプト、Claude Code の対応、ファイル内容とコマンド出力する。これらのコンテキストとてもあり价值，なぜならそれさせる Claude Code 正あなたしている入行の任务あり深い理解，しかしそれもできる消耗 token。時に接近 token 制限する时，あなたあり两个選択する：

• /compact：此コマンド智できるに圧縮する正话，予約最も相閉の情報，同時に丢弃不再必要とするの細节。時にあなた深く某个任务かつ希望するで不失う全体体コンテキストの情况下継続する时使用。
• /clear：此コマンド完全リセット正话。時にあなた切り替えるまで全新規任务かつ前にのコンテキスト不再相閉时使用。

自然言語コード生成

と Claude Code 交互の主に方式はを通じて当然言語プロンプト。あなた説明するしたいする必要がある完了するの目标，Claude Code 計画かつ実行する任务。もって下は有効プロンプトの例：

# Bug fix
"Fix the race condition in the user session handler that causes duplicate sessions"

# Feature implementation
"Add a rate limiter middleware that limits requests to 100 per minute per IP address"

# Refactoring
"Refactor the payment processing module to use the strategy pattern for different payment gateways"

# Testing
"Write comprehensive unit tests for the UserService class covering all edge cases"

# Documentation
"Generate JSDoc comments for all public methods in the API module"

Claude Code 解读これらのプロンプト，分析するコードライブラリの相閉部分的に，かつ実行する必する必要があるのより改。あなたできるリアルタイム观察其入度，を含む読み取るファイル、编写コードと実行するコマンド。

Claude Code ベストプラクティス

する必要がある十分に利用 Claude Code，请従う经验丰富の用户を通じて大量の使用まとめ出のこれらのベストプラクティス。

明確で具体的なプロンプトを書く

とすべての AIツール一样，Claude Code で獲得する明確に具体的のディレクティブ时できる生み出すより良の結果。不する必要があるだけ说"修正 bug"，そしては詳細説明する bug：あなた观察までの行のために、あなた期望の行のためにならびに问题かもしれない出でコードライブラリのどの位置。あなた提供するのコンテキスト越多，Claude Code すぐに越できる正確にに识别と修正问题。考慮するでプロンプト中を含むファイル路径、函数名、間違いメッセージ甚至ヒープスタック跟踪。

CLAUDE.md を活用したプロジェクト指示の管理

CLAUDE.md ファイルは確保する Claude Code 従う项目约定の最も強力ツール。请で其中填充：

• 技术スタック详情：使用の言語、フレームワークとバージョン。
• エンコードする风格：命名する约定、インデント設定とコード確認する规すなわち。
• アーキテクチャパターン：設計するパターン、フォルダ结构约定と注目する点分離する。
• テストする要件：テストするフレームワーク、オーバーライド率期望とテストするファイル约定。
• カスタマイズするディレクティブ：团队または项目特ありの任意の設定，例えば"常に使用 async/await そしていいえ .then() 链"または"で TypeScript 中絶対にしないでください使用 any タイプ。"

# Example CLAUDE.md content
# Project: E-Commerce Backend
# Stack: TypeScript, Express, PostgreSQL, Jest

- Use strict TypeScript with no implicit any
- Follow functional programming patterns; prefer pure functions
- All database queries go through repository classes
- Tests use Jest with supertest for HTTP testing
- API routes follow RESTful conventions
- Error handling uses custom AppError class with status codes
- Use zod for request validation
- Never commit secrets or API keys

コミット前にすべてのコードをレビュー

だが Claude Code できる力出众，しかしそれまだは AIツール，かもしれないできる犯誤。で受け取る提案するより改前に，务必レビューする diff。特に注意する安全敏感コード、ビジネスロジックとデータベース操作する。Claude Code の git 統合するを通じて正確に表示するより改内容と自动生成送信メッセージさせるレビューする变て簡単，しかし最も终のレビューする责任で于あなた——開発者。

Claude Code と他のツールの使い分け

Claude Code で某些タイプの任务上表现出色，そしてで其彼任务上すなわち不あまりにも適合する。もって下はヘルプあなた選択する正しくツールのガイド：

セキュリティと機密データの管理

Claude Code を通じて Anthropic の API 処理するあなたのコード，これは以下を意味しますあなたのコードできるられる送信するまで外部サーバー。请従うこれらの安全实践：

• 絶対にしないでくださいでプロンプトまたは Claude Code 読み取るのファイル中を含む API キー、パスワードまたは机密。
• 使用 .gitignore と環境変数処理する敏感設定する。
• 注意する专ありコード——理解するあなた所で组织について AI支援開発するの政策。
• レビューするすべての生成のコードはいいえ存で安全脆弱性，如 SQL 注入、XSS または安全でないの暗号化する。
• 考慮する使用 .claudeignore ファイル来防止する Claude Code 読み取る敏感目次またはファイル。

一般的なユースケース

Claude Code で広くの開発する任务中表现出色。もって下はそれ带来显著生产力向上させるの最も一般的なユースケース。

バグ修正とデバッグ

Claude Code でデバッグ側面非常に有効。説明するあなた观察までの症状，共有間違いメッセージまたはヒープスタック跟踪，Claude Code する追跡するあなたのコードライブラリもって识别根本理由。なぜならそれできる実行するコマンド，それまだできる実行するあなたのアプリケーション，观察実行する时行のために，かつ迭代修正问题。に対して跨多个ファイルまたは含むレースコンディションと非同期行のためにの複雑 bug，Claude Code 理解する完全コードライブラリコンテキストのできる力はなし价の。

コードリファクタリング

大规模重构は Claude Code 最も強のユースケースの一つ。あなたできる要件それ重构モジュール、する共享逻辑提取までツール函数中、から一種のパターンマイグレーションまで另一種のパターン，または更新する全体のコードライブラリもって使用新規の API。Claude Code 理解する跨ファイル依赖リレーション，かつ確保するすべての引用する一致更新する。例えば，あなたできる要件："重构すべてのデータベースクエリするもって使用新規のコネクションプールそしていいえ作成する単独の接続する"，Claude Code する見つける各受影響するのファイルかつ入行より改。

テスト作成

Claude Code 擅長生成包括的のテストする套件。それ読み取るあなた现ありのテストするファイルもって理解するあなたのテストするフレームワークと约定，それから生成従う同じパターンのテストする。それできる编写ユニットテスト、統合テストとエンドツーエンドテスト。テストの生成後，それできる実行するそれ们かつ自动修正任意の失敗，迭代直まですべてのテストするを通じて。これに対して缺乏十分なテストするオーバーライドの遗留コードライブラリ特にあり价值。

ドキュメント生成

生成と維持するドキュメントだが繁琐しかし非常に重要です。Claude Code 可思う全体のコードライブラリ生成 JSDoc、TSDoc または Python docstrings，作成する README ファイル，编写 API ドキュメント，ならびに生成更新するログ。それ読み取るあなたのコードもって理解する各函数の機能，かつ生成従う项目约定の正確に、ドキュメント质量高のドキュメント。

コードレビュー支援

で送信プルリクエストする前に，あなたできる要件 Claude Code レビューするあなたのより改。それする识别潜で bug，提案する改入，確認するとコードライブラリ约定の一貫性，かつマークする安全问题。あなたできるする此として预レビューする步骤，で人工レビューする者花费時間前に捕获问题，させる全体の团队のコードレビューストリーム程より一層効率的。

する Claude Code 統合するまであなたのワークフロー

する必要がある真正から Claude Code 中受益，请する其統合するまで日常開発するワークフロー中，そしていいえする其と見なす新規鲜事物。もって下は多くの開発者采用の实用ワークフロー：

1. 毎回できる话すべてで編集する器旁边のターミナル中開く Claude Code。する其として随时利用可能のペアプログラミング伙伴。
2. 各项目使用一次 /init，かつで项目演入时維持するあなたの CLAUDE.md。
3. する重复性任务委派に Claude Code，如ボイラープレートコードの作成、テストの生成と更新するドキュメント。
4. 使用 Claude Code 入行コード探索する——要件それ説明する特定モジュールの工作原理または追跡する複雑のデータストリーム。
5. 送信前レビューするあなたの diff——Claude Code 生成送信メッセージ，しかしあなた应常にレビューするより改。
6. 使用 /compact 入行迭代——に対して長時間実行するの任务，使用 /compact 保持コンテキスト可控そして不失う线索。