本教程解决新手装好 Claude Code 后最常卡住的两件事：怎么登录、用哪个模型。文章横评三种认证方式（订阅 OAuth、Console API Key、云厂商网关），拆解 /model 切换与 /cost 成本监控，并给出"省钱又够用"的决策框架。适用人群：首次接触 Claude Code 的开发者、刚拿到账号不知如何配置、以及被账单或配额劝退的入门用户。
npm install -g @anthropic-ai/claude-code，或官方原生安装器），终端能跑通 claude --versionClaude Code 本身只是个客户端，真正干活的是后端模型，而模型怎么计费、能不能用、有没有配额，全由你登录用的"通行证"决定。新手最大的误区是把"安装完成"当成"能用了"，结果一跑就报 Invalid API key 或 quota exceeded。官方支持三类认证方式，先用一张表建立全局认知：
| 认证方式 | 通行证 | 计费逻辑 | 适合谁 |
|---|---|---|---|
| 订阅 OAuth | Claude.ai 账号（Pro/Max） | 月费包干，按"用量配额"而非按 token | 重度日常用户、不想算账的人 |
| Console API Key | Anthropic Console 的 sk-ant-... |
按 token 实付实结，预付额度 | 控成本、跑批处理、CI 环境 |
| 云厂商 / 网关 | Bedrock / Vertex / Foundry / LLM gateway 凭证 | 走云账单或自建网关 | 企业、特定地区、数据合规要求 |
预期结果：看到这张表，你应该已经能判断自己属于哪一栏。下文按"订阅 OAuth → API Key → 云网关"顺序给出具体操作。
这是最省心的路径，尤其适合已经在用 Claude.ai 网页版的用户。
操作说明：在终端执行 claude，首次启动会进入登录引导，选择 Claude.ai account（订阅登录），回车后终端会输出一个 URL 并尝试自动打开浏览器。在浏览器完成 Anthropic 授权、回到终端确认，即登录成功。
# 启动 Claude Code，首次会引导登录
claude
# 登录态过期或要切账号时，用斜杠命令
/login # 重新登录 / 切换账号
/logout # 登出当前账号
/status # 查看当前账号、登录方式、当前模型
预期结果：/status 应显示类似 Logged in via Claude subscription (Max plan)，并能看到订阅套餐与剩余配额提示。登录态以 OAuth token 形式缓存在本机（环境变量 CLAUDE_CODE_OAUTH_TOKEN 也可用于 CI 等无浏览器环境注入）。
常见问题：
- 浏览器没自动弹出：复制终端里的 URL 手动粘到浏览器即可；远程服务器场景可加 --no-browser 让它打印授权链接，本地浏览器完成后再贴回。
- 报错 "subscription required"：免费层通常不开放 Claude Code 完整能力，需 Pro 或 Max 套餐；个人重度用户多选 Max（约 $100+/月，含较高用量配额）。
- 配额跑满（rate limited）：订阅是"包月配额制"而非无限，高峰期会限流。可在订阅周期内等待重置，或临时切到 API Key 应急。
如果你更想"花多少付多少"，或要在 CI、容器里无人值守跑，API Key 是更可控的选择。
操作说明：先到 console.anthropic.com 创建一个 API Key（形如 sk-ant-...），并确保账户有预付额度。首次 claude 启动时选 Anthropic Console（API access），粘贴 Key；或直接用环境变量注入：
# 方式一：启动时交互粘贴（推荐，key 存入本地凭据而非明文环境）
claude # 选 Anthropic Console → 粘贴 API Key
# 方式二：环境变量注入（适合脚本 / CI / 容器）
export ANTHROPIC_API_KEY="sk-ant-xxxxxxxxxxxx"
# 方式三：彻底无交互（CI 推荐）
echo "y" | claude # 自动接受首次信任提示
预期结果：/status 显示 Logged in via API key。此时用量直接扣 Console 预付额度，按 token 实结，跑完一次 /cost 就能看到本次花了多少美元。
常见问题：
- Key 误提交到 Git：立即在 Console 撤销该 Key、新建一个；永远用环境变量或密钥管理工具，不要硬编码。
- 报 "insufficient balance"：Console 预付额度耗尽，充值即可；订阅账号不会报这个错。
- 多个 Key 想切换：/login 选 Console，重新粘贴；或改环境变量后重启会话。
官方原生支持 AWS Bedrock、Google Vertex AI、Microsoft Foundry 三大云，以及自建 LLM gateway（把请求转发到企业内网统一鉴权与审计）。配置方式是用对应的环境变量切换后端，例如 Bedrock：
# 指定使用 Bedrock 后端（凭证走 AWS 标准链：环境变量 / IAM Role / SSO）
export CLAUDE_CODE_USE_BEDROCK=1
# Vertex AI
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION="us-east5"
export ANTHROPIC_VERTEX_PROJECT_ID="your-gcp-project"
预期结果：/status 显示对应的云后端，用量计入云账单（Bedrock 计入 AWS 账单，Vertex 计入 GCP 账单）。
常见问题与重要提醒： - 第三方"中转/逆向"登录 2026 年 4 月已受限：Anthropic 收紧了第三方工具的 OAuth 直连，官方现在明确只支持上述三类正规后端。任何号称"一键白嫖"的第三方 token 转卖服务都存在封号与数据泄露风险，不要把生产代码交出去。 - 地区不可用：官方 API 在部分地区受限，此时 Bedrock/Vertex/Foundry 往往是合规可用的替代路径。 - 网关统一鉴权：企业可在网关层强制策略（如禁止外发密钥、强制审计日志），比每人发一把 Key 安全得多。
至此三种认证方式讲完。一个关键判断：个人日常用订阅 OAuth，控成本与自动化用 API Key，企业合规用云网关。 三者可在同一台机器上用
/login随时切换。
/model 选对模型认证只解决了"能不能连上"，模型选择才决定"贵不贵、快不快、强不强"。Claude Code 把模型封装成易记的别名（alias），底层版本会自动升级，你只需在几档之间选：
| 别名 | 定位 | 典型场景 | 成本量级 |
|---|---|---|---|
opus |
最强推理 | 复杂架构设计、深度重构、疑难 Bug | 最高 |
sonnet |
均衡主力 | 日常编码、写功能、改代码 | 中等 |
haiku |
轻量快速 | 简单问答、批量解释、格式转换 | 最低 |
fable |
实验性别名 | 新能力尝鲜（按官方指引选用） | 视版本 |
切换模型有三种粒度，对应"临时用一下 / 这次会话用 / 永久默认"：
# 方式一：/model 命令（交互式，最常用，随时切）
# 在 Claude Code 会话内输入：
/model # 弹出选择器，方向键选 opus / sonnet / haiku
/model sonnet # 也可直接带参数一键切到 sonnet
# 方式二：--model 启动参数（只影响本次会话）
claude --model haiku # 这次会话全程用 Haiku，省钱跑批
# 方式三：设为永久默认（写进 settings.json 或环境变量）
# ~/.claude/settings.json:
{
"model": "sonnet"
}
# 或环境变量：
export ANTHROPIC_MODEL="sonnet"
预期结果：切换后 /status 顶部显示的 Model 字段会立刻更新；切换模型不会丢失上下文（已读的文件、对话历史都保留），所以可以放心"用 Haiku 问、用 Opus 干大活"来回切。
新手最该记住的一条策略：默认 sonnet，大任务临时升 opus，机械活降到 haiku。 90% 的日常 sonnet 足够，把 opus 留给真正烧脑的环节，账单会显著下降。
/cost 把账盯住不管哪种认证，模型越强 token 越贵，新手最容易被账单吓到。/cost 是你的仪表盘：
/cost # 查看当前会话累计 token 消耗与换算费用
预期结果：输出本次会话的输入/输出 token 数与估算花费（API Key 模式直接显示美元）。订阅模式下显示的是"用量占比"而非美元。
省钱四招：
1. 按任务阶段切模型：读代码、回答概念用 Haiku；写实现用 Sonnet；卡壳的难题用 Opus。
2. 勤用 /clear：上下文越长越烧钱，一个任务做完清空，避免无关历史反复被读入。
3. 善用 /compact：会话变长但还想保留线索时，压缩上下文而非原样保留。
4. 批处理锁 Haiku：跑 claude -p "批量解释这段代码" 这类无头任务，显式 --model haiku，成本可降到几分之一。
把上面所有点串成一条验证链，跑通即代表配置正确：
claude --version # 1. 客户端在
claude # 2. 启动（按 1/2/3 选认证方式）
/status # 3. 看账号 + 模型 + 后端，三要素齐全
/model haiku # 4. 切到最便宜模型
# 让它做一件最简单的事，比如：解释 ls 命令
/cost # 5. 看本次花了多少，验证计费链路通
/logout # 6.（可选）确认能正常登出/切换
场景：你刚拿到一个 Claude Max 订阅，想在个人项目里跑通 Claude Code，又怕月底配额见底。
# ① 订阅登录（最省心，包月配额）
claude # 选 Claude.ai account → 浏览器授权
/status # 确认：Max plan、默认 sonnet
# ② 设永久默认 Sonnet（性价比主力）
# 编辑 ~/.claude/settings.json，加入 "model": "sonnet"
# ③ 日常编码直接用（Sonnet 主力）
claude
> 帮我把这个 Python 脚本里的函数补全并加类型注解
# ④ 遇到真正难的架构问题，临时升 Opus
/model opus
> 重构这个模块的依赖关系，画出新的分层方案
# ⑤ 大量机械活（解释 20 个配置文件），降到 Haiku 批跑
claude --model haiku -p "逐个解释这些 yaml 配置的作用" < configs/
# ⑥ 随时盯账
/cost # 订阅模式看用量占比，别把整月配额耗在 Opus 上
预期结果：一天下来，难题用了 Opus（贵但少）、日常靠 Sonnet（均衡）、机械活全交 Haiku（便宜量大），配额与成本都处在可控区间。这正是"登录首决策"的终极目标——不是省到极致，而是让每一档模型都出现在它该出现的环节。
flowchart TD
A[启动 claude] --> B{选择认证方式}
B -->|个人日常| C[订阅 OAuth<br/>Claude.ai 账号]
B -->|控成本/CI| D[Console API Key<br/>ANTHROPIC_API_KEY]
B -->|企业/合规| E[云厂商/网关<br/>Bedrock·Vertex·Foundry]
C --> F[/status 确认登录/]
D --> F
E --> F
F --> G{选模型}
G -->|复杂难题| H["opus<br/>最强·最贵"]
G -->|日常编码| I["sonnet<br/>均衡主力·默认"]
G -->|机械/批跑| J["haiku<br/>最快·最省"]
H --> K[/cost 盯账/]
I --> K
J --> K
K --> L{预算/配额够?}
L -->|是| M[✅ 继续开发]
L -->|否| N[降级模型 / /clear / /compact]
N --> G
/model、--model、环境变量三种切换方式详解。Usage and costs → Costs 章节，理解订阅配额与 API 计费差异。/cost 解释一次会话的花费构成。/model、--model、环境变量三种模型切换方式的官方指引。[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。