View Categories

Getting Your Anthropic API Key for Toby

10 min read

Table of Contents

Toby the Tobacconist is your store’s AI cigar concierge —the little genius that answers your customers’ questions and recommends cigars they’ll actually love, 24 hours a day, right from their phone. Under the hood, Toby uses Claude, an AI model made by a company called Anthropic. To connect your store to Toby, you need one thing from Anthropic: an API key.

Think of the API key like a credit card just for AI. Every time one of your customers asks Toby a question, Toby uses this key to ask Claude on your behalf, and Anthropic charges you (not us) a tiny amount for the answer —usually a fraction of a cent. You set your own spending limit, you watch your own usage, and you’re in complete control.

This guide walks you through the whole setup, from making an Anthropic account to pasting the key into the POS. It takes about ten minutes, and you only do it once.

Before You Start #

You’ll need:

  1. A computer or tablet with a web browser. You’ll jump back and forth between the browser and the POS, so a laptop on the counter next to the register is perfect.
  2. A credit card for Anthropic to bill. Anthropic charges you directly for AI usage —this never touches your TORO bill. Average stores run about a dollar or two a month in AI costs for typical Toby traffic. We’ll show you how to set a hard spending cap so there are no surprises.
  3. An email address that you actually check. Anthropic sends a confirmation email and occasionally emails about usage or billing, so don’t use a junk account.
  4. About ten minutes. Most of it is waiting for confirmation emails.

Step 1: Create Your Anthropic Account #

  1. Open a web browser and go to console.anthropic.com. That’s the Anthropic developer console —don’t confuse it with claude.ai, which is the consumer chat product. You need the console, not the chat.
  2. Click Sign Up. You can sign up with Google, or with an email address and password. Either way works. If you already have a Claude.ai account with the same email, Anthropic will link them —that’s fine.
  3. Check your email for a verification link from Anthropic and click it. If you don’t see it within a minute, check spam.
  4. Back on the console, you’ll be asked a few onboarding questions —what you’re building, whether you’re an individual or a company, that kind of thing. Answer truthfully. If it asks what you’re building, you can put “cigar store AI assistant” or similar —there’s no wrong answer, it’s just for their internal tracking.
  5. You’ll land on the Anthropic Console dashboard. You’re now signed up, but you don’t have any credit yet, which means you can’t use Toby yet. Next step.

Step 2: Add a Payment Method and Buy Credit #

Anthropic uses a prepaid credit system. You add money to your account up front, and every AI call draws it down. When you run low, you can set it to auto-refill or just top up manually. For a typical shop, ten or twenty dollars lasts a long time.

  1. On the left side of the Anthropic Console, find Billing (sometimes under a Settings or account menu —Anthropic moves the labels around occasionally, but it’s always findable).
  2. Click Add Payment Method and enter your credit card. This is Anthropic’s billing system, not ours —we don’t see your card number.
  3. Click Buy Credits or Add Credit. Start with $10. That is more than enough to run Toby for weeks at a normal store, and it lets you get comfortable with how usage looks before putting more in. You can always add more later.
  4. After the credit lands (usually instantly), you’ll see a balance of $10 on your billing page. Good. Move on.

Step 3: Set a Spending Limit (Strongly Recommended) #

This is the step most people skip and then regret. Set a hard monthly cap so your AI bill can never surprise you.

  1. Still on the Billing page, look for Spend Limits, Usage Limits, or Monthly Budget —the label varies but the feature is always there.
  2. Set a monthly cap you’re comfortable with. $25 a month is a generous cap for most stores and leaves plenty of room even on a busy weekend. You can raise it later if you ever need to.
  3. Save. Now, even if something went completely haywire, Anthropic would stop billing you the moment you hit your cap. Your bill literally cannot exceed this number.

Step 4: Create the API Key #

This is the actual key —the thing you’ll paste into the POS.

  1. On the left side of the Anthropic Console, click API Keys.
  2. Click Create Key.
  3. Give it a name. We recommend “TORO POS Toby” or “[Your Store Name] Toby” —that way if you ever create other keys for other things, you’ll know which one is which. The name is just a label for you, it doesn’t affect how the key works.
  4. If you’re asked which workspace to put it in, use the default workspace that’s already selected. If you’re asked about permissions, leave it at the default (full access). Toby needs to be able to ask Claude questions, and that’s what the default permissions allow.
  5. Click Create Key.
  6. IMPORTANT: You will see the key exactly one time. It looks like this: sk-ant-api03-abc123XYZ... —a long string of letters and numbers starting with sk-ant-api03-. Anthropic will never show this key to you again after you close this screen. If you lose it, there is no “forgot my key” option —you just delete the old one and create a new one. That’s fine, it takes 30 seconds, but don’t close the window until you’ve captured the key.
  7. Click the Copy button next to the key to copy it to your clipboard. Do not screenshot it, text it, email it, or type it into a chat message. Treat it like a password.

Step 5: Paste the Key into Your POS #

Now you jump back to the TORO POS.

  1. On the POS, go to Help > Toby Setup. You’ll see the Toby setup screen with a password field labeled “Anthropic API Key”.
  2. Click inside the password field and paste the key you copied from Anthropic (Ctrl+V on Windows). You’ll see dots instead of the actual key —that’s normal, it’s hiding the key like a password would.
  3. Read the agreement checkbox underneath: “I agree that my store’s Claude API usage costs are billed directly to me by Anthropic.” That’s the deal —you pay Anthropic directly for AI usage, not us. Tick the box.
  4. Click Register with Toby. The button goes from gray to active. After a moment, you’ll see a confirmation that your store is connected, and the little status chip at the top of the screen will turn green.
  5. That’s it. Your store is now connected to Toby. The POS will upload your cigar catalog to Toby after your next close-of-day, and Toby will be ready for your customers the next morning.

After You’re Set Up #

Here are a few things worth knowing:

Watching Your AI Usage #

You can log back into console.anthropic.com any time to see how much credit you’ve used and how much is left. Most stores never touch this page after the initial setup —usage is steady and low —but it’s there if you ever want to peek.

There’s also a shortcut built right into your POS. Once your store is connected, the Toby Setup screen (Help > Toby Setup) has a “View Usage & Billing at Anthropic” button. Click it and your default browser opens straight to the Anthropic billing page —no hunting for the URL. Note that the POS itself does not show your spending; Anthropic is the only system that actually knows your balance, and we’re sending you there with one click rather than trying to mirror it.

If your balance ever runs low, you have two options:

  1. Manual top-up. Just go to Billing and add more credit when you remember.
  2. Auto-reload. Anthropic can automatically add more credit when you drop below a threshold. Most stores prefer this because Toby never stops working unexpectedly. You can set this up on the Billing page —look for Auto-Reload or Recurring Top-Up.

Rotating (Replacing) the Key #

If you ever need to replace the key —say, an employee with access to the key leaves the store, or you just want to refresh it for good hygiene —here’s how:

  1. Go to console.anthropic.com > API Keys and delete the old key. Don’t do this first if you don’t already have the new one ready —Toby will stop working until you paste a new one in.
  2. Create a new key following Step 4 above, and copy it.
  3. On the POS, open Help > Toby Setup again. This time you’ll be in the “already registered” view. Click Update Claude API Key, paste the new one, and save.

Toby keeps working with zero downtime. Old key is gone, new key is in, your customers never notice.

What if I Lose the Key? #

Easy. Go to console.anthropic.com > API Keys, delete the lost key, and create a new one. Then update the POS using the Rotating steps above. The lost key is harmless once it’s deleted —even if someone finds it on a sticky note later, it won’t work anymore.

What if Anthropic Charges Me More Than I Expected? #

If you set a spending cap in Step 3, this literally cannot happen beyond your cap. If you didn’t set a cap and got a surprise bill, go set one now —console.anthropic.com > Billing > Spend Limits —and log in daily for a few days to watch usage until you’re comfortable. If you think something is genuinely wrong (like Toby made a call you don’t recognize), email us at thrive@legacy.torocigarpos.com and we’ll help you dig in.

I Need to Start Over #

If you messed something up and want to restart the whole setup, that’s fine. Go to Help > Toby Setup, click Disable Toby, then delete your key in the Anthropic Console, then follow this guide again from Step 4. Your Toby store registration on our side stays the same —you’re just replacing the key.

A Note on Why It Works This Way #

You might be wondering why we don’t just bundle the AI cost into your TORO subscription. Two reasons:

  1. You stay in control of your spending. Your usage, your cap, your credit card. If something goes wrong, it’s your account you’re adjusting, not ours. And there’s no risk of us suddenly changing our pricing for AI because Anthropic changed theirs.
  2. Your data stays yours. Because the API key is in your name with Anthropic, the conversations Toby has with your customers are billed to your account and governed by your agreement with Anthropic —not by us routing through a shared account. Cleaner, simpler, and more private.

The tradeoff is that you have to do this ten-minute setup once. That’s it. After today, you never think about it again —Toby just works.

Related Articles #

What are your Feelings