Amazon Q Developer Limits: 50 Requests and 1,000 Transformation Lines
Amazon Q Developer restricts Free Tier accounts to 50 agentic requests and 1,000 lines of code transformation per month. The $19 per user per month Pro Tier plan provides unthrottled agentic interactions and 4,000 pooled transformation lines per user. In the IDE, context is bounded by active project files and security review ceilings. Teams bypass local context limits by connecting to indexed workspace knowledge via the Model Context Protocol.
What Are the Limits of the Amazon Q Developer Free Tier?
Amazon Q Developer restricts Free Tier users to 50 agentic requests and 1,000 lines of code transformation per month, according to AWS documentation updated on September 25, 2026.
Amazon Q Developer limits define the usage allowances for AWS's generative AI coding companion, spanning IDE chat limits, CLI agent prompts, and autonomous code transformation quotas across Free and Pro tiers.
Engineering teams evaluating Amazon Q Developer often confuse commercial pricing with runtime operational ceilings. While the service provides an accessible entry point for individual builders, production workflows hit technical guardrails quickly if developers do not track how monthly quotas draw down. An agentic request comprises any conversational interaction or autonomous coding task initiated in an integrated development environment (IDE) or the Command Line Interface (CLI). When a developer asks the assistant to explain an unfamiliar codebase, produce a unit test suite, or apply multi-file code diffs, each prompt consumes one unit from the monthly 50-request allotment.
Authentication method dictates where and how Free Tier limits apply. In desktop IDEs such as Visual Studio Code and JetBrains IDEs, Free Tier access requires an individual AWS Builder ID rather than organization credentials. AWS Identity and Access Management (IAM) users can use conversational chat in the AWS Management Console under Free Tier rules, but local editor extensions remain tied to Builder ID profiles.
Beyond conversational interactions, Free Tier accounts operate under specific code security and review quotas:
- Included agentic requests: 50 requests per month covering conversational Q&A and agentic code updates in IDEs and the CLI.
- Code transformation volume: 1,000 lines of code per month per user dedicated to Java language version upgrades.
- Code security scans: A monthly allocation of 50 scans to identify vulnerabilities and insecure dependencies across local files.
- Input artifact size for auto-scans: Capped at 200 KB for background scans triggered automatically upon saving files.
- Input artifact size for project reviews: Maximum footprint of 500 megabytes across the local repository workspace, including third-party libraries and build archives.
- Source code review ceiling: Maximum scan volume of 50 megabytes of raw source code after stripping unsupported file formats and dependencies.
When a developer reaches the 50-request monthly ceiling, Amazon Q Developer stops responding to interactive prompts in the chat panel. The plugin presents an HTTP 400 response code or an inline alert stating that the monthly usage limit has been reached. Operations pause until the first day of the following calendar month unless the user attaches an active AWS billing account and transitions to the Pro Tier plan.
Related guides
- ChatGPT Character Limits: The 25,000-Character Paste Limit and SolutionsThe ChatGPT web interface enforces a frontend paste limit that triggers truncation warnings or forces file attachment...
- AWS Strands Agents: Build AI Agents with Amazon's Agent FrameworkAWS Strands Agents is Amazon's open-source Python framework for building AI agents that use tools, maintain memory, and...
- HTTP 413 Request Entity Too Large: Causes, Server Limits & WorkaroundsAn HTTP 413 request entity too large error occurs when a client payload exceeds buffer limits configured on a web...
- Salesforce Agentforce Limits: Tokens, Context Windows, and Grounding File CapsAgentforce limits establish operational boundaries for autonomous AI across Salesforce, including a 1.5 million hourly...
- AWS Bedrock Token Limits: Model Output Caps, Converse API Parameters, and QuotasAn AWS Bedrock token limit refers to the parameter-enforced boundaries on input prompt length and maximum generated...
- Can ChatGPT Access OneDrive? Workflows, Admin Limits & Fast StorageChatGPT can access OneDrive files through its cloud storage connector, but personal accounts remain unsupported while...
More on this subject: AI Agents: General Guides (172 guides)
What Is the Difference Between Amazon Q Developer Free and Pro?
Amazon Q Developer divides capabilities between a perpetual Free Tier for individual developers and a Pro Tier priced at $19 per user per month for organizations. The primary difference lies in governance, execution capacity, and financial pooling. The Free Tier functions as a personal sandbox without central administrative oversight, while the Pro Tier connects to AWS IAM Identity Center to provide single sign-on, centralized policy enforcement, intellectual property indemnity, and shared compute allowances.
The following comparison details the operational limits and organizational boundaries across both tiers:
How account-level pooling operates on the Pro Tier
A critical architectural distinction for engineering managers is how Pro Tier code transformation allowances aggregate. Unlike Free Tier limits, which remain locked to individual Builder ID profiles, Pro Tier transformation quotas pool automatically at the AWS payer-account level. Each active Pro subscription contributes 4,000 lines of code to a shared monthly pool accessible by all licensed developers in the organization.
Consider an engineering department with 10 active Pro Tier subscriptions. The organization receives a shared allowance of 40,000 lines of code (10 users multiplied by 4,000 lines) per month. If one developer runs a modernization job on a legacy service containing 50,000 lines of code while other engineers run smaller tasks, the pooled quota absorbs the initial 40,000 lines. The billing engine meters the remaining 10,000 lines under standard usage overage pricing at fractions of a cent per line, generating a predictable charge on the monthly invoice.
This pooling model prevents individual team members from stalling during large refactoring jobs. However, organizations must configure AWS Budgets and CloudWatch billing alerts to monitor consumption. Because the transformation engine reverts to pay-as-you-go pricing after exhausting the pooled allowance, uncontrolled automated scripts can generate unexpected charges if developers repeatedly submit entire monolithic codebases without filtering build directories.
Provide persistent reference context to your coding agents
Organize architecture specs, schema files, and migration guides in an intelligent workspace. Let agents search indexed documentation via MCP without flooding local context windows. Starts with a 14-day free trial requiring a credit card.
How many code transformations does Amazon Q Developer allow?
Amazon Q Developer transformation capabilities automate complex language upgrades and cross-platform framework migrations. The service supports two primary modernization workflows: upgrading Java applications from versions 8, 11, 17, or 21 to target versions 17 or 21, and porting Windows-based .NET Framework applications (version 3.5 and higher, .NET Core 3.1, and .NET 5 through 7) to cross-platform .NET 8 on Linux.
Job limits and monthly allowances govern how much code the transformation agent can process:
- Lines of code per job: 100,000 lines of code per single transformation submission.
- Monthly Free Tier allowance: 1,000 lines of code per user per month.
- Monthly Pro Tier allowance: 4,000 lines of code per user per month, pooled across the payer account.
- Monthly .NET porting ceiling: The 100,000 lines of code per job quota serves as the monthly total ceiling for .NET transformations.
Resolving legacy job counts versus lines-of-code metering
Early documentation, developer previews, and third-party guides frequently cited quotas of 5 code transformations per month on the Free Tier and 500 transformations on the Pro Tier. Modern production versions of Amazon Q Developer meter usage strictly by lines of code (LOC) rather than discrete transformation counts.
Relying on legacy assumptions can mislead teams during sprint planning. Under modern billing rules, submitting a 500-line microservice consumes 500 lines from your monthly allocation, whereas submitting a 20,000-line monolith consumes 20,000 lines. Tracking lines of code provides a much more granular assessment of compute consumption than counting jobs.
Rules for calculating billable transformation lines
The transformation engine applies strict filtering rules when calculating consumed lines:
- Successful completions only: The service counts lines of code only when the transformation agent completes analysis and returns suggested modernization code diffs for review.
- Aborted jobs excluded: If an engineer cancels a running transformation task before the agent finishes generating suggestions, no lines are deducted from the monthly quota.
- Build failure exclusions: If the agent fails to compile the application due to missing third-party dependencies or broken build configurations, the job is not billed against the account.
- Non-code filtering: The parser strips blank lines, whitespace formatting, and inline comments before calculating billable code volume. Only executable syntax and structural declarations contribute to the final count.
Developers initiate transformations directly within Visual Studio Code or JetBrains IDEs using the AWS Toolkit, within Visual Studio for .NET modernization, or through the terminal using the q transform command. The CLI command packages the local project workspace, uploads artifacts to an isolated AWS build container, executes automated AST transformations, and streams progress updates back to the developer terminal.
What are the context caps and repository indexing limits in the IDE?
Amazon Q Developer relies on foundation models from the Anthropic Claude family, hosted securely through Amazon Bedrock. Like all Large Language Models, the underlying model operates within a finite token context window. In the IDE, this context window is shared among conversational history, active code editor tabs, highlighted snippets, and background repository indexes.
Understanding how the assistant builds context prevents developers from overloading the model with irrelevant files. Amazon Q constructs context using two distinct mechanisms:
- Conversational context: Prior user questions, model explanations, and generated diffs retained within the active chat session panel.
- Repository context: Files, directory trees, and symbols indexed across the locally opened workspace when a user prefixes prompts with
@workspace.
IDE repository indexing boundaries and security ceilings
When developers invoke @workspace, Amazon Q Developer scans the local file tree to build a semantic index of classes, interfaces, and function signatures. This indexing enables the model to identify cross-file dependencies and generate code that matches project conventions.
However, local workspace indexing is constrained by memory and security review ceilings:
- Auto-scan input artifact size: 200 KB ceiling for automatic background scanning.
- Project review artifact ceiling: Maximum footprint of 500 megabytes across the local workspace, including libraries, build outputs, and archive files.
- Source code scan ceiling: Maximum volume of 50 megabytes of raw source code after excluding binaries and third-party vendor directories.
If a repository exceeds these file size ceilings, the indexing agent skips large sections of the codebase or rejects the scan entirely.
Terminal context management commands
In the Amazon Q Developer CLI, developers can directly inspect and manage context window consumption using native slash commands:
/usage: Prints a real-time estimate of current context window usage, showing the proportion of available tokens consumed by conversation history and project files./compact: Analyzes conversation history and generates a condensed summary of key decisions, purging verbose compiler logs and intermediate code revisions while preserving critical variable names and architectural constraints./clear: Flushes the entire conversational context, resetting the token counter to zero for a clean coding session.
Private code customizations
Pro Tier organizations can extend contextual awareness beyond local editor files by configuring private code customizations in the AWS Management Console. Administrators can connect enterprise Git repositories stored in GitHub, GitLab, or AWS CodeCommit to customize inline code completions:
- Total customizations: Up to 8 private code customizations can be defined per AWS account.
- Active customizations: Up to 2 code customizations can remain active simultaneously.
- Supported languages: Customization training supports Java, JavaScript, TypeScript, and Python. Repositories written in other languages are ignored during customization indexing.
Failure modes during context saturation
When a coding project exceeds local context boundaries, developers experience recognizable failure patterns. The model may drop earlier prompt instructions, produce incomplete code diffs that truncate mid-function, or hallucinate imports for modules that exist elsewhere in the monorepo. When these symptoms appear, developers must compact conversational history or decouple external technical documentation from the local editor workspace.
How can engineering teams handle large documentation without context exhaustion?
Modern software development demands deep architectural context. Coding assistants need access to API schemas, database dictionaries, deployment runbooks, and corporate compliance standards to generate production-ready code. However, loading hundreds of pages of technical documentation directly into IDE context windows exhausts token allowances and causes local assistants to lose track of immediate programming tasks.
Engineering teams typically evaluate several storage strategies to supply external documentation to their coding agents:
- Local file storage: Placing documentation inside local project directories increases repository size and forces local indexing engines to parse massive markdown files, rapidly consuming IDE context budgets.
- Amazon S3 object storage: S3 provides scalable raw storage for files, but it lacks built-in semantic chunking, document search APIs, and a unified workspace interface for human-agent collaboration.
- Consumer cloud storage: Services like Google Drive or Dropbox synchronize desktop files, but their APIs impose strict rate limits when accessed concurrently by autonomous coding agents.
Intelligent workspaces solve this operational bottleneck by acting as a persistent knowledge coordination layer. Instead of forcing local coding assistants to swallow entire documentation libraries, teams maintain their technical corpus in Fast.io shared workspaces.
Fast.io workspaces provide persistent storage for AI agents, allowing human developers and autonomous assistants to collaborate around a single, versioned source of truth. Teams upload architectural decision records, OpenAPI specifications, and integration manuals once. Through Fast.io Workspace Intelligence, files are automatically indexed for semantic search upon arrival, eliminating the need to deploy and manage a separate vector database.
Coding assistants connect to Fast.io workspaces over Streamable HTTP through the remote Model Context Protocol (MCP) server at https://mcp.fast.io/mcp/code (or https://mcp.fast.io/mcp/tools for general applications). Using standardized MCP actions, the coding agent queries indexed documentation on demand. When implementing a new payment webhook or database migration, the assistant searches the workspace, retrieves only the relevant schema definitions or interface contracts, and injects precise snippets into its prompt. Local context windows remain clean and focused on code generation.
For teams operating multiple autonomous agents, Fast.io workspaces preserve per-file version history and a detailed activity log, tracking every read and write across the organization. Advisory file locks (lock-acquire and lock-release on the storage_manage tool) coordinate agent access, while ownership transfer capabilities allow agents to build workspace structures and hand them off directly to human project owners.
Organizations can evaluate Fast.io on paid monthly subscriptions that begin with a 14-day free trial requiring a credit card. Subscriptions scale across transparent organizational tiers on Fast.io pricing:
Additional AI credits can be purchased as team usage expands.
Sources
References used to verify factual claims in this guide.
-
Amazon Q Developer limits include 50 agentic requests per month and 1,000 lines of code transformation on Free Tier, with Pro Tier subscriptions allocating 4,000 lines per user pooled at account level with overage pricing.
-
Amazon Q Developer allows organizations to configure up to eight private code customizations with up to two customizations active simultaneously.
Frequently Asked Questions
What are the limits of the Amazon Q Developer Free Tier?
The Amazon Q Developer Free Tier includes 50 agentic requests per month for conversational Q&A and code generation in the IDE and CLI, along with 1,000 lines of code per month for Java version upgrades. It also provides 50 code security scans per month with a 200 KB auto-scan limit and a 500 megabyte project review limit. Free Tier IDE access requires authentication with an individual AWS Builder ID.
How many code transformations does Amazon Q Developer allow?
Amazon Q Developer permits single transformation jobs of up to 100,000 lines of code across supported Java and .NET applications. Free Tier users can transform up to 1,000 lines of code per month, while Pro Tier users receive 4,000 lines of code per user per month pooled at the AWS payer-account level. Unused pooled allowances can be extended through standard pay-as-you-go overage pricing.
What is the difference between Amazon Q Developer Free and Pro?
Amazon Q Developer Free Tier provides 50 monthly agentic requests and 1,000 lines of transformation for individual users authenticated via AWS Builder ID. The Pro Tier costs $19 per user per month, requires AWS IAM Identity Center, and provides expanded agentic requests, 4,000 pooled transformation lines per user, up to 8 private code customizations, an administrative management dashboard, and enterprise intellectual property indemnity.
What happens when an organization exceeds its Pro Tier transformation allowance?
When a team exhausts its pooled transformation quota on the Pro Tier, Amazon Q Developer automatically transitions to pay-as-you-go billing. Additional lines submitted for transformation are charged under standard overage pricing on the organization's monthly AWS bill. Administrators can monitor consumption through AWS Cost and Usage Reports and establish spending caps using AWS Budgets.
How does Amazon Q Developer calculate lines of code for transformation billing?
Amazon Q Developer calculates lines of code based on executable source lines submitted in jobs that successfully return suggested upgrade code diffs. The metering engine excludes blank lines, comments, whitespace formatting, jobs cancelled by the user prior to completion, and jobs that fail during initial environment builds.
Can Amazon Q Developer index documentation outside the active local IDE workspace?
Within the IDE, Amazon Q Developer indexing is restricted to locally opened workspace directories and up to two active private code customizations configured in the AWS console. To reference extensive external documentation, OpenAPI schemas, or company architecture manuals without exhausting local context windows, teams store reference corpora in intelligent workspaces and connect coding assistants via MCP.
Related Resources
Provide persistent reference context to your coding agents
Organize architecture specs, schema files, and migration guides in an intelligent workspace. Let agents search indexed documentation via MCP without flooding local context windows. Starts with a 14-day free trial requiring a credit card.