# aws-exploration-credits
A [Claude Code](https://claude.com/claude-code) skill (plus a standalone bash script) that claims the
**AWS new-account "exploration activities" credits — up to $100** — for less than $0.05 of real spend.
AWS accounts created after **2025-07-15** get $100 at signup and can earn **$20 more per activity**
by touching five services once:
| Activity | Credit | Automatable? |
|---|---|---|
| Launch an EC2 instance | $20 | ✅ CLI |
| Create a web app with Lambda (function + function URL) | $20 | ✅ CLI |
| Set up a cost budget in AWS Budgets | $20 | ✅ CLI |
| Create an Aurora or RDS database | $20 | ✅ CLI |
| Use a foundation model in the Bedrock playground | $20 | ⚠️ console only, 10 seconds (a Bedrock API inference did **not** count in testing) |
The script creates the four CLI-doable resources with the cheapest possible shapes
(`t4g.micro` EC2, `db.t4g.micro` Postgres with no backups, arm64 Lambda, one cost budget),
waits for them to register, then **terminates/deletes the billable ones automatically**.
The two leftovers (budget, idle Lambda) cost $0 — and `cleanup` removes those too.
## Use as a Claude Code skill
```bash
git clone https://github.com/guzus/aws-exploration-credits ~/.claude/skills/aws-exploration-credits
```
Then ask Claude Code: *"claim my AWS exploration activity credits"* — it reads `SKILL.md`,
checks eligibility, runs the script, and walks you through the one console step (Bedrock playground).
## Use standalone
```bash
# prerequisites: aws-cli v2 (mid-2025+ build with the `freetier` service), admin credentials configured
./scripts/claim.sh status # eligibility + remaining credits
./scripts/claim.sh run --region us-east-2 --email you@x.com # claim everything, then tear down
./scripts/claim.sh cleanup # optional: remove the $0 leftovers too
```
Activity statuses flip to `COMPLETED` asynchronously (minutes to a few days). Watch with
`./scripts/claim.sh status`, or see per-grant amounts and expiry in the console under
**Billing and Cost Management → Credits**.
## Notes
- Eligibility, amounts, and completion criteria are AWS's and can change; this repo reflects the
program as observed in July 2026 (activities expire ~6 months after account creation).
- One account per person. Farming credits across accounts violates the
[AWS Free Tier terms](https://aws.amazon.com/free/terms/) and gets accounts suspended.
- Run as an IAM user/role, not root.
## License
MIT