codinit-dev · Gerome-Elassaad · Dec 26, 2025 · Dec 26, 2025 · Dec 26, 2025 · Dec 26, 2025
diff --git a/providers/anthropic.mdx b/providers/anthropic.mdx
@@ -1,60 +1,43 @@
 ---
 title: "Anthropic"
-description: "Learn how to configure and use Anthropic Claude models with CodinIT. Covers API key setup, model selection, and advanced features like prompt caching."
+description: "Configure Anthropic Claude models with CodinIT for advanced reasoning and code generation."
 ---
 
 **Website:** [https://www.anthropic.com/](https://www.anthropic.com/)
 
-### Getting an API Key
+## Getting an API Key
 
-1.  **Sign Up/Sign In:** Go to the [Anthropic Console](https://console.anthropic.com/). Create an account or sign in.
-2.  **Navigate to API Keys:** Go to the [API keys](https://console.anthropic.com/settings/keys) section.
-3.  **Create a Key:** Click "Create Key". Give your key a descriptive name (e.g., "CodinIT").
-4.  **Copy the Key:** **Important:** Copy the API key _immediately_. You will not be able to see it again. Store it securely.
+1. Go to [Anthropic Console](https://console.anthropic.com/) and sign in
+2. Navigate to [API keys](https://console.anthropic.com/settings/keys)
+3. Click "Create Key" and name it (e.g., "CodinIT")
+4. Copy the key immediately - you won't see it again
 
-### Supported Models
+## Configuration
 
-CodinIT supports the following Anthropic Claude models:
+1. Click the settings icon (⚙️) in CodinIT
+2. Select "Anthropic" as the API Provider
+3. Paste your API key
+4. Choose your model
 
--   `claude-haiku-4-5-20251001`
--   `claude-opus-4-1-20250805`
--   `claude-opus-4-20250514`
--   `anthropic/claude-sonnet-4.5` (Recommended)
--   `claude-3-7-sonnet-20250219`
--   `claude-3-5-sonnet-20241022`
--   `claude-3-5-haiku-20241022`
--   `claude-3-opus-20240229`
--   `claude-3-haiku-20240307`
+## Supported Models
 
-See [Anthropic's Model Documentation](https://docs.anthropic.com/en/about-claude/models) for more details on each model's capabilities.
+- `anthropic/claude-sonnet-4.5` (Recommended)
+- `claude-opus-4-1-20250805`
+- `claude-3-7-sonnet-20250219`
+- `claude-3-5-sonnet-20241022`
+- `claude-3-5-haiku-20241022`
 
-### Configuration in CodinIT
+See [Anthropic's documentation](https://docs.anthropic.com/en/about-claude/models) for full model details.
 
-1.  **Open CodinIT Settings:** Click the settings icon (⚙️) in the CodinIT panel.
-2.  **Select Provider:** Choose "Anthropic" from the "API Provider" dropdown.
-3.  **Enter API Key:** Paste your Anthropic API key into the "Anthropic API Key" field.
-4.  **Select Model:** Choose your desired Claude model from the "Model" dropdown.
-5.  **(Optional) Custom Base URL:** If you need to use a custom base URL for the Anthropic API, check "Use custom base URL" and enter the URL. Most users won't need to adjust this setting.
+## Extended Thinking
 
-### Extended Thinking
+Enable enhanced reasoning for complex tasks by checking "Enable Extended Thinking" in CodinIT settings. Available for Claude Opus 4, Sonnet 4.5, and Sonnet 3.7.
 
-Anthropic models offer an "Extended Thinking" feature, designed to give them enhanced reasoning capabilities for complex tasks. This feature allows the model to output its step-by-step thought process before delivering a final answer, providing transparency and enabling more thorough analysis for challenging prompts.
+Learn more in the [Extended Thinking documentation](https://docs.anthropic.com/en/build-with-claude/extended-thinking).
 
-When extended thinking is in CodinIT, the model generates `thinking` content blocks that detail its internal reasoning. These insights are then incorporated into its final response.
-CodinIT users can leverage this by checking the `Enable Extended Thinking` box below the model selection menu after selecting a Claude Model from any provider.
+## Notes
 
-**Key Aspects of Extended Thinking:**
-
--   **Supported Models:** This feature is available for select models, including Claude Opus 4, Claude Sonnet 4.5, and Claude Sonnet 3.7.
--   **Summarized Thinking (Claude 4):** For Claude 4 and 4.5 models, the API returns a summary of the full thinking process to balance insight with efficiency and prevent misuse. You are billed for the full thinking tokens, not just the summary.
--   **Streaming:** Extended thinking responses, including the `thinking` blocks, can be streamed.
--   **Tool Use & Prompt Caching:** Extended thinking interacts with tool use (requiring thinking blocks to be passed back) and prompt caching (with specific behaviors around cache invalidation and context).
-
-For comprehensive details on how extended thinking works, including API examples, interaction with tool use, prompt caching, and pricing, please refer to the [official Anthropic documentation on Extended Thinking](https://docs.anthropic.com/en/build-with-claude/extended-thinking).
-
-### Tips and Notes
-
--   **Prompt Caching:** Claude 3 models support [prompt caching](https://docs.anthropic.com/en/build-with-claude/prompt-caching), which can significantly reduce costs and latency for repeated prompts.
--   **Context Window:** Claude models have large context windows (200,000 tokens), allowing you to include a significant amount of code and context in your prompts.
--   **Pricing:** Refer to the [Anthropic Pricing](https://www.anthropic.com/pricing) page for the latest pricing information.
--   **Rate Limits:** Anthropic has strict rate limits based on [usage tiers](https://docs.anthropic.com/en/api/rate-limits#requirements-to-advance-tier). If you're repeatedly hitting rate limits, consider contacting Anthropic sales or accessing Claude through a different provider like [OpenRouter](/providers/openrouter) or [Requesty](/providers/openrouter).
+- **Context Window:** 200,000 tokens
+- **Prompt Caching:** Reduces costs for repeated prompts
+- **Rate Limits:** Based on [usage tiers](https://docs.anthropic.com/en/api/rate-limits). Consider [OpenRouter](/providers/openrouter) if hitting limits
+- **Pricing:** See [Anthropic Pricing](https://www.anthropic.com/pricing)
diff --git a/providers/aws-bedrock.mdx b/providers/aws-bedrock.mdx
@@ -1,136 +1,79 @@
 ---
 title: "AWS Bedrock"
 sidebarTitle: "API Key"
-description: "Set up AWS Bedrock with CodinIT using Bedrock API Keys. Simplest setup for individual developers to access frontier models."
+description: "Set up AWS Bedrock with CodinIT using API Keys to access frontier models like Claude and Amazon Nova."
 ---
 
-### Overview
+Access leading AI models through AWS Bedrock with simplified API Key setup.
 
--   **AWS Bedrock:** A fully managed service that offers access to leading generative AI models (e.g., Anthropic Claude, Amazon Nova) through AWS.\
-    [Learn more about AWS Bedrock](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html).
--   **CodinIT:** A VS Code extension that acts as a coding assistant by integrating with AI models—empowering developers to generate code, debug, and analyze data.
--   **Developer Focus:** This guide is tailored for individual developers that want to enable access to frontier models via AWS Bedrock with a simplified setup using API Keys.
+**Website:** [https://docs.aws.amazon.com/bedrock/](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html)
 
----
-
-### Step 1: Prepare Your AWS Environment
-
-#### 1.1 Individual user setup - Create a Bedrock API Key
+## Setup Steps
 
-For more detailed instructions check the [documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/api-keys.html).
+### 1. Create Bedrock API Key
 
-1. **Sign in to the AWS Management Console:**\
-   [AWS Console](https://aws.amazon.com/console)
-2. **Access Bedrock Console:**
-    - [Bedrock Console](https://console.aws.amazon.com/bedrock)
-    - Create a new Long Lived API Key. This API Key will have by default the `AmazonBedrockLimitedAccess` IAM policy
-      [View AmazonBedrockLimitedAccess Policy Details](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html#managed-policies)
+1. **Sign in:** [AWS Console](https://aws.amazon.com/console)
+2. **Access Bedrock:** Go to [Bedrock Console](https://console.aws.amazon.com/bedrock)
+3. **Create API Key:** Create a new Long Lived API Key
+   - Default policy: `AmazonBedrockLimitedAccess`
+   - [View policy details](https://docs.aws.amazon.com/bedrock/latest/userguide/security-iam.html#managed-policies)
 
-#### 1.2 Create or Modify the Policy
+### 2. Configure IAM Permissions
 
-To ensure CodinIT can interact with AWS Bedrock, your IAM user or role needs specific permissions. While the `AmazonBedrockLimitedAccess` managed policy provides comprehensive access, for a more restricted and secure setup adhering to the principle of least privilege, the following minimal permissions are sufficient for CodinIT's core model invocation functionality:
+**Minimal permissions required:**
+```json
+{
+  "Version": "2012-10-17",
+  "Statement": [{
+    "Effect": "Allow",
+    "Action": [
+      "bedrock:InvokeModel",
+      "bedrock:InvokeModelWithResponseStream",
+      "bedrock:CallWithBearerToken"
+    ],
+    "Resource": "*"
+  }]
+}
+```
 
--   `bedrock:InvokeModel`
--   `bedrock:InvokeModelWithResponseStream`
--   `bedrock:CallWithBearerToken`
+Create custom policy and attach to IAM user associated with your API key.
 
-You can create a custom IAM policy with these permissions and attach it to your IAM user or role.
+**Important:**
+- For model listing in CodinIT, add `bedrock:ListFoundationModels` permission
+- For AWS Marketplace models (e.g., Anthropic Claude), use `AmazonBedrockLimitedAccess` policy
+- For Anthropic models, submit First Time Use (FTU) form via [Playground](https://console.aws.amazon.com/bedrock/home#/text-generation-playground)
 
-1.  In the AWS IAM console, create a new policy.
-2.  Use the JSON editor to add the following policy document:
-    ```json
-    {
-    	"Version": "2012-10-17",
-    	"Statement": [
-    		{
-    			"Effect": "Allow",
-    			"Action": ["bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:CallWithBearerToken"],
-    			"Resource": "*" // For enhanced security, scope this to specific model ARNs if possible.
-    		}
-    	]
-    }
-    ```
-3.  Name the policy (e.g., `CodinITBedrockInvokeAccess`) and attach it to the IAM user associated with the key you created. The IAM user and the API key have the same prefix.
+### 3. Choose Region
 
-**Important Considerations:**
-
--   **Model Listing in CodinIT:** The minimal permissions (`bedrock:InvokeModel`, `bedrock:InvokeModelWithResponseStream`) are sufficient for CodinIT to _use_ a model if you specify the model ID directly in CodinIT's settings. If you rely on CodinIT to dynamically list available Bedrock models, you might need additional permissions like `bedrock:ListFoundationModels`.
--   **AWS Marketplace Subscriptions:** For third-party models (e.g., Anthropic Claude), the **`AmazonBedrockLimitedAccess`** policy grants you the necessary permissions to subscribe via the AWS Marketplace. There is no explicit access to be enabled. For Anthropic models you are still required to submit a First Time Use (FTU) form via the Console. If you get the following message in the CodinIT chat `[ERROR] Failed to process response: Model use case details have not been submitted for this account. Fill out the Anthropic use case details form before using the model.` then open the [Playground in the AWS Bedrock Console](https://console.aws.amazon.com/bedrock/home?#/text-generation-playground), select any Anthropic model and fill in the form (you might need to send a prompt first)
-
----
-
-### Step 2: Verify Regional and Model Access
-
-#### 2.1 Choose and Confirm a Region
-
-1. **Select a Region:**\
-   AWS Bedrock is available in multiple regions (e.g., US East, Europe, Asia Pacific). Choose the region that meets your latency and compliance needs.\
-   [AWS Global Infrastructure](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)
-2. **Verify Model Access:**
-    - **Note:** Some models are only accessible via an [Inference Profile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html). In such case check the box "Cross Region Inference".
-
----
+Select region for latency/compliance needs:
+- `us-east-1` (N. Virginia)
+- `us-west-2` (Oregon)
+- `eu-west-1` (Ireland)
+- `ap-southeast-1` (Singapore)
 
-### Step 3: Configure the CodinIT VS Code Extension
+**Note:** Some models require [Inference Profile](https://docs.aws.amazon.com/bedrock/latest/userguide/inference-profiles-support.html) - check "Cross Region Inference" box if needed.
 
-#### 3.1 Install and Open CodinIT
+### 4. Configure CodinIT
 
-1. **Install VS Code:**\
-   Download from the [VS Code website](https://code.visualstudio.com).
-2. **Install the CodinIT Extension:**
-    - Open VS Code.
-    - Go to the Extensions Marketplace (`Ctrl+Shift+X` or `Cmd+Shift+X`).
-    - Search for **CodinIT** and install it.
+1. Install CodinIT extension in VS Code
+2. Click settings icon (⚙️)
+3. Select **AWS Bedrock** as API Provider
+4. Enter your **API Key**
+5. Specify **AWS Region** (e.g., `us-east-1`)
+6. Select **Model** (e.g., `anthropic.claude-3-5-sonnet-20241022-v2:0`)
+7. Save and test
 
-#### 3.2 Configure CodinIT Settings
+## Security Best Practices
 
-1. **Open CodinIT Settings:**
-    - Click on the settings ⚙️ to select your API Provider.
-2. **Select AWS Bedrock as the API Provider:**
-    - From the API Provider dropdown, choose **AWS Bedrock**.
-3. **Enter Your AWS API Key:**
-    - Input your **API Key**
-    - Specify the correct **AWS Region** (e.g., `us-east-1` or your enterprise-approved region).
-4. **Select a Model:**
-    - Choose an on-demand model (e.g., **anthropic.claude-3-5-sonnet-20241022-v2:0**).
-5. **Save and Test:**
-    - Click **Done/Save** to apply your settings.
-    - Test the integration by sending a simple prompt (e.g., "Generate a Python function to check if a number is prime.").
+1. **Secure access:** Prefer AWS SSO/federated roles over long-lived API keys when possible
+2. **Network security:** Consider [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/userguide/endpoint-services-overview.html)
+3. **Monitoring:** Enable CloudTrail for API logging and CloudWatch for metrics
+4. **Cost management:** Use AWS Cost Explorer and set billing alerts
+5. **Regular audits:** Review IAM roles and CloudTrail logs periodically
 
----
-
-### Step 4: Security, Monitoring, and Best Practices
-
-1. **Secure Access:**
-    - Prefer AWS SSO/federated roles over long-lived API Key when possible.
-    - [AWS IAM Best Practices](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)
-2. **Enhance Network Security:**
-    - Consider setting up [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/userguide/endpoint-services-overview.html) to securely connect to Bedrock.
-3. **Monitor and Log Activity:**
-    - Enable AWS CloudTrail to log Bedrock API calls.
-    - Use CloudWatch to monitor metrics like invocation count, latency, and token usage.
-    - Set up alerts for abnormal activity.
-4. **Handle Errors and Manage Costs:**
-    - Implement exponential backoff for throttling errors.
-    - Use AWS Cost Explorer and set billing alerts to track usage.\
-      [AWS Cost Management](https://docs.aws.amazon.com/cost-management/latest/userguide/what-is-aws-cost-management.html)
-5. **Regular Audits and Compliance:**
-    - Periodically review IAM roles and CloudTrail logs.
-    - Follow internal data privacy and governance policies.
-
----
-
-### Conclusion
-
-By following these steps, you can quickly integrate AWS Bedrock with the CodinIT VS Code extension to accelerate development:
-
-1. **Prepare Your AWS Environment:** Create a Bedrock API Key with the necessary permissions.
-2. **Verify Region and Model Access:** Confirm that your selected region supports your required models.
-3. **Configure CodinIT in VS Code:** Install and set up CodinIT with your AWS API Key and choose an appropriate model.
-4. **Implement Security and Monitoring:** Use best practices for IAM, network security, monitoring, and cost management.
-
-For further details, consult the [AWS Bedrock Documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html). Happy coding!
-
----
+## Notes
 
-_This guide will be updated as AWS Bedrock and CodinIT evolve. Always refer to the latest documentation and internal policies for up-to-date practices._
+- **Pricing:** Usage-based, see [AWS Bedrock Pricing](https://aws.amazon.com/bedrock/pricing/)
+- **Compliance:** HIPAA and SOC 2 Type II compliant
+- **Documentation:** [AWS Bedrock User Guide](https://docs.aws.amazon.com/bedrock/latest/userguide/what-is-bedrock.html)
+- **IAM Best Practices:** [AWS IAM Best Practices](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)