claude --version

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

claude /doctor

node --version
# v18.x.x 以上が出力されるはず

# nvm で Node.js バージョンを管理（推奨）
nvm install 22
nvm use 22

# または直接ダウンロードしてインストール
# https://nodejs.org/ にアクセスして LTS バージョンをダウンロード

npm ERR! Error: EACCES: permission denied, mkdir '/usr/local/lib/node_modules'

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

# ユーザーレベルのグローバルパッケージディレクトリを作成
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'

# PATH に追加（~/.bashrc または ~/.zshrc に書き込み）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 再インストール
npm install -g @anthropic-ai/claude-code

# nvm をインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.bashrc

# Node.js をインストールして使用
nvm install 22
nvm use 22

# nvm でインストールした Node.js は sudo 不要
npm install -g @anthropic-ai/claude-code

npm ERR! network request to https://registry.npmjs.org/ failed
npm ERR! code ETIMEDOUT

# 一時的に淘宝ミラーを使用
npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# または恒久的にミラーを設定
npm config set registry https://registry.npmmirror.com
npm install -g @anthropic-ai/claude-code

# npm プロキシを設定
npm config set proxy http://プロキシアドレス:ポート
npm config set https-proxy http://プロキシアドレス:ポート

# インストール完了後はプロキシ設定を解除可能
npm config delete proxy
npm config delete https-proxy

claude : File C:\Users\xxx\AppData\Roaming\npm\claude.ps1 cannot be loaded
because running scripts is disabled on this system.

# 管理者として PowerShell を開き、実行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 次に claude を再実行
claude

# CMD で直接実行
claude

cr_xxxxxxxxxxxxxxxx

# 現在の環境変数を表示
echo $ANTHROPIC_API_KEY

# 正しく設定（QCode.cc キー）
export ANTHROPIC_API_KEY="cr_あなたのキー"

# QCode.cc の Base URL
export ANTHROPIC_BASE_URL="https://あなたのサービスアドレス"

# 1. 現在の設定を確認
echo $ANTHROPIC_BASE_URL

# 2. URL 形式が正しいことを確認
#    - https:// で始まる必要がある
#    - 末尾にスラッシュ / をつけない
#    - パス（含まない /v1/messages）

# 正しい例
export ANTHROPIC_BASE_URL="https://api.example.com"

# 間違いの例
export ANTHROPIC_BASE_URL="http://api.example.com"      # https が欠けている
export ANTHROPIC_BASE_URL="https://api.example.com/"     # 余分なスラッシュ
export ANTHROPIC_BASE_URL="https://api.example.com/v1"   # 余分なパス

Error: connect ETIMEDOUT
Error: getaddrinfo ENOTFOUND api.example.com

# 1. プロキシが正しく設定されているか確認
echo $HTTP_PROXY
echo $HTTPS_PROXY
echo $ALL_PROXY

# 2. ネットワーク接続をテスト
curl -v https://あなたのサービスアドレス/health

# 3. プロキシを使用する場合、Claude Code が使えるようにする
export HTTP_PROXY="http://プロキシアドレス:ポート"
export HTTPS_PROXY="http://プロキシアドレス:ポート"

# 4. プロキシが不要なのに設定されている場合は、解除
unset HTTP_PROXY
unset HTTPS_PROXY
unset ALL_PROXY

Error: unable to verify the first certificate
Error: self signed certificate in certificate chain

# 方案 1：システム CA 証明書を更新
# Ubuntu/Debian
sudo apt update && sudo apt install ca-certificates

# macOS
brew install ca-certificates

# 方案 2：企業ネットワークのミッパーイン証明書の場合、Node.js に信頼させる
export NODE_EXTRA_CA_CERTS="/path/to/corporate-ca.crt"

# 方案 3：一時的に証明書検証をスキップ（テスト用のみ、長期使用は推奨されない）
export NODE_TLS_REJECT_UNAUTHORIZED=0

# 基本接続をテスト
curl -s -o /dev/null -w "%{http_code}" \
  https://あなたのサービスアドレス/health

# API 呼び出しをテスト（あなたのキーとアドレスに置き換える）
curl https://あなたのサービスアドレス/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: cr_あなたのキー" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "Hello"}]
  }'

Error: EACCES: permission denied, open '/path/to/file'

# 1. ファイル権限を確認
ls -la /path/to/file

# 2. 現在のユーザーに読み書き権限があることを確認
chmod u+rw /path/to/file

# 3. ディレクトリ権限を確認（Claude が新規ファイルを作成的时候会用到目录写权限）
chmod u+w /path/to/directory

# 4. root が作成したファイルの場合、所有者を変更
sudo chown $(whoami) /path/to/file

# 現在の権限設定を表示
claude /permissions

# settings.json で許可されたディレクトリを設定
# ~/.claude/settings.json
{
  "permissions": {
    "allow": [
      "Read files in /home/user/projects/**",
      "Write files in /home/user/projects/**",
      "Execute bash commands"
    ]
  }
}

fatal: unable to access 'https://github.com/xxx/xxx.git/':
The requested URL returned error: 403

# 1. Git 設定を確認
git config --list

# 2. SSH キーまたは Token の設定を確認
ssh -T git@github.com          # SSH 接続をテスト
gh auth status                  # GitHub CLI 認証をテスト

# 3. HTTPS の場合、認証情報を確認
git config credential.helper    # 認証情報管理方法を表示

# 4. Claude Code が正しい Git リポジトリにあることを確認
git status                      # リポジトリディレクトリ内であることを確認

# 権限設定を表示
claude /permissions

# 信頼できるプロジェクトの場合、CLAUDE.md で許可されたコマンドを設定可能
# CLAUDE.md
## 許可されるコマンド
allowedTools:

  - Bash(npm run *)
  - Bash(pnpm *)
  - Bash(git *)
  - Bash(docker compose *)

# サーバーへの遅延をテスト
ping サービスアドレス

# 遅延が 500ms を超える場合は検討：
# 1. プロキシ設定が最適か確認
# 2. 異なる時間帯に使用してみる（ピーク時間を避ける）
# 3. QCode.cc 客服に連絡して最適なノードを取得

# 方案 1：コンテキストを圧縮（重要な情報を保持）
/compact

# 方案 2：完全にクリア（最初からやり直せる場合）
/clear

# 方案 3：入力内容を簡潔にする
# 大量ファイル内容を一度に送信しない
# 貼り付けずに @ 引用を使用
# 一度に1つのタスクのみ処理

# 1. Node.js のメモリ使用量を確認
node -e "console.log(process.memoryUsage())"

# 2. Node.js を最新版 LTS にアップグレード
nvm install 22
nvm use 22

# 3. 問題が継続する場合は、Node.js の最大メモリを制限
export NODE_OPTIONS="--max-old-space-size=4096"

# 4. Claude Code を再起動
# 現在のセッションを終了して再起動
exit
claude

# たまに 429 が発生する場合
# → 30秒待てば自動再試行、Claude Code には内置重试ロジックがある

# 頻繁に 429 が発生する場合
# → リクエスト頻度を減らす
# → /compact でコンテキストサイズを減らす
# → 同時に複数の Claude Code インスタンスを実行しない

# 継続的に 429 が発生する場合
# → プランのクォータを使い切ったか確認
# → QCode.cc Dashboard にログインして使用量を確認
# → プランのアップグレードを検討

Error: 529 API Overloaded
The API is temporarily overloaded. Please try again later.

# 1. 正しくインストールされているか確認
which claude
npm list -g @anthropic-ai/claude-code

# 2. 詳細なエラーメッセージを表示
claude --debug

# 3. キャッシュをクリアしてから再起動を試みる
rm -rf ~/.claude/cache
claude

# 1. ファイルの場所が正しいか確認
ls -la CLAUDE.md                # プロジェクトルートディレクトリ
ls -la .claude/CLAUDE.md        # プロジェクトプライベート設定
ls -la ~/.claude/CLAUDE.md      # グローバル設定

# 2. ファイルエンコーディングが UTF-8 であることを確認
file CLAUDE.md
# 次のように表示されるはず：CLAUDE.md: UTF-8 Unicode text

# 3. 構文エラーがないことを確認（Markdown 이지만、특수文字会导致解析问题）
# CLAUDE.md で ``` 以外の特殊マークを使用しないように注意

# 4. Claude Code を再起動して設定を適用
# 終了して再度入り直す

# 1. ターミナルエンコーディング設定を確認
echo $LANG
# UTF-8 を含める必要がある，例如 en_US.UTF-8 或 zh_CN.UTF-8

# 2. 正しいエンコーディングを設定
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8

# 3. ターミナルが UTF-8 をサポートしていることを確認
# macOS Terminal / iTerm2 はデフォルトでサポート
# Windows Terminal はデフォルトでサポート
# Windows CMD の場合：chcp 65001 を実行

# 1. 先に Git コンフリクトを解決
git status     # コンフリクトファイルを確認
git diff       # コンフリクト内容を表示

# 2. Claude にコンフリクトを解決してもらう
> "現在の git コンフリクトファイルを確認し、これらのコンフリクトを解決してください。両方の変更を保持します。"

# 3. 解決後に続ける
git add .
git commit -m "resolve merge conflicts"

# コンテナ内に Node.js 22+ があることを確認
docker run -it node:22-slim bash

# Claude Code をインストール
npm install -g @anthropic-ai/claude-code

# 必要な環境変数を渡す
docker run -it \
  -e ANTHROPIC_API_KEY="cr_あなたのキー" \
  -e ANTHROPIC_BASE_URL="https://あなたのサービスアドレス" \
  -v $(pwd):/workspace \
  -w /workspace \
  node:22-slim claude

1. クイック自己診断
   ├── claude --version（バージョンが最新か）
   ├── claude /doctor（自動診断）
   └── node --version（Node.js ≥ 18）

2. ネットワーク接続性
   ├── curl で API アドレスをテスト
   ├── プロキシ/VPN 設定を確認
   └── DNS 解決を確認

3. 認証設定
   ├── ANTHROPIC_API_KEY の形式が正しいか
   ├── ANTHROPIC_BASE_URL が正しいか
   └── キーが期限切れでないか

4. 権限確認
   ├── ファイルシステム権限
   ├── Git 権限
   └── Claude Code 権限設定

5. パフォーマンス最適化
   ├── /compact でコンテキストを圧縮
   ├── /model で適切なモデルに切り替え
   └── .claudeignore で大ファイルを排除

6. 上記で解决できない場合 → ヘルプを求める