Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

CLIがバンドルされたJavaScriptの代わりに、プラットフォームごとのオプション依存関係を通じてネイティブのClaude Codeバイナリを起動するように変更されました。

原文（英語） ​

Changed the CLI to spawn a native Claude Code binary (via a per-platform optional dependency) instead of bundled JavaScript.

概要 ​

Claude Code 2.1.113から、CLIの実行方法が大幅に変わりました。従来はNode.jsでバンドルされたJavaScriptを実行していましたが、新たにBunの--compile機能を活用して生成されたプラットフォームネイティブバイナリを使用するようになりました。約100MBのバイナリにはJavaScriptCoreとBun APIが含まれており、AnthropicによってコードサインされているためmacOSのGatekeeperとも互換性があります。

基本的な使い方 ​

ユーザー側での操作は不要です。npm update -g @anthropic-ai/claude-code でアップデートするだけで、自動的にネイティブバイナリが使用されます。

bash
# Claude Codeを最新版にアップデート
npm update -g @anthropic-ai/claude-code

# バージョン確認
claude --version

実践例 ​

起動速度の改善を確認する ​

ネイティブバイナリへの移行後、起動時間が改善されているのを確認できます。

bash
# 起動時間を計測
time claude --version

# 旧来のJS版と比較して起動が早くなっているはず

プラットフォーム別のバイナリ確認 ​

プラットフォームに応じた最適なバイナリが自動的に選択されます。

bash
# Linuxでバイナリの場所を確認
which claude

# バイナリの実際のファイル形式を確認
file $(which claude)

Node.jsなしでの動作確認 ​

新しいバイナリはNode.jsに依存しないため、Node.jsがインストールされていない環境でも動作します（ただし初回インストールにはnpmが必要）。

bash
# Node.jsのバージョンに依存せず動作することを確認
node --version  # どのバージョンでも可

# Claude Codeは独立して動作する
claude --version

注意点 ​

  • プラットフォームごとの依存関係: バイナリはオプション依存関係として配布されるため、npm install時にプラットフォームに適したものが自動的に取得されます
  • 自動アップデート: バックグラウンドでのシームレスなアップデートが可能になりました
  • コードサイン: Anthropicによってバイナリにコードサインされており、macOSのセキュリティチェック（Gatekeeper）を通過できます
  • ファイルサイズ: バイナリは約100MBと大きめですが、その分Node.jsへの依存が解消されます
  • 後方互換性: APIや使い方は変わらないため、既存のスクリプトやワークフローへの影響はありません

関連情報 ​