Claude Code CLI: 必須のコマンドと設定
クロード・コードは単なる AI アシスタントではありません。 強化された端子 統合する 開発者の日常のワークフローで。コマンドラインから、ファイルを管理したり、実行したりできます。 ビルド、テストの起動、コードの分析、複雑なタスクの調整など、 プロジェクトのコンテキストを理解する会話型インターフェイス。
シリーズ 12 回目のこの記事では、 コマンドラインインターフェース クロード・コード著：各プラットフォームでのインストール方法、キーボードショートカット 作業を高速化する、エージェントを制御するためのスラッシュコマンド、階層構造 4 レベルの構成、セキュリティ、およびモード許可テンプレート CI/CD 自動化のためのヘッドレス。
何を学ぶか
- macOS、Linux、Windows、WSL に Claude コードをインストールする
- キーボードショートカットをマスターしてワークフローをスピードアップしましょう
- 利用可能なすべてのスラッシュ コマンドを使用する
- 4 レベルの構成階層を理解する
- さまざまなセキュリティ シナリオに合わせて権限テンプレートを構成する
- CI/CD パイプラインのヘッドレス モードでクロード コードを実行する
- 一般的なインストールおよび構成の問題のトラブルシューティング
- 日常業務向けに CLI エクスペリエンスを最適化する
シリーズ全体の概要
| # | アイテム | 集中 |
|---|---|---|
| 1 | テクニカルパートナーとしてのクロード | セットアップと最初のステップ |
| 2 | プロジェクトのコンテキストとセットアップ | CLAUDE.mdと設定 |
| 3 | コンセプトと要件 | MVP とユーザーペルソナ |
| 4 | バックエンドとフロントエンドのアーキテクチャ | Spring Boot と Angular |
| 5 | コードの構造 | 組織と規約 |
| 6 | 高度なエンジニアリングプロンプト | 高度なテクニック |
| 7 | テストと品質 | 戦略とテストの生成 |
| 8 | 専門的な文書 | README、API、ADR |
| 9 | デプロイとDevOps | Docker、CI/CD、モニタリング |
| 10 | 進化と維持 | リファクタリングとスケーラビリティ |
| 11 | 実際のプロジェクトの統合 | クロード・コードの運用中 |
| 12 | Claude Code CLI (ここにいます) | コマンドと設定 |
| 13 | エージェントのスキル | モジュール機能 |
| 14 | 専門のサブエージェント | 特定の役割を持つエージェント |
| 15 | フックと自動化 | イベント駆動型のワークフロー |
| 16 | ラルフ・ウィガム法 | テスト駆動開発 |
| 17 | BMAD法 | 構造化されたプロジェクト管理 |
| 18 | マルチエージェントオーケストレーション | エージェントパイプライン |
| 19 | 共同作業 | チームおよびペアプログラミングAI |
| 20 | セキュリティとベストプラクティス | 強化とコンプライアンス |
| 21 | 監視と可観測性 | メトリクスとデバッグ |
1. クロードコードのインストール
Claude Code は、複数のプラットフォームとインストール方法をサポートしています。方法の選択
それは、オペレーティング システムと個人の好みによって異なります。すべての方法で同じようにインストールされます
バイナリ claude これはシステム PATH に追加されます。
前提条件
インストールを続行する前に、次の要件が満たされていることを確認してください。 システム上:
システム要件
| 要件 | 最小バージョン | 注意事項 |
|---|---|---|
| Node.js | 18.0+ | JavaScript ランタイムに必須 |
| npm | 9.0+ | Node.jsに含まれています |
| Git | 2.30+ | リポジトリ操作の場合 |
| オペレーティング·システム | macOS 12 以降、Ubuntu 20.04 以降、Windows 10 以降 (WSL2) | Linux および macOS のネイティブ サポート、Windows 用の WSL |
| 人間のアカウント | プロ、マックス、またはチームプラン | API認証に必要 |
方法 1: npm 経由でインストールする (推奨)
最も汎用的な方法は、npm によるグローバル インストールです。それらすべてに機能します Node.js が利用可能で簡単な更新が保証されるプラットフォーム。
# Installazione globale
npm install -g @anthropic-ai/claude-code
# Verifica installazione
claude --version
# Primo avvio e autenticazione
claude
# Aggiornamento alla versione più recente
npm update -g @anthropic-ai/claude-code方法 2:curl によるインストール (macOS および Linux)
npm を避けたい場合は、直接インストール スクリプトを使用できます。 これにより、プリコンパイルされたバイナリがダウンロードされます。この方法は特に便利です Node.js がプリインストールされていない環境では。
# macOS e Linux
curl -fsSL https://cli.anthropic.com/install.sh | sh
# Verifica che il binario sia nel PATH
which claude
# Output atteso: /usr/local/bin/claude
# Prima esecuzione
claude方法 3: Homebrew によるインストール (macOS)
Homebrew をパッケージ マネージャーとして使用する macOS ユーザーはインストールできます 公式タップによるクロード・コード。このメソッドはクロード コードを補完します。 Homebrew パッケージの一元管理。
# Aggiungere il tap ufficiale Anthropic
brew tap anthropics/claude-code
# Installazione
brew install claude-code
# Aggiornamento
brew upgrade claude-code
# Verifica versione
claude --version方法 4: Windows へのインストール (PowerShell + WSL)
Windows では、Claude Code を実行するには WSL2 (Windows Subsystem for Linux) が必要です 正しく。インストールはPowerShellから直接実行できます Windows の、または WSL ターミナル内から。
# Passo 1: Installare WSL2 (se non già installato)
wsl --install
# Passo 2: Aprire il terminale WSL (Ubuntu)
wsl
# Passo 3: Installare Node.js nel WSL
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# Passo 4: Installare Claude Code
npm install -g @anthropic-ai/claude-code
# Passo 5: Verificare
claude --version
# Alternativa: Installazione diretta da PowerShell
# (Richiede Node.js installato su Windows)
npm install -g @anthropic-ai/claude-codeWindows の互換性に関する注意事項
Windows 上の Claude Code は、多くの開発ツールがあるため、WSL2 で最もよく動作します。 (Git、コンパイラ、ビルド ツール) は Linux でネイティブにサポートされています。仕事をしていれば Unix のようなツールを必要とするプロジェクトでは、WSL2 を強くお勧めします。 ネイティブ PowerShell エクスペリエンスはサポートされていますが、制限がある場合があります いくつかのシステムコマンドを使用します。
認証
インストール後の最初の起動 claude 認証フローを開始します。
Claude Code は 2 つの主要な認証方法をサポートしています。
認証方法
| 方法 | 使用 | 構成 |
|---|---|---|
| 人間のコンソール | 個々の Pro/Max アカウント | 初回起動時の自動ブラウザログイン |
| APIキー | アカウント チーム、エンタープライズ、CI/CD | 環境変数 ANTHROPIC_API_KEY |
| AWS の基盤 | AWS インフラストラクチャ上のエンタープライズ | AWS認証情報の構成 |
| Google バーテックス AI | GCP インフラストラクチャ上のエンタープライズ | Google Cloud 認証情報の構成 |
# Metodo 1: Variabile d'ambiente (sessione corrente)
export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"
# Metodo 2: File .env nella root del progetto
echo 'ANTHROPIC_API_KEY=sk-ant-api03-xxxxx' >> .env
# Metodo 3: Configurazione permanente in .bashrc o .zshrc
echo 'export ANTHROPIC_API_KEY="sk-ant-api03-xxxxx"' >> ~/.zshrc
source ~/.zshrc
# Verifica autenticazione
claude --print-auth-status2. キーボードショートカット
クロード コードを効率的に使用するには、キーボード ショートカットが不可欠です。 それらを理解すると、動作モードをすばやく切り替えてコンテキストを管理できるようになります。 作業リズムを中断することなく、実行の流れを制御します。
完全なショートカット表
| ショートカット | アクション | 詳細な説明 |
|---|---|---|
! |
バッシュモード | ダイレクト Bash モードを有効にします。タイプ ! 続いてコマンド
クロードがそれをプロンプトとして解釈せずにターミナルで実行します。
例： !npm test テストを直接実行します。 |
@ |
ファイル/フォルダーについての言及 | ファイルまたはフォルダーをメンションして、現在のコンテキストに追加します。
Tab によるオートコンプリートをサポートします。例： @src/app/services/
フォルダー全体をコンテキスト内で読み込みます。 |
Esc |
割り込み | クロードの現在の動作を停止します。世代のときに役立ちます 間違った方向に進んでいるか、時間がかかりすぎています。 |
Esc + Esc |
巻き戻しメニュー | Esc キーを 2 回押すと、巻き戻しメニューが開き、次のことができます。 会話の前の状態に戻り、キャンセルします クロードの最後の行動。 |
Ctrl+R |
フル出力 | 最後に実行されたコマンドの完全な出力を表示します。 簡潔にするために一部が省略されている可能性があります。 |
Shift+Tab |
自動承認 (YOLO モード) | 取引の自動承認モードを有効にする その後。クロードはプロンプトを表示せずにアクションを実行します。 運用環境では注意して使用してください。 |
Shift+Tab+Tab |
プランモード | 計画モードをアクティブ化します。クロードは課題を分析し、 構造化された計画を作成し、承認のために提示します アクションを実行する前に。 |
Ctrl+C |
入力のキャンセル | 現在の入力に入力されたテキストをクリアします。 クロード・コードのセッションを中断します。 |
Ctrl+D |
出口 | 保存して現在のクロード コード セッションを閉じます。 会話の履歴。 |
Tab |
オートコンプリート | ファイル名、フォルダー、スラッシュコマンドのオートコンプリート 入力プロンプトで。 |
YOLOモード：使用方法と注意事項
YOLO (You Only Live Once) モードが有効になる Shift+Tab それはツールです
強力だが危険。アクティブな場合、クロードはすべての操作を実行します。
ファイルの変更、コマンドの実行、パッケージのインストール - なし
ユーザーに確認を求めます。
YOLO モードを使用する場合
- ラピッドプロトタイピング: 専用ブランチでアイデアを検討しているとき
- 自動リファクタリング: すでに計画を検証しており、迅速な実行が必要な場合
- ボイラープレートの生成: クロードが同様のファイルを多数作成する必要がある場合
- サンドボックス環境: Dockerコンテナまたは使い捨てVMで作業する場合
YOLO モードを使用しない場合
- 生産： メイン/マスター ブランチや運用環境では決して使用しないでください
- 破壊的な操作: タスクにファイルの削除が含まれる可能性がある場合
- システムコマンド: クロードが sudo でコマンドを実行できたとき
- 機密データ: コンテキストに資格情報または機密データが含まれている場合
計画モード: 構造化された計画
プランモード (Shift+Tab+Tab) は YOLO モードの逆です。彼はクロードに強制する
行動を実行する前に詳細な計画を立てること。計画には以下が含まれます:
- 要求されたタスクの分析と関連するファイルの特定
- 実行される順序付けされた操作のシーケンス
- 潜在的なリスクとオペレーション間の依存関係
- 編集するファイルの推定数
- 実行前に明示的に承認を要求する
# Attivare Plan Mode con Shift+Tab+Tab, poi scrivere il prompt:
> Aggiungi validazione email al form di registrazione
# Claude risponde con un piano:
# Piano di Esecuzione:
# 1. Leggere src/app/auth/register.component.ts
# 2. Leggere src/app/auth/register.component.html
# 3. Aggiungere validatore email al FormGroup
# 4. Aggiungere messaggio di errore nel template
# 5. Aggiungere test per la validazione email
# 6. Aggiornare il service di validazione
#
# File coinvolti: 4
# Operazioni: 6
#
# Procedere? [y/n]3. スラッシュコマンド
スラッシュ コマンドは、クロード コードの動作を制御する特別なコマンドです。
これらはプロンプトに直接入力され、その前に文字が付けられます。 /。すべてのコマンド
セッション、コンテキスト、構成を管理するための特定の機能があります。
完全なスラッシュコマンド表
| 指示 | 説明 | 使用例 |
|---|---|---|
/add-dir |
現在の作業コンテキストにディレクトリを追加します | /add-dir ../shared-libs 共有ライブラリを含めるには |
/agents |
ディレクトリ内の利用可能なサブエージェントを表示および管理します .claude/agents/ |
/agents 設定されているすべてのサブエージェントをリストするには |
/clear |
現在の会話の履歴をクリアし、コンテキストを解放します | /clear タスクを完了した後、掃除を開始します |
/config |
クロードコード設定ファイルを開いて編集します | /config 設定を表示および変更するには |
/help |
使用可能なコマンドの完全なガイドを表示します | /help 簡単な参照用に |
/mcp |
構成されたモデル コンテキスト プロトコル (MCP) サーバーを管理します | /mcp 接続されているサーバーのステータスを確認するには |
/model |
現在のセッションで使用されている AI モデルを変更する | /model claude-sonnet-4-20250514 ソネットに切り替えるには |
/permissions |
クロード・コードに付与された権限を表示および編集します。 | /permissions クロードができることを確認する |
/rewind |
会話の前の状態に戻る | /rewind 最新のアクションを元に戻すには |
/status |
現在のセッション状態、コンテキスト、トークンの使用状況を表示します。 | /status 使用されたトークンの数を確認するには |
スラッシュコマンドの高度な使用法
スラッシュ コマンドを論理シーケンスに組み合わせて管理できます。 複雑な作業セッション。ここでは、高度な使用パターンをいくつか紹介します。
# Pattern 1: Reset del contesto per un nuovo task
/clear
/add-dir ./src/features/new-feature
Implementa il componente UserProfile seguendo i pattern esistenti
# Pattern 2: Verifica stato prima di operazioni critiche
/status
/permissions
Esegui il refactoring del modulo di pagamento
# Pattern 3: Cambio modello per task specifici
/model claude-sonnet-4-20250514 # Per task rapidi e frequenti
Genera i test boilerplate per tutti i service
/model claude-opus-4-20250514 # Per task complessi
Analizza l'architettura e proponi miglioramenti
# Pattern 4: Debug di connessioni MCP
/mcp
# Verifica che i server necessari siano connessi
# prima di eseguire task che li richiedonoカスタムスラッシュコマンド
組み込みコマンドに加えて、Claude Code は以下の作成をサポートしています。 カスタムコマンド
ディレクトリ内のMarkdownファイル経由 .claude/commands/。各ファイル .md
セッション内で呼び出すことができるスラッシュ コマンドになります。
# Code Review Completa
Esegui una code review approfondita dei file modificati.
## Checklist
1. Verifica la correttezza logica del codice
2. Controlla naming conventions e coerenza
3. Identifica potenziali bug o edge case
4. Verifica la gestione degli errori
5. Controlla la copertura dei test
6. Valuta la performance e la scalabilità
## Output
Produci un report strutturato con:
- **Severita**: Critical / Major / Minor / Suggestion
- **File e riga**: Riferimento preciso
- **Problema**: Descrizione chiara
- **Soluzione**: Fix proposto con codice# Verifica Pre-Deploy
Prima di procedere con il deploy, controlla:
1. Esegui `npm run build` e verifica che non ci siano errori
2. Esegui `npm test` e verifica che tutti i test passino
3. Controlla che non ci siano console.log rimasti nel codice
4. Verifica che le variabili d'ambiente siano configurate
5. Controlla che il file .env.production sia aggiornato
6. Verifica la versione nel package.json
Riporta lo stato di ogni punto con un checkmark.
カスタム コマンドが作成されると、次のコマンドを使用して呼び出されます。 /review o
/deploy-check クロード コード プロンプトで直接。
4. 構成階層
Claude Code は構成システムを使用します 4つの階層レベル、 ここで、各レイヤーは下位レイヤーの設定をオーバーライドできます。これ アーキテクチャにより、ポリシーに至るまでの詳細な構成が可能 企業個人の開発者の個人的な好みに合わせて調整します。
構成階層 (最上位から最下位)
| レベル | ファイルパス | ほうき | 優先度 |
|---|---|---|---|
| 企業 | /etc/claude-code/managed-settings.json |
組織全体 | 最大値（上書き不可） |
| ローカルプロジェクト | .claude/settings.local.json |
プロジェクト内の単一の開発者 | 高い |
| 共有プロジェクト | .claude/settings.json |
プロジェクトの開発者全員 | 平均 |
| グローバルユーザー | ~/.claude/settings.json |
すべてのユーザープロジェクト | 基本 |
レベル 1: エンタープライズ (最優先)
エンタープライズ構成はシステム管理者によって管理され、次の場所にあります。
で /etc/claude-code/managed-settings.json。定義された設定
このレベルでは 上書きすることはできません 他のレベルからでも。
これは、企業のセキュリティ ポリシーを強制するための理想的なメカニズムです。
{
"permissions": {
"deny": [
"Bash(rm -rf /*)",
"Bash(sudo *)",
"Bash(chmod 777 *)",
"Write(~/.ssh/*)",
"Write(~/.aws/*)"
]
},
"security": {
"max_file_size_bytes": 10485760,
"blocked_domains": ["*.internal.company.com"],
"require_approval_for_network": true
},
"model": {
"default": "claude-sonnet-4-20250514",
"allowed": ["claude-sonnet-4-20250514", "claude-opus-4-20250514"]
}
}レベル 2: ローカル プロジェクト (settings.local.json)
ファイル .claude/settings.local.json それは個々の開発者に固有のものです
プロジェクトのコンテキストで。このファイル コミットしてはなりません
リポジトリ内 (に追加する必要があります) .gitignore）個人的な好みが含まれているため。
{
"permissions": {
"allow": [
"Bash(npm run test:watch)",
"Bash(npm run dev)",
"Bash(docker compose up -d)"
]
},
"preferences": {
"model": "claude-opus-4-20250514",
"theme": "dark",
"auto_approve_reads": true
}
}レベル 3: 共有プロジェクト (settings.json)
ファイル .claude/settings.json リポジトリと共有にコミットされています
チーム全体でプロジェクトを構成します。ここにルールと権限が入ります
すべての開発者が従う必要があります。
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Bash(mvn *)",
"Bash(gradle *)",
"Bash(git status)",
"Bash(git diff *)",
"Bash(git log *)",
"Read(*)",
"Write(src/**/*)"
],
"deny": [
"Bash(git push --force *)",
"Bash(git reset --hard *)",
"Bash(rm -rf *)",
"Write(.env*)",
"Write(**/credentials*)",
"Write(**/secrets*)"
]
},
"context": {
"include_patterns": ["src/**/*.ts", "src/**/*.html", "src/**/*.css"],
"exclude_patterns": ["node_modules/**", "dist/**", ".angular/**"]
}
}レベル 4: グローバル ユーザー
ファイル ~/.claude/settings.json ユーザーのホームディレクトリには以下が含まれます
すべてのプロジェクトに適用されるグローバル設定。ってレベルだよ
優先度が最も低く、プロジェクト設定によって上書きされます。
{
"permissions": {
"allow": [
"Bash(ls *)",
"Bash(cat *)",
"Bash(which *)",
"Bash(node --version)",
"Read(*)"
]
},
"preferences": {
"model": "claude-sonnet-4-20250514",
"auto_approve_reads": true,
"verbose_output": false,
"language": "it"
}
}紛争の解決
同じ設定が複数のレベルで定義されている場合、優先レベルは
大きい方が優先されます。リストの場合 (例: allow e deny）、
声 deny より高いレベルのものが常に声よりも優先されます
allow より低いレベルの。これにより、ポリシーが確実に
企業のセキュリティ対策を回避することはできません。
5. セキュリティ権限テンプレート
権限は、クロード コードがプロンプトを表示せずに実行できるアクションを制御します。 権限を正しく構成すると、生産性とセキュリティのバランスが取れます。ここに2つあります 一般的なシナリオにすぐに使用できるテンプレート。
テンプレート 1: 基本セキュリティ (標準開発)
このテンプレートは次のような場合に最適です 日々の発展 どこにいてもプロジェクトに参加できる クロードは一般的な開発コマンドに対する自律性を持っていますが、保護されています 機密ファイルと破壊的な操作について。
{
"permissions": {
"allow": [
"Bash(npm run *)",
"Bash(npm test *)",
"Bash(npm install *)",
"Bash(npx *)",
"Bash(git status)",
"Bash(git diff *)",
"Bash(git log *)",
"Bash(git branch *)",
"Bash(git checkout *)",
"Bash(git add *)",
"Bash(git commit *)",
"Bash(tsc *)",
"Bash(ng *)",
"Bash(mvn *)",
"Bash(gradle *)",
"Bash(python -m pytest *)",
"Bash(docker compose *)",
"Bash(curl *)",
"Read(*)",
"Write(src/**/*)",
"Write(tests/**/*)",
"Write(docs/**/*)"
],
"deny": [
"Write(.env*)",
"Write(**/*.pem)",
"Write(**/*.key)",
"Write(**/credentials*)",
"Write(**/secrets*)",
"Write(~/.ssh/*)",
"Write(~/.aws/*)",
"Bash(rm -rf *)",
"Bash(sudo *)",
"Bash(chmod 777 *)",
"Bash(git push --force *)",
"Bash(git reset --hard *)"
]
}
}テンプレート 2: 厳格なセキュリティ (重要な環境)
このテンプレートに必要なものは、 明示的な承認 すべての操作に 書き込み、ネットワークへのアクセスを拒否します。データ環境に最適です 機密性が高く厳格なコンプライアンス、または運用中のプロジェクト。
{
"permissions": {
"allow": [
"Read(src/**/*)",
"Read(tests/**/*)",
"Read(docs/**/*)",
"Bash(git status)",
"Bash(git diff *)",
"Bash(git log *)"
],
"deny": [
"Write(*)",
"Bash(npm install *)",
"Bash(npx *)",
"Bash(curl *)",
"Bash(wget *)",
"Bash(ssh *)",
"Bash(scp *)",
"Bash(nc *)",
"Bash(git push *)",
"Bash(git commit *)",
"Bash(docker *)",
"Bash(sudo *)",
"Bash(rm *)",
"Bash(mv *)",
"Bash(cp *)"
]
},
"security": {
"require_approval_for_all_writes": true,
"require_approval_for_network": true,
"audit_log": true,
"max_file_modifications_per_session": 10
}
}テンプレート間の比較
| 待ってます | 基本的なセキュリティ | 厳重なセキュリティ |
|---|---|---|
| ファイルの読み取り | すべてのファイルで自動 | src/tests/docs でのみ自動 |
| ファイル書き込み | ソース、テスト、ドキュメントで自動 | ファイルごとに承認が必要 |
| ビルドコマンド | 自動 (npm、mvn、gradle) | 拒否 - 読み取り専用 |
| Gitコマンド | 読み取り + コミット/チェックアウト | 読み取り専用 (ステータス、差分、ログ) |
| ネットワークアクセス | カールは許可されますが、ssh/scp は許可されません | 完全否定 |
| 機密ファイル | ロック済み (.env、.pem、.key) | ロックされています (すべてのファイルが書き込まれています) |
| 理想的な使い方 | 日々の発展 | 監査、コンプライアンス、生産 |
6. ヘッドレスモード
ヘッドレス モードを使用すると、ある方法でクロード コードを実行できます 非対話型、 CI/CD パイプライン、自動化スクリプト、バッチ プロセスへの統合に最適です。 このモードでは、クロードはプロンプトを受け取り、それを実行し、結果を返します。 構造化された JSON 形式で。
基本的な構文
# Sintassi base
claude --print "Analizza il codice in src/ e riporta i problemi" --output-format json
# Con limite di iterazioni
claude --print "Esegui i test e correggi i fallimenti" \
--output-format json \
--max-iterations 10
# Con modello specifico
claude --print "Genera la documentazione API" \
--output-format json \
--model claude-sonnet-4-20250514
# Con permessi espliciti
claude --print "Formatta tutti i file TypeScript" \
--output-format json \
--allowedTools "Bash(npx prettier --write src/**/*.ts)" \
--allowedTools "Read(*)"ヘッドレスモードのメインフラグ
ヘッドレスモードフラグ
| フラグ | 説明 | デフォルト値 |
|---|---|---|
--print |
静音モードで実行するためのプロンプト | 義務的 |
--output-format |
出力形式 (json, text, stream-json) |
text |
--max-iterations |
最大反復回数 (ツール使用サイクル) | 無制限 |
--model |
使用するAIモデル | 構成から |
--allowedTools |
実行を許可されたツール (反復可能) | 構成から |
--verbose |
デバッグログ付きの詳細な出力 | false |
GitHub アクションとの統合
ヘッドレス モードと CI/CD パイプラインとの統合の強力な使用例。 以下は、Claude Code を使用した完全な GitHub Actions ワークフローの例です。 各プルリクエストの自動コードレビュー。
name: Claude Code Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- uses: actions/setup-node@v4
with:
node-version: '20'
- name: Install Claude Code
run: npm install -g @anthropic-ai/claude-code
- name: Run Code Review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
DIFF=$(git diff origin/main...HEAD)
claude --print "Analizza il seguente diff e fornisci una code review:
$DIFF
Formato output:
- Severity: Critical/Major/Minor
- File e riga
- Problema
- Soluzione proposta" \
--output-format json \
--max-iterations 5 > review.json
- name: Post Review Comment
uses: actions/github-script@v7
with:
script: |
const fs = require('fs');
const review = JSON.parse(fs.readFileSync('review.json', 'utf8'));
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: context.issue.number,
body: review.result
});ローカル オートメーション スクリプト
#!/bin/bash
# Script per fix automatico di lint errors
echo "=== Claude Code Auto-Fix ==="
echo "Analizzando errori di lint..."
# Esegui lint e cattura errori
LINT_OUTPUT=$(npm run lint 2>&1 || true)
if [ -z "$LINT_OUTPUT" ]; then
echo "Nessun errore trovato!"
exit 0
fi
echo "Trovati errori. Avvio Claude Code per la correzione..."
claude --print "Correggi i seguenti errori di lint:
$LINT_OUTPUT
Regole:
- Correggi solo gli errori segnalati
- Non modificare la logica del codice
- Mantieni lo stile esistente" \
--output-format json \
--max-iterations 15 \
--allowedTools "Read(src/**/*)" \
--allowedTools "Write(src/**/*)" \
--allowedTools "Bash(npm run lint)"
echo "Fix completato. Verifica finale..."
npm run lint7. 一般的なエラーとトラブルシューティング
適切な設定を行っていても、使用中にエラーが発生する場合があります クロード・コード著。最も一般的な問題とその解決策を次に示します。
よくある問題と解決策
| 問題 | 原因 | 解決 |
|---|---|---|
| コマンドが見つかりません: クロード | バイナリが PATH にありません | チェック npm list -g グローバル npm パスを PATH に追加します |
| 認証に失敗しました | API キーが無効か期限切れです | 再実行 claude ログインフローの場合、または変数を確認してください ANTHROPIC_API_KEY |
| 許可が拒否されました | 設定によりアクションがブロックされました | チェック /permissions 設定に必要なルールを追加します |
| コンテキストが大きすぎます | コンテキスト内のファイルが多すぎます | 使用 /clear 必要なファイルのみをリロードします @ |
| レート制限を超えました | 短期間にリクエストが多すぎる | 数分待ってから、プランのアップグレードを検討してください |
| ENOENT .claude/settings.json | 構成ファイルがありません | ディレクトリを作成する .claude/ そしてファイル settings.json 内容あり {} |
| モデルがありません | プランに含まれないモデル | 使用 /model 現在のプランで利用可能なテンプレートに切り替えるには |
| WSLネットワークエラー | WSL で DNS が構成されていません | 設定する /etc/resolv.conf ネームサーバーあり 8.8.8.8 WSLでは |
高度なデバッグ
# Verificare la versione installata
claude --version
# Verificare lo stato dell'autenticazione
claude --print-auth-status
# Avviare in modalità debug verbose
claude --verbose
# Verificare la configurazione attiva
claude --print "Mostra la configurazione attiva" --output-format json
# Reset completo della configurazione
rm -rf ~/.claude/settings.json
claude # Ricrea la configurazione di default
# Verifica connettivita API
curl -s https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2024-01-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-4-20250514","max_tokens":10,"messages":[{"role":"user","content":"test"}]}'8. CLI を使用した日常のワークフロー
Claude Code CLI の真の力は、ワークフローに統合したときに現れます。 日々の開発。を使用する開発者の典型的な 1 日を次に示します。 クロード・コードは常に仕事の仲間です。
朝のルーティン
# 1. Entrare nella directory del progetto
cd ~/projects/my-app
# 2. Avviare Claude Code
claude
# 3. Verificare lo stato del repository
> !git status
> !git log --oneline -5
# 4. Caricare il contesto del task corrente
> @src/features/user-profile/
> Sto lavorando sulla feature user-profile.
> Cosa è stato fatto finora e cosa resta da implementare?
# 5. Attivare Plan Mode per il primo task
> [Shift+Tab+Tab] Implementa la validazione del form di profilo開発の流れ
# Implementazione feature
> Implementa il componente EditProfile con form reattivo
> Usa i validatori Angular per email, telefono e nome
> Segui i pattern esistenti in src/features/auth/
# Test
> Genera unit test per EditProfileComponent
> Copri i casi: form valido, email invalida, submit e cancel
# Code review
> /review # Usa il custom command creato in precedenza
# Commit
> !git add -A
> !git commit -m "feat(user-profile): add edit profile form with validation"
# Passare al task successivo
> /clear
> @src/features/notifications/
> Implementa il sistema di notifiche push生産性パターン
日常使用のベストプラクティス
- アメリカ合衆国
/clear異なるタスク間: 文脈をクリーンに保ち、回答を正確に保ちます - 特定のファイルをメンションするには
@: コンテキスト内のノイズを削減し、品質を向上させます - 複雑なタスクのための計画モード: 複数ファイル操作での予期せぬ事態を回避する
- ボイラープレートの YOLO モード: 反復的なファイルの生成を高速化します。
- 定期的なタスク用のカスタム コマンド: レビュー、展開チェック、テストを標準化する
- バッシュモード (
!) ショートカットの場合: クロードに会いに行く必要はないgit status - 巻き戻し (
Esc+Esc) 必要な場合: 方向が間違っていたら迷わず引き返せ - チェック
/status定期的に: トークンの使用状況を監視して制限を回避する
9. 高度な構成
基本的なテンプレートに加えて、Claude Code は高度な構成オプションを提供します モノリポジトリ、分散チーム、マルチプロジェクト環境などの特定のシナリオ向け。
Monorepo の構成
複数のパッケージを含むモノリポジトリでは、構成でコンテキストを処理する必要があります 共通のルールを維持しながら、サブプロジェクトごとに異なります。
{
"permissions": {
"allow": [
"Read(*)",
"Write(packages/*/src/**/*)",
"Write(packages/*/tests/**/*)",
"Bash(npm run -w packages/* *)",
"Bash(npx turbo run *)",
"Bash(git *)"
],
"deny": [
"Write(packages/*/node_modules/**)",
"Write(packages/*/.env*)",
"Bash(rm -rf *)",
"Bash(sudo *)"
]
},
"context": {
"include_patterns": [
"packages/*/src/**/*.ts",
"packages/*/package.json",
"turbo.json",
"package.json"
],
"exclude_patterns": [
"**/node_modules/**",
"**/dist/**",
"**/.turbo/**"
]
}
}構成用の環境変数
サポートされている環境変数
| 変数 | 説明 | Esempio |
|---|---|---|
ANTHROPIC_API_KEY |
認証用のAPIキー | sk-ant-api03-xxxxx |
CLAUDE_CODE_MODEL |
デフォルトのテンプレート | claude-sonnet-4-20250514 |
CLAUDE_CODE_MAX_TOKENS |
応答ごとのトークン制限 | 16384 |
CLAUDE_CODE_CONFIG_DIR |
カスタム構成ディレクトリ | /custom/path/.claude |
CLAUDE_CODE_VERBOSE |
詳細出力を有効にする | true |
結論
Claude Code CLI は、単なる AI モデルのラッパーではありません。 それは 会話型開発環境 統合された完全な ターミナル内でコードを操作する方法が変わります。組み合わせ キーボード ショートカット、スラッシュ コマンド、階層構成、ヘッドレス モードの説明 あらゆるワークフローとセキュリティ レベルに適応する柔軟なエコシステムを構築します。
重要なポイント
- 柔軟な設置: npm、curl、Homebrew、または WSL - 環境に最適な方法を選択してください
- 重要なショートカット:
!バッシュの場合、@ファイルごとに、Esc+Esc巻き戻すには、Shift+Tabヨロ用 - 制御用のスラッシュコマンド:
/clear,/model,/status,/permissionsセッションを管理するには - 4 レベルの階層: エンタープライズ > ローカル プロジェクト > 共有プロジェクト > グローバル ユーザー
- 権限テンプレート: 開発には基本セキュリティ、本番には厳格なセキュリティ
- ヘッドレスモード: 構造化された JSON 出力による CI/CD 自動化
- カスタムコマンド: 独自のスラッシュ コマンドを作成してチームのワークフローを標準化する
Nel 次の記事 を探索してみます エージェントのスキル: 容量 特殊なスキルを使用してクロード コードの機能を拡張するモジュール式 ドキュメント、データ分析、Web 開発などに使用できます。作成方法を調べます カスタマイズされたスキルを日々のワークフローに統合します。