APAC 地域のネットワーク環境では、公式ソースから直接 Node.js パッケージ、Git をダウンロードしたり、npm/Homebrew で依存関係をインストールしたりする際に、速度が遅かったりタイムアウトしたりすることがあります。本記事では、APAC 地域のミラーソースを利用してこれらのツールのインストールと使用を高速化する方法を紹介します。
Node.js のインストール
Windows
清華大学ミラーサイトから Node.js インストーラーをダウンロードすることをお勧めします:
- 清華大学 Node.js ミラー にアクセス
node-v24.0.0-x64.msiインストーラーをダウンロード- ダブルクリックしてインストールを実行し、デフォルト設定のまま進める
または Node.js 公式サイト にアクセスし、左側の LTS バージョンを選択してダウンロードしてください。
インストール完了後、コマンドラインを開いて確認:
node -v
npm -v
macOS
Homebrew でのインストールを推奨します(Homebrew ミラー設定は後述):
brew install node
または nvm で複数バージョンを管理:
curl -o- https://github.com/nvm-sh/nvm/raw/main/install.sh | bash
source ~/.zshrc
nvm install --lts
Linux
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
Git のインストール
Windows
清華大学ミラーサイトからのダウンロードを推奨:
- Git-2.53.0.3-64-bit.exe(清華ミラー) をダウンロード
- ダブルクリックしてインストールし、デフォルト設定のまま進める
インストール完了後、確認:
git --version
macOS
macOS には Git がプリインストールされています。Homebrew で最新版をインストールすることも可能:
brew install git
Linux (Debian/Ubuntu)
sudo apt-get update
sudo apt-get install -y git
npm 騰訊雲ミラーの設定
npm はデフォルトで registry.npmjs.org からパッケージをダウンロードしますが、APAC 地域ではアクセスが遅い場合があります。騰訊雲ミラーに切り替えることで速度が大幅に向上します。
ミラーをグローバル設定
npm config set registry https://mirrors.cloud.tencent.com/npm/
設定の確認
npm config get registry
表示されるはず:https://mirrors.cloud.tencent.com/npm/
一時的な使用(グローバル設定を変更しない)
インストールコマンドに --registry パラメータを追加:
npm install -g @anthropic-ai/claude-code --registry https://mirrors.cloud.tencent.com/npm/
公式ソースに戻す
npm config set registry https://registry.npmjs.org/
macOS Homebrew ミラー高速化
Homebrew はデフォルトで GitHub から取得するため、APAC 地域では速度が遅い場合があります。清華大学ミラーソースの使用を推奨します。
Homebrew ミラーの設定
以下を ~/.zshrc に追加:
{
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
設定を反映:
source ~/.zshrc
確認
brew update
更新速度が明らかに速くなれば、ミラーが有効になっています。
Homebrew の初回インストール
Homebrew が未インストールの場合、清華ミラーを利用して高速インストール可能:
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)"
公式ソースに戻す
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 騰訊雲ミラーの設定を推奨:
pip config set global.index-url https://mirrors.cloud.tencent.com/pypi/simple
Git Clone 高速化(オプション)
GitHub 上のリポジトリは、ミラーを利用して高速クローン可能:
# GitHub プロキシを使用
git clone https://gh.llkk.cc/https://github.com/ユーザー名/リポジトリ名.git
高速化アドレスはサードパーティの GitHub Proxy から提供されています。プロジェクト名とバージョンが一致していることを確認してください。
