1️⃣ はじめに：この記事でできるようになること

AWSを使い始めたとき、「まず何から設定すればいいのか」で詰まる人は多いです。

この記事では、AWSコンソールでアクセスキーを作成するところから、VSCodeのAWS ToolkitでAWSリソースを操作できるようになるまでを、初心者でも迷わない粒度で解説します。

この記事で学べること

• IAMユーザーの作成とアクセスキー発行の正しい手順
• AWS CLI のインストールと aws configure の設定
• 接続確認の方法（よく使うコマンド）
• VSCode + AWS Toolkit のインストールと接続設定
• プライベート用・会社用など複数環境の切り替え方
• よくあるエラーと対処法

対象読者

• AWSアカウントを作成したけど次に何をすればいいか迷っている方
• ローカルPCからAWS CLIやVSCodeで操作したい方
• aws toolkit の使い方を知りたい方
• プライベート用と会社用でAWS環境を使い分けたい方

前提条件

• ✅ AWSアカウントを作成済み
• ✅ VSCodeをインストール済み
• ✅ インターネット接続あり

Amazon検索[本 AWS 開発]

2️⃣ 全体の流れ

この記事で設定する手順の全体像です。

STEP 1: IAMユーザー作成
    ↓
STEP 2: アクセスキー発行
    ↓
STEP 3: AWS CLI インストール
    ↓
STEP 4: aws configure で認証情報を設定
    ↓
STEP 5: 接続確認
    ↓
STEP 6: VSCode に AWS Toolkit をインストール・接続
    ↓
完了！VSCodeからAWSリソースを操作できる

なぜこの順番なのかも順を追って説明します。

3️⃣ STEP 1｜IAMユーザーを作成する

なぜルートアカウントを使わないのか？
AWSアカウント作成時の「ルートユーザー」は全権限を持つため、日常利用は危険です。IAMユーザーを作成して権限を適切に管理するのがAWSのベストプラクティスです。

1-1. AWSコンソールにログイン

1. AWSコンソール を開く
2. 「ルートユーザー」を選択し、メールアドレスとパスワードでログイン

1-2. IAMサービスを開く

1. 画面上部の検索バーに IAM と入力してクリック
2. 左メニュー「ユーザー」→「ユーザーの作成」をクリック

1-3. ユーザー情報を入力

ユーザー名: 任意（例: vscode-user-private）
AWSマネジメントコンソールへのアクセスを提供する: チェックしない
（CLIのみ使うなら不要）

「次へ」をクリック。

1-4. 許可ポリシーを設定

「ポリシーを直接アタッチする」を選択
→ 検索欄に「AdministratorAccess」と入力
→ チェックを入れる

学習用なら AdministratorAccess で OK。
本番環境では必要最小限の権限（最小権限の原則）に絞ることを推奨します。

「次へ」→「ユーザーの作成」をクリック。

4️⃣ STEP 2｜アクセスキーを発行する

2-1. 作成したユーザーを開く

1. IAM → ユーザー → 作成したユーザー名をクリック
2. 「セキュリティ認証情報」タブをクリック

2-2. アクセスキーを発行

1. 「アクセスキーを作成」ボタンをクリック
2. ユースケースを選択する画面で以下を選択

「コマンドラインインターフェイス (CLI)」を選択
「上記のレコメンデーションを理解し、アクセスキーを作成します」にチェック

3. 説明タグを入力（任意。例: vscode-private）
4. 「アクセスキーを作成」をクリック

2-3. キー情報を保存する ⚠️ 必ず保存！

アクセスキー ID:     AKIA○○○○○○○○○○○○○○○○
シークレットアクセスキー: ○○○○○○○○○○○○○○○○○○○○○○○○○○○○○○○○

重要: この画面を閉じるとシークレットアクセスキーは二度と表示されません。
「.csvファイルをダウンロード」ボタンで必ずローカルに保存してください。

5️⃣ STEP 3｜AWS CLI をインストールする

AWS CLI は、コマンドラインからAWSを操作するためのツールです。aws configure もこれを使って実行します。

Windowsの場合

1. 以下のURLからインストーラーをダウンロード
   • https://awscli.amazonaws.com/AWSCLIV2.msi
2. ダウンロードした .msi ファイルをダブルクリックして実行（デフォルト設定でOK）
3. インストール完了後、VSCodeのターミナルまたはPowerShellを再起動

インストール確認：

aws --version

出力例：

aws-cli/2.x.x Python/3.x.x Windows/10 ...

Mac の場合

brew install awscli

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

Linux の場合

# インストーラーをダウンロード＆実行
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install

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

6️⃣ STEP 4｜aws configure で認証情報を設定する

設定コマンドを実行

VSCodeのターミナル（Git Bash 推奨）を開いて以下を実行：

aws configure

対話形式で4項目を入力します：

AWS Access Key ID [None]: AKIA○○○○○○○○○○○○○○○○     ← STEP2で取得したID
AWS Secret Access Key [None]: ○○○○○○○○○○○○○○○○○○○○    ← STEP2で取得したキー
Default region name [None]: ap-northeast-1             ← 東京リージョン（推奨）
Default output format [None]: json                     ← json推奨（tableも可）

設定内容を確認する

aws configure list

出力例：

      Name                    Value             Type    Location
      ----                    -----             ----    --------
   profile                <not set>             None    None
access_key     ****************XXXX shared-credentials-file
secret_key     ****************XXXX shared-credentials-file
    region             ap-northeast-1      config-file    ~/.aws/config

設定ファイルの保存場所

aws configure を実行すると、以下の2つのファイルに設定が保存されます：

C:\Users\<ユーザー名>\.aws\
├── config       ← リージョン・出力形式が保存される
└── credentials  ← アクセスキー・シークレットキーが保存される（平文）

config ファイルの中身：

[default]
region = ap-northeast-1
output = json

credentials ファイルの中身：

[default]
aws_access_key_id = AKIA○○○○○○○○○○○○○○○○
aws_secret_access_key = ○○○○○○○○○○○○○○○○○○○○

注意: credentials ファイルはGitに絶対コミットしないこと。
.gitignore に .aws/ を追加することを強く推奨します。

7️⃣ STEP 5｜接続確認

設定が正しいか確認するコマンドを実行します。作業前に毎回実行する習慣をつけることを推奨します。

aws sts get-caller-identity

成功した場合の出力例：

{
    "UserId": "AIDA○○○○○○○○○○○○○○",
    "Account": "123456789012",
    "Arn": "arn:aws:iam::123456789012:user/vscode-user-private"
}

• Account が自分のAWSアカウントID
• Arn に user/<作成したユーザー名> が表示されていれば接続成功

試しにS3バケット一覧を確認する場合：

aws s3 ls

（バケットがなければ何も表示されませんが、エラーが出なければOK）

8️⃣ STEP 6｜VSCode に AWS Toolkit をインストール・接続する

AWS Toolkit は、VSCodeからAWSリソースをGUI操作できる公式拡張機能です。Lambda関数の編集・実行、S3バケットの参照、CloudFormationスタックの確認などが手軽にできます。

6-1. 拡張機能のインストール

1. VSCode の左サイドバー「拡張機能」アイコンをクリック（または Ctrl+Shift+X）
2. 検索欄に AWS Toolkit と入力
3. 「AWS Toolkit」（発行者: Amazon Web Services）が表示されたら「インストール」をクリック

6-2. AWS に接続する

1. VSCode 左サイドバーに「AWS」アイコンが追加される
2. クリック → 「Connect to AWS」（またはAWSアイコン横の設定）
3. プロファイルを選択する画面で default を選択
   （aws configure で設定したプロファイルが表示されます）

6-3. リージョンを追加する

1. AWS Toolkit パネル内の「EXPLORER」エリアを右クリック
2. 「Add Region...」をクリック
3. ap-northeast-1（Asia Pacific - Tokyo） を選択

6-4. 接続確認

AWS Toolkit パネルに Lambda・S3・CloudFormation などのサービスツリーが表示されれば接続成功です。

AWS Toolkit でできる主な操作

9️⃣ 複数環境を切り替える（プライベート用・会社用）

プライベート用と会社用など、複数のAWS環境を使い分ける場合は名前付きプロファイルを使います。

会社用プロファイルを追加する

# 会社用プロファイルとして追加
aws configure --profile company

AWS Access Key ID [None]: AKIA○○○○（会社用）
AWS Secret Access Key [None]: ○○○○（会社用）
Default region name [None]: ap-northeast-1
Default output format [None]: json

~/.aws/credentials の中身（複数プロファイルの例）

[default]
aws_access_key_id = AKIA○○○○（プライベート用）
aws_secret_access_key = ○○○○

[company]
aws_access_key_id = AKIA○○○○（会社用）
aws_secret_access_key = ○○○○

プロファイルを指定してコマンドを実行する

# 会社用プロファイルで接続確認
aws sts get-caller-identity --profile company

# 会社用プロファイルでS3一覧を取得
aws s3 ls --profile company

環境変数で一時的に切り替える（Git Bash）

# 会社用環境に切り替え
export AWS_PROFILE=company

# このターミナルセッション中は会社用として実行される
aws sts get-caller-identity

# プライベート用（default）に戻す
unset AWS_PROFILE

重要: 作業前に必ず aws sts get-caller-identity を実行して、どちらの環境で操作しているか確認する習慣をつけましょう。プライベート用と会社用を混同すると、意図しないリソースに変更を加えてしまう危険があります。

VSCode AWS Toolkit でプロファイルを切り替える

1. VSCode の AWS Toolkit パネルで接続中のプロファイル名が表示されている箇所をクリック
2. 「Switch Connections」→ 切り替えたいプロファイルを選択

🔟 よくあるエラーと対処法

エラーの原因を調べる方法

# --debug オプションで詳細ログを出力
aws sts get-caller-identity --debug

# 設定中のプロファイルを確認
aws configure list

# 設定済みプロファイル一覧を確認
aws configure list-profiles

1️⃣1️⃣ セキュリティの注意事項

AWS環境を安全に使うために、以下の点に注意してください。

アクセスキーの管理

• ❌ アクセスキーをコードにハードコードしない
• ❌ .aws/credentials ファイルをGitにコミットしない（.gitignore に追加）
• ❌ Slackやメールなどでキーを共有しない
• ✅ 使わなくなったキーはIAMコンソールから削除または無効化する

.gitignore の設定例

# AWS認証情報
.aws/

# 環境変数ファイル
.env
*.env

権限設定のベストプラクティス

より安全な認証への移行

長期的には、アクセスキーよりも安全な認証方式への移行を検討してください：

• IAM Identity Center（SSO）: 一時的な認証情報を使用するため、より安全
• IAM Roles: EC2やLambdaなどのAWSサービスからアクセスする場合に使用

まとめ

この記事では、AWSをローカルのVSCodeから操作できるようになるまでの全手順を解説しました。

今回設定したこと

• ✅ IAMユーザー作成：ルートアカウントを使わない安全な設定
• ✅ アクセスキー発行：CLIからのアクセスに必要な認証情報
• ✅ AWS CLI インストール：コマンドラインでAWSを操作するためのツール
• ✅ aws configure 設定：認証情報をローカルに設定
• ✅ 接続確認：aws sts get-caller-identity で正しく接続できているか確認
• ✅ VSCode + AWS Toolkit：GUIでAWSリソースを操作できる環境の構築
• ✅ 複数環境の切り替え：プライベート用・会社用を混同しない設定

次のステップ

この環境があれば、以下のような開発をすぐに始められます：

• EC2インスタンスの構築：仮想サーバーを立ち上げて実際のWebサーバーを作る
• Lambda関数の開発：VSCodeから直接Lambda関数を作成・デプロイ
• CloudFormationによるIaC：インフラをコードで管理する
• SAMを使ったサーバーレス開発：API Gateway + Lambdaの構成を手軽に構築

Amazon検索[本 AWS 開発]

参考リンク：

• AWS CLI 公式ドキュメント
• AWS Toolkit for Visual Studio Code 公式
• IAM ベストプラクティス

関連記事：

• 【実践】VSCodeとCloudFormationで学ぶAWS EC2構築｜コードでインフラ管理

【実践】VSCodeとCloudFormationで学ぶAWS EC2構築｜コードでインフラ管理

1️⃣ はじめに：なぜCloudFormationを使うのか？AWSマネジメントコンソールでのEC2構築は直感的ですが、再現性と管理性に課題があります。手動構築の課題❌ 同じ構成を再現するのが難しい❌ 設定ミスが発生しやすい❌ 変更履歴が残...

caymezon.com

2026.01.10

• 【AWS初心者向け】EC2キーペア作成の完全ガイド

【AWS初心者向け】EC2キーペア作成の完全ガイド｜AWSコンソールとCLIの2つの方法

1️⃣ はじめに：EC2キーペアとは？AWS EC2インスタンスにSSH接続するためには、**キーペア（.pemファイル）**が必要です。キーペアの役割認証方式：パスワードではなく公開鍵暗号方式でセキュアに接続用途：EC2インスタンスへのS...

caymezon.com

2026.01.10

最終更新： 2026年2月20日

The post 【初心者向け】AWS環境構築完全ガイド｜アクセスキー作成からVSCode+AWS Toolkitで開発できるまでの全手順 first appeared on CayTech Lab.