よくある質問

Claude Code に関するよくある質問

よくある質問（FAQ）¶

このドキュメントでは、Claude Code の使用に関する一般的な質問に回答します。

インストールとセットアップ ¶

Q: Claude Code をインストールするには？¶

A: Claude Code は npm でグローバルにインストールします：

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

インストール後、任意のプロジェクトディレクトリで claude を実行して開始します。

Q: インストール後に `claude` コマンドが見つからない？¶

A: これは通常、npm のグローバルディレクトリが PATH にないためです。解決方法：

# npm グローバルディレクトリを確認
npm config get prefix

# bin サブディレクトリを PATH に追加
# macOS/Linux（~/.zshrc または ~/.bashrc に追加）
export PATH="$(npm config get prefix)/bin:$PATH"

Q: QCode.cc プロキシを設定するには？¶

A: 以下の環境変数を設定します：

export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

これらをシェル設定ファイル（例：~/.zshrc）に追加することをお勧めします。

API Key と認証 ¶

Q: API Key はどこで取得できますか？¶

A: QCode.cc ダッシュボードにログインし、API Key 管理ページで API Key を作成または確認します。

Q: API Key のプレフィックスは何ですか？¶

A: QCode.cc の API Key は cr_ で始まります。例：cr_xxxxxxxxxxxxxx

A: 考えられる原因： 1. コピーエラー：余分なスペースや文字の欠落がないか確認 2. サブスクリプション期限切れ：アカウントのサブスクリプション状態を確認 3. 環境変数が読み込まれていない：ターミナルを再起動するか source ~/.zshrc を実行 4. API エンドポイントが間違っている：ANTHROPIC_BASE_URL が正しく設定されているか確認

使用量とコスト ¶

Q: 現在のセッションの使用量を確認するには？¶

A: 使用量を確認する方法は2つあります：

方法1：ダッシュボードで確認（推奨）

QCode.cc ダッシュボードにログインし、「使用統計」セクションで確認できます：

モデル呼び出し回数：各モデルの使用頻度統計
コスト内訳：正確なコスト消費詳細
クォータ使用状況：現在のプランのクォータ消費進捗

ダッシュボードのデータはほぼリアルタイムで更新され、より正確な課金が可能です。業界標準の LiteLLM 価格設定ルールを採用し、定期的に同期更新して課金の正確性を確保しています。

方法2：CLI で素早く確認

/cost コマンドを使用して、現在のセッションの概要を素早く確認できます：

/cost

出力例：

Total cost:            $0.55
Total duration (API):  6m 19.7s
Total code changes:    10 lines added, 5 lines removed

注意：/cost で表示されるコストは参考値であり、モデルの分布やおおよその使用量を素早く確認するのに適しています。Anthropic が各モデルの詳細な課金ルールを公開していないため、CLI 内蔵の課金は実際のコストと異なる場合があります。正確な統計にはダッシュボードをご利用ください。

Q: トークン消費を減らすには？¶

A: いくつかの効果的な方法：

コンテキストを圧縮：/compact コマンドを使用
履歴をクリア：/clear でコンテキストをリセット
具体的に質問：不必要なスキャンを引き起こす曖昧な質問を避ける
タスクを分割：大きなタスクを小さなものに分割

Q: コンテキストはいつ自動圧縮されますか？¶

A: Claude Code はデフォルトでコンテキストが 95% の容量に達すると自動圧縮します。また： - /compact を手動実行して積極的に圧縮 - /compact の後にカスタム指示を追加して圧縮の焦点を制御

権限システム ¶

Q: どのような権限モードがありますか？¶

A: 4つの権限モード：

モード	説明
`default`	各ツールの初回使用時に許可を求める
`acceptEdits`	ファイル編集を自動承認
`plan`	分析のみ、変更なし（Plan Mode）
`bypassPermissions`	すべてのプロンプトをスキップ（安全な環境が必要）

Q: デフォルトの権限モードを設定するには？¶

A: .claude/settings.json で設定します：

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Q: Claude が機密ファイルを読むのを防ぐには？¶

A: .claude/settings.json で deny ルールを設定します：

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  }
}

Q: よく使うコマンドを事前承認するには？¶

A: .claude/settings.json で allow ルールを設定します：

{
  "permissions": {
    "allow": [
      "Bash(npm run lint)",
      "Bash(npm run test:*)",
      "Bash(git status)"
    ]
  }
}

CLAUDE.md 設定 ¶

Q: CLAUDE.md とは何ですか？¶

A: CLAUDE.md はプロジェクトレベルの設定ファイルで、Claude にプロジェクトコンテキストを提供します： - プロジェクトアーキテクチャ - コーディング規約 - よく使うコマンド - 特別な規約

Q: CLAUDE.md はどこに置きますか？¶

A: プロジェクトルートに配置します。Claude Code は起動時に自動的に読み込みます。

Q: CLAUDE.md を作成するには？¶

A: /init コマンドで自動生成します：

/init

または手動で作成。基本構造：

# プロジェクト名

## 概要
プロジェクトの簡単な説明...

## 技術スタック
- フロントエンド：React
- バックエンド：FastAPI

## よく使うコマンド
- 開発サーバー起動：`npm run dev`
- テスト実行：`npm test`

## コーディング規約
- TypeScript を使用
- クラスより関数を優先

コンテキスト管理 ¶

Q: セッション履歴をクリアするには？¶

A: /clear コマンドを使用します：

/clear

これはすべての会話履歴をクリアし、新しいセッションを開始します。

Q: 履歴をクリアせずに圧縮するには？¶

A: /compact コマンドを使用します：

/compact

指示を追加して圧縮の焦点を制御できます：

/compact すべてのコード例を保持

Q: 現在のコンテキスト状態を確認するには？¶

A: /context コマンドを使用します：

/context

Q: @ でファイルを参照するには？¶

A: @ を使用してファイルを直接コンテキストに参照します：

@src/main.ts このファイルを説明して
@package.json 依存関係のバージョンを確認

MCP サーバー ¶

Q: MCP とは何ですか？¶

A: MCP（Model Context Protocol）は、Claude Code が外部ツールやデータソースに接続できるようにするプロトコルで、機能を拡張します。

Q: MCP サーバーを設定するには？¶

A: ~/.claude/settings.json で設定します：

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp-server"]
    }
  }
}

/model opus
/model sonnet

/memory このプロジェクトは npm ではなく pnpm を使用

Git 操作 ¶

Q: Claude にコードをコミットさせるには？¶

A: /commit コマンドを使用します：

/commit

Claude は変更を分析してコミットメッセージを生成します。

Q: Claude にコードをレビューさせるには？¶

A: /review コマンドを使用します：

/review

範囲を指定できます：

/review src/auth/

公式ドキュメント：Claude Code ドキュメント
QCode.cc サポート：ウェブサイト右下のライブチャット
コミュニティ：GitHub Discussions

よくある質問

目次