Claude Code and Its Surfaces
Level 1 · Starting out
What Claude Code is, where you can run it, and how it signs you in. Why a terminal, an editor and the web all run the same agent.
Course contentsLesson 1 of 16
Level 1 · Starting out
Level 2 · Asking before it acts
Level 3 · Telling it how you work
Level 4 · The tools it uses
Level 5 · Growing past one chat
After this lesson you can
- Say what Claude Code does that a chat app does not
- Name the places you can run it
- Pick a way to sign in
9 mincovers 7 glossary entries
What Claude Code is, and where it runs
Claude Code is Anthropic's coding agent. You type what you want in plain words, and it reads your files, runs commands and edits your code until the job is done. You start it by typing claude in a terminal. It also runs in VS Code, a desktop app and on the web at claude.ai/code.
A chat app only talks. Claude Code acts. When you ask it to fix a failing test, it opens the test, runs it, reads the error, edits the code and runs the test again. The model is Claude. Claude Code is the program around the model that gives it hands: tools to read, write and run things.
What you type is called a prompt. A prompt can be one line, like fix the login bug, or a page of detail. Claude Code turns it into steps on its own. You watch each step go by, and you can stop it or change course at any time.
Each place you use Claude Code from is called a surface. The terminal, the code editors, the desktop app and the web all run the same engine. A session on your own computer reads your files and settings. A session on the web starts from a fresh copy of your project on a server instead.
Before it can call a model, Claude Code has to know who you are. On first launch it opens a browser so you can sign in with a paid Claude plan or with a Console account. A script can use an API key instead, which is a long secret string that pays per use.
A company can also reach Claude through a big cloud, such as Amazon Bedrock, Google Cloud's Agent Platform or Microsoft Foundry. You pick one with a setting, and you sign in with that cloud's own login. The bill then goes to the cloud account. Some features need a claude.ai sign-in, so they are not there on those clouds.
When more than one sign-in is set up, Claude Code picks one in a fixed order of seven. A cloud setting comes first, then keys and tokens. Your Claude plan sign-in comes last. So a stray API key in your shell wins over your plan. Run /status inside a session to see which one is in use.
claude auth login
claudeWorked example
Jack's API key wins by surprise
Jack pays for a Claude plan, but his first week of Claude Code shows charges on an old Console account. His shell still sets an API key from a project two years ago.
He runs /status and sees the key in use. He removes it from his shell file, opens a new terminal, and his plan takes over.
The words for this lesson7
Check yourself
What makes Claude Code more than a chat app?
Finished this lesson?
Marking it complete also marks its 7 glossary entries learned, which updates your roadmap and your saved page. 0 are already marked.