Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

  • Amazon Linux 2およびその他のglibc 2.26システムでLinuxネイティブモジュールが読み込めない問題を修正しました

原文（英語） ​

  • Fixed Linux native modules not loading on Amazon Linux 2 and other glibc 2.26 systems

概要 ​

Amazon Linux 2をはじめとするglibc 2.26を使用しているLinuxディストリビューションで、Claude Codeのネイティブモジュールが正しく読み込まれない問題がありました。これは、ネイティブモジュールがより新しいバージョンのglibcに依存してビルドされていたことが原因です。バージョン2.1.73でglibc 2.26との互換性が確保され、これらの環境でもClaude Codeが正常に動作するようになりました。

基本的な使い方 ​

bash
# Amazon Linux 2などのglibc 2.26環境でも正常に動作
claude

# glibcのバージョンを確認する場合
ldd --version
# → ldd (GNU libc) 2.26

実践例 ​

Amazon Linux 2でのClaude Code使用 ​

bash
# EC2インスタンス（Amazon Linux 2）でClaude Codeをインストール
npm install -g @anthropic-ai/claude-code

# v2.1.73以降は正常に起動
claude

# 以前は以下のようなエラーが発生していた可能性がある
# Error: /lib64/libc.so.6: version `GLIBC_2.28' not found

CentOS 7環境での使用 ​

bash
# CentOS 7もglibc 2.17を使用しているため、同様の問題が発生していた可能性がある
# glibcバージョンの確認
ldd --version

# v2.1.73以降は互換性が改善
claude

CI/CD環境での使用 ​

bash
# Amazon Linux 2ベースのCI/CDランナーでClaude Codeを使用
# 例: AWS CodeBuild、GitHub Actions（self-hosted runner）

# Dockerfile例
FROM amazonlinux:2
RUN yum install -y nodejs npm
RUN npm install -g @anthropic-ai/claude-code

# v2.1.73以降はネイティブモジュールが正常に読み込まれる

注意点 ​

  • この問題はglibc 2.26以前のバージョンを使用しているLinuxディストリビューションで発生していました
  • 影響を受けるディストリビューションの例：Amazon Linux 2、CentOS 7、RHEL 7、古いバージョンのDebian/Ubuntu
  • ネイティブモジュールが読み込めない場合、一部の機能（サンドボックス、ファイル監視など）が利用できないか、パフォーマンスが低下する可能性がありました
  • モダンなディストリビューション（Ubuntu 20.04以降、Amazon Linux 2023など）では元々この問題は発生しません

関連情報 ​