# APAC アクセス高速化チュートリアル

> APAC 地域のユーザー向けに Node.js、Git のインストール、npm 騰訊雲ミラー、macOS Homebrew ミラーの高速化設定を解説します。

APAC 地域のネットワーク環境では、公式ソースから直接 Node.js パッケージ、Git をダウンロードしたり、npm/Homebrew で依存関係をインストールしたりする際に、速度が遅かったりタイムアウトしたりすることがあります。本記事では、APAC 地域のミラーソースを利用してこれらのツールのインストールと使用を高速化する方法を紹介します。

## Node.js のインストール

### Windows

清華大学ミラーサイトから Node.js インストーラーをダウンロードすることをお勧めします：

1. [清華大学 Node.js ミラー](https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/v24.0.0/) にアクセス
2. `node-v24.0.0-x64.msi` インストーラーをダウンロード
3. ダブルクリックしてインストールを実行し、デフォルト設定のまま進める

または [Node.js 公式サイト](https://nodejs.org/) にアクセスし、左側の LTS バージョンを選択してダウンロードしてください。

インストール完了後、コマンドラインを開いて確認：

```bash
node -v
npm -v
```

### macOS

Homebrew でのインストールを推奨します（Homebrew ミラー設定は後述）：

```bash
brew install node
```

または [nvm](https://github.com/nvm-sh/nvm) で複数バージョンを管理：

```bash
curl -o- https://github.com/nvm-sh/nvm/raw/main/install.sh | bash
source ~/.zshrc
nvm install --lts
```

### Linux

```bash
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
```

## Git のインストール

### Windows

清華大学ミラーサイトからのダウンロードを推奨：

1. [Git-2.53.0.3-64-bit.exe（清華ミラー）](https://mirrors.tuna.tsinghua.edu.cn/github-release/git-for-windows/git/LatestRelease/Git-2.53.0.3-64-bit.exe) をダウンロード
3. ダブルクリックしてインストールし、デフォルト設定のまま進める

インストール完了後、確認：

```bash
git --version
```

### macOS

macOS には Git がプリインストールされています。Homebrew で最新版をインストールすることも可能：

```bash
brew install git
```

### Linux (Debian/Ubuntu)

```bash
sudo apt-get update
sudo apt-get install -y git
```

## npm 騰訊雲ミラーの設定

npm はデフォルトで `registry.npmjs.org` からパッケージをダウンロードしますが、APAC 地域ではアクセスが遅い場合があります。騰訊雲ミラーに切り替えることで速度が大幅に向上します。

### ミラーをグローバル設定

```bash
npm config set registry https://mirrors.cloud.tencent.com/npm/
```

### 設定の確認

```bash
npm config get registry
```

表示されるはず：`https://mirrors.cloud.tencent.com/npm/`

### 一時的な使用（グローバル設定を変更しない）

インストールコマンドに `--registry` パラメータを追加：

```bash
npm install -g @anthropic-ai/claude-code --registry https://mirrors.cloud.tencent.com/npm/
```

### 公式ソースに戻す

```bash
npm config set registry https://registry.npmjs.org/
```

## macOS Homebrew ミラー高速化

Homebrew はデフォルトで GitHub から取得するため、APAC 地域では速度が遅い場合があります。清華大学ミラーソースの使用を推奨します。

### Homebrew ミラーの設定

以下を `~/.zshrc` に追加：

```bash
{
echo ''
echo '# Homebrew 清華ミラー'
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"'
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"'
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"'
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"'
echo 'export HOMEBREW_PIP_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"'
} >> ~/.zshrc
```

設定を反映：

```bash
source ~/.zshrc
```

### 確認

```bash
brew update
```

更新速度が明らかに速くなれば、ミラーが有効になっています。

### Homebrew の初回インストール

Homebrew が未インストールの場合、清華ミラーを利用して高速インストール可能：

```bash
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
/bin/bash -c "$(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install/raw/HEAD/install.sh)"
```

### 公式ソースに戻す

```bash
unset HOMEBREW_API_DOMAIN
unset HOMEBREW_BOTTLE_DOMAIN
unset HOMEBREW_BREW_GIT_REMOTE
unset HOMEBREW_CORE_GIT_REMOTE
unset HOMEBREW_PIP_INDEX_URL
git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew
```

## pip ミラー高速化（オプション）

Python SDK を使用する場合、pip 騰訊雲ミラーの設定を推奨：

```bash
pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple
```

## Git Clone 高速化（オプション）

GitHub 上のリポジトリは、ミラーを利用して高速クローン可能：

```bash
# GitHub プロキシを使用
git clone https://gh.llkk.cc/https://github.com/ユーザー名/リポジトリ名.git
```

> 高速化アドレスはサードパーティの GitHub Proxy から提供されています。プロジェクト名とバージョンが一致していることを確認してください。

これは https://jp.llmoxy.com/docs/code-tutorials/apac-speedup の markdown 版です。
