diff --git a/packages/docs/CleanShot 2026-04-07 at 18.04.31@2x.png b/packages/docs/CleanShot 2026-04-07 at 18.04.31@2x.png new file mode 100644 index 000000000..f83ac685b Binary files /dev/null and b/packages/docs/CleanShot 2026-04-07 at 18.04.31@2x.png differ diff --git a/packages/docs/docs.json b/packages/docs/docs.json index 5401f23a1..b3cb5f7ba 100644 --- a/packages/docs/docs.json +++ b/packages/docs/docs.json @@ -40,6 +40,7 @@ { "group": "Tutorials", "pages": [ + "how-to-get-an-anthropic-api-key", "how-to-connect-a-custom-provider", "importing-a-skill" ] diff --git a/packages/docs/how-to-get-an-anthropic-api-key.mdx b/packages/docs/how-to-get-an-anthropic-api-key.mdx new file mode 100644 index 000000000..4af89bda5 --- /dev/null +++ b/packages/docs/how-to-get-an-anthropic-api-key.mdx @@ -0,0 +1,51 @@ +--- +title: "How to get an Anthropic API key" +description: "Create an Anthropic API key and use it in OpenWork" +--- + +Anthopic has disabled 3rd party authentication for their OAuth. In order to continue supporting Anthropic based models in OpenWork, we now default to manual API key entry for Anthropic. +That means you create the key in Anthropic first, then paste it into OpenWork. + +## Before you start + +- You need an Anthropic account at [platform.claude.com](https://platform.claude.com). +- Your Claude subscription and your Anthropic API billing are not always the same thing, so make sure API access is enabled on your Anthropic account. +- Treat the key like a password. Anthropic will only show the full value when you create it. + +## Create the key in Anthropic + +1. Sign in at [platform.claude.com](https://platform.claude.com). +2. Open the `API Keys` page. + + + ![Anthropic API Keys page](/images/anthropic-key.png) + + +3. Click `Create Key`. +4. Give the key a recognizable name like `OpenWork`. + + + ![Anthropic Create Key dialog](/images/anthropic-openwork-key.png) + + +5. Copy the new key right away. It should look like `sk-ant-...`. + +## Add the key to OpenWork + + +1. Open `Settings` in OpenWork. +2. Go to `Connect Provider` and choose `Anthropic`. +3. Paste the API key into the manual key field. +4. Save the provider, then choose an Anthropic model in chat. + + + ![How to add a new provider in OpenWork](/images/openwork-providers.png) + + +## Common issues + +- If the key is rejected, make sure you copied the full value without extra spaces. +- If you cannot see `API Keys`, check that your Anthropic account has API access and billing set up. +- If you lose the key, create a new one in Anthropic and update OpenWork with the new value. + +The same general process applies to most providers that use manual API keys: create the key in the provider's developer console, copy it once, and paste it into OpenWork. diff --git a/packages/docs/images/anthropic-key.png b/packages/docs/images/anthropic-key.png new file mode 100644 index 000000000..fbf34c3bc Binary files /dev/null and b/packages/docs/images/anthropic-key.png differ diff --git a/packages/docs/images/anthropic-openwork-key.png b/packages/docs/images/anthropic-openwork-key.png new file mode 100644 index 000000000..cbb20c9eb Binary files /dev/null and b/packages/docs/images/anthropic-openwork-key.png differ diff --git a/packages/docs/images/openwork-providers.png b/packages/docs/images/openwork-providers.png new file mode 100644 index 000000000..f83ac685b Binary files /dev/null and b/packages/docs/images/openwork-providers.png differ