Claude CodeをAWS Cloud9で動かすインスタンス要件

Claude CodeがAWS Cloud9で重いとき、最初に見るのはメモリ

AWS Cloud9でClaude Codeを動かすなら、最初にインスタンスのメモリを見ます。Claude CodeはRAM 4GB以上を要件にしていますが、Cloud9の標準的な値はそれを下回るためです。

Cloud9のチュートリアルが例示するCLIコマンドは--instance-type t2.microで、RAMは1GiBです。ドキュメントはこの値を「RAMとvCPUが比較的少なく、このチュートリアルには十分」と説明しています。チュートリアルの用途に合わせた大きさです。

AWS Cloud9は新規受付を終了済み: 使えるのは既存顧客だけ

「Cloud9はサービス終了か」と聞かれたら、答えはいいえです。サービスは続いていて、止まったのは新規顧客の受け付けだけです。

Cloud9をこれから使い始めるなら、まずこの前提に当たります。AWSは2024年7月25日付で、AWS Cloud9への新規顧客のアクセスを終了しました。

CloudShellはAWSマネジメントコンソールから開くブラウザ上のシェルで、AWS CLIが最初から入っています。使用は無料だとAWSのブログが書いています。新しい環境を探している場合は、Claude Platform on AWSでClaude Codeを使う場合のBedrockとの違いも比較材料になります。

Claude Codeのシステム要件とCloud9のOS・インスタンス選択肢

Claude Codeの要件でCloud9に関わるのは、OS、RAM、ネットワークの3つです。OSはUbuntu 20.04以降、Debian 10以降、Alpine Linux 3.19以降などで、ネットワークはインターネット接続が必須です。

Cloud9のEC2環境では、プラットフォームとしてAmazon Linux 2023、Amazon Linux 2、Ubuntu 22.04 LTSの3つから選べます。AWSはコンソール上でAmazon Linux 2023を推奨しています。

ただし、Claude CodeのOS一覧にAmazon Linuxはありません。apt・dnf・apkで入れる方法の対象もDebian、Fedora、RHEL、Alpineで、Amazon Linuxは載っていません。Ubuntu 22.04 LTSなら一覧の「Ubuntu 20.04以降」に収まるので、この記事ではUbuntu 22.04 LTSを前提にします。

インスタンスタイプは、メモリとClaude Codeとの適合で次のように分かれます。

Claude CodeはOSやエディタ、依存パッケージと同じインスタンスで動きます。OSやエディタと分け合うので、4GiBちょうどでは余裕が小さくなります。継続して使うなら、8GiB級を選ぶ選択肢があります。

無料利用枠の対象は、アカウントの作成日で変わる

小さいインスタンスは無料利用枠とも重なります。2025年7月15日より前に作ったアカウントでは、対象のインスタンスタイプがt2.microとt3.microだけで、どちらもメモリは1GiBです。

2025年7月15日以降に作ったアカウントでは、対象がt3.micro、t3.small、t4g.micro、t4g.small、c7i-flex.large、m7i-flex.largeに広がります。このうちc7i-flex.largeは4GiB、m7i-flex.largeは8GiBで、Claude Codeの要件を満たします。

つまり、旧方式のアカウントでClaude Codeを動かすには、無料利用枠から外れるt3.medium以上を選ぶことになります。

4GB以上のインスタンスでCloud9環境を作る手順

コンソールとCLIのどちらでも、変えるのはインスタンスタイプとプラットフォームの2点です。

--image-idのUbuntu 22.04用の値は、APIリファレンスがubuntu-22.04-x86_64として載せています。同じ一覧にあったUbuntu 18.04は、2024年12月16日から選択肢に含まれません。標準サポートが終わっているため、APIリファレンスもUbuntu 22.04を勧めています。

aws cloud9 create-environment-ec2 \
  --name claude-code-env \
  --instance-type t3.medium \
  --image-id resolve:ssm:/aws/service/cloud9/amis/ubuntu-22.04-x86_64 \
  --region ap-northeast-1 \
  --connection-type CONNECT_SSM \
  --subnet-id subnet-xxxxxxxx

--connection-type CONNECT_SSMはチュートリアルと同じ指定で、Systems Manager経由で接続します。リージョンとサブネットIDは自分の環境の値に置き換えてください。

Cloud9のインスタンスにClaude Codeを入れて確認する

インスタンスを作れたら、あとの手順はほかのLinux環境と同じです。インストーラーはインターネットから取得するので、インスタンスから外へ通信できることが前提です。Cloud9のターミナルでネイティブインストーラーを実行します。

curl -fsSL https://claude.ai/install.sh | bash

終わったら新しいターミナルを開き、claude --versionを実行します。v2.1.289で出力は次の1行でした。

2.1.289 (Claude Code)

claudeが見つからないと表示された場合は、インストール先のディレクトリがPATHに含まれていません。ネイティブインストーラーは~/.local/bin/claudeにランチャーを置くので、そこをPATHに加えれば解消します。

動作が重いときの切り分けには、セッションを始めずに診断だけを出すclaude doctorが使えます。v2.1.289のclaude doctor --helpは次のとおりです。

Usage: claude doctor [options]
 
Check the health of your Claude Code installation. Reads settings files in the
current directory without a trust prompt. For a full checkup that can also fix
issues, run /doctor in a session.

特定のバージョンを入れたいときはclaude install [target]を使い、targetにはstable、latest、バージョン番号を渡せます。

ripgrepは通常Claude Codeに含まれるので、Cloud9側で別に入れる必要はありません。検索コマンドが動かないときだけ、ripgrepの有無を個別に見ます。

小さいインスタンスで作ってしまった環境を復旧する

Cloud9のIDEは、メモリやCPUが逼迫すると警告を出します。文言は「This environment is running low on memory」と「This environment has high CPU load」です。複数セッションや共同編集で小さいインスタンス(t2.nano、t2.micro)に負荷がかかると、最小限のコード補完エンジンへ切り替えたというメッセージも出ます。対処は3段階で挙げられています。

最初の手は、動いているプロセスを止めて空きメモリを増やすことです。次がスワップファイルの追加、最後がより大きいインスタンスへの変更です。Claude Codeの要件に届かない小さいタイプで作った環境では、最初の2つでしのぎ切れるとは限りません。

スワップのコマンドは、ドキュメントでは次のとおりです。/etc/fstabに書くので、再起動後も有効です。

sudo fallocate --length 512MB /var/swapfile && sudo chmod 600 /var/swapfile && \
  sudo mkswap /var/swapfile && \
  echo '/var/swapfile swap swap defaults 0 0' | sudo tee -a /etc/fstab > /dev/null
sudo swapon /var/swapfile

swaponを実行すると、再起動を待たずにすぐ使えるようになります。使われているかどうかはtopで見られます。Swap:の行に0でない値が出ていれば有効です。

1GiBのインスタンスに512MBを足しても、Claude Codeの4GB要件には届きません。ディスクを介するぶん速度も落ちるため、スワップは一時的な補いとして使い、長く使うならタイプ変更に切り替える流れになります。

AWS Cloud9でよくあるつまずき

• 環境を作れない: 新規顧客のアクセスは2024年7月25日で終了しています。既存顧客の範囲を、アカウント単位と組織単位のどちらで見るかは、ブログとユーザーガイドに書かれていません。判断が付かない場合の問い合わせ先はAWSサポートです
• アカウントを作り直せば使えるか: 作り直しで通るかどうかは、ブログにもユーザーガイドにも書かれていません。無料利用枠の条件は、アカウントの作成日で変わります。Cloud9を使うこと自体は、新規顧客の区分に当たるかどうかで決まります。判断が付かない場合はAWSサポートに問い合わせてください
• プライベートサブネットだとインターネットに出られない: ユーザーガイドは、プライベートサブネットにはNATゲートウェイが必要だと書いています。Claude Codeはインターネット接続が要件なので、NATゲートウェイがなければ起動後に通信が通りません
• 一時的なマネージド認証情報が使えない: サブネットの説明のなかに、AWSの一時的なマネージド認証情報はIAMユーザーなどの代理としては使えない、という注意書きがあります。Bedrock経由で認証する構成なら、認証エラーの原因を切り分ける材料になります。固定のBedrock認証情報を使いたいときは、AWS_BEARER_TOKEN_BEDROCKとはで扱う環境変数があります。切り分けは「AWS default-chain credential resolve timed out」の対処とAWS authentication failedの原因と対処にあります
• ディスクが先に埋まる: 環境のボリュームは既定で10GiBです。node_modulesやビルド成果物が増えると、RAMより先にディスクが足りなくなります。ボリュームの拡張手順は、環境の移動と同じドキュメントページにあります

まとめ

Cloud9でClaude Codeを動かせるのは、すでにCloud9を使っている顧客だけです。そのうえで、インスタンスはt3.medium以上、プラットフォームはUbuntu 22.04 LTSにそろえると、Claude Codeの要件と合います。小さいタイプで作った環境は、タイプ変更を先に考えるほうが筋が通ります。