<!-- title: 认证三法与模型选择：登录首决策 -->

## 概述

本教程解决新手装好 Claude Code 后最常卡住的两件事：**怎么登录**、**用哪个模型**。文章横评三种认证方式（订阅 OAuth、Console API Key、云厂商网关），拆解 `/model` 切换与 `/cost` 成本监控，并给出"省钱又够用"的决策框架。适用人群：首次接触 Claude Code 的开发者、刚拿到账号不知如何配置、以及被账单或配额劝退的入门用户。

## 前置条件

- 已安装 Claude Code（`npm install -g @anthropic-ai/claude-code`，或官方原生安装器），终端能跑通 `claude --version`
- 持有以下任一"通行证"：Claude.ai 订阅账号（Pro/Max）、Anthropic Console 账号（可创建 API Key）、或企业云厂商凭证（AWS Bedrock / Google Vertex / Microsoft Foundry）
- 一个稳定的浏览器（OAuth 授权需要跳转）和能联网的终端环境
- 对"按 token 计费"和"模型别名"这两个概念有基本认知即可，无需先验

---

## 正文

### 第一步：先搞懂——你的"通行证"决定了一切

Claude 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 → 云网关"顺序给出具体操作。

### 第二步：方式 A——订阅 OAuth 登录（推荐个人用户）

这是最省心的路径，尤其适合已经在用 Claude.ai 网页版的用户。

**操作说明**：在终端执行 `claude`，首次启动会进入登录引导，选择 `Claude.ai account`（订阅登录），回车后终端会输出一个 URL 并尝试自动打开浏览器。在浏览器完成 Anthropic 授权、回到终端确认，即登录成功。

```bash
# 启动 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 应急。

### 第三步：方式 B——Console API Key 登录（推荐控成本用户）

如果你更想"花多少付多少"，或要在 CI、容器里无人值守跑，API Key 是更可控的选择。

**操作说明**：先到 [console.anthropic.com](https://console.anthropic.com) 创建一个 API Key（形如 `sk-ant-...`），并确保账户有预付额度。首次 `claude` 启动时选 `Anthropic Console`（API access），粘贴 Key；或直接用环境变量注入：

```bash
# 方式一：启动时交互粘贴（推荐，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，重新粘贴；或改环境变量后重启会话。

### 第四步：方式 C——云厂商 / LLM 网关（企业 / 特殊地区）

官方原生支持 AWS Bedrock、Google Vertex AI、Microsoft Foundry 三大云，以及自建 **LLM gateway**（把请求转发到企业内网统一鉴权与审计）。配置方式是用对应的环境变量切换后端，例如 Bedrock：

```bash
# 指定使用 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` | 实验性别名 | 新能力尝鲜（按官方指引选用） | 视版本 |

切换模型有**三种粒度**，对应"临时用一下 / 这次会话用 / 永久默认"：

```bash
# 方式一：/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` 是你的仪表盘：

```bash
/cost     # 查看当前会话累计 token 消耗与换算费用
```

**预期结果**：输出本次会话的输入/输出 token 数与估算花费（API Key 模式直接显示美元）。订阅模式下显示的是"用量占比"而非美元。

**省钱四招**：
1. **按任务阶段切模型**：读代码、回答概念用 Haiku；写实现用 Sonnet；卡壳的难题用 Opus。
2. **勤用 `/clear`**：上下文越长越烧钱，一个任务做完清空，避免无关历史反复被读入。
3. **善用 `/compact`**：会话变长但还想保留线索时，压缩上下文而非原样保留。
4. **批处理锁 Haiku**：跑 `claude -p "批量解释这段代码"` 这类无头任务，显式 `--model haiku`，成本可降到几分之一。

### 第七步：登录首跑自检清单

把上面所有点串成一条验证链，跑通即代表配置正确：

```bash
claude --version        # 1. 客户端在
claude                   # 2. 启动（按 1/2/3 选认证方式）
/status                  # 3. 看账号 + 模型 + 后端，三要素齐全
/model haiku             # 4. 切到最便宜模型
# 让它做一件最简单的事，比如：解释 ls 命令
/cost                    # 5. 看本次花了多少，验证计费链路通
/logout                  # 6.（可选）确认能正常登出/切换
```

---

## 实战案例：新手第一天的"登录—选型—省钱"全流程

场景：你刚拿到一个 Claude Max 订阅，想在个人项目里跑通 Claude Code，又怕月底配额见底。

```bash
# ① 订阅登录（最省心，包月配额）
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（便宜量大），配额与成本都处在可控区间。这正是"登录首决策"的终极目标——**不是省到极致，而是让每一档模型都出现在它该出现的环节**。

---

## 工作流程图

```mermaid
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
```

---

## 延伸阅读

- **官方认证文档**：[code.claude.com/docs/en/authentication](https://code.claude.com/docs/en/authentication) —— 所有认证方式的权威说明，含 Bedrock/Vertex/Foundry/gateway 配置。
- **官方快速入门**：[code.claude.com/docs/en/quickstart](https://code.claude.com/docs/en/quickstart) —— 首次启动与第一个任务的官方走查。
- **模型配置帮助**：[support.claude.com — Claude Code model configuration](https://support.claude.com/en/articles/11940350-claude-code-model-configuration) —— `/model`、`--model`、环境变量三种切换方式详解。
- **成本与监控**：官方 `Usage and costs → Costs` 章节，理解订阅配额与 API 计费差异。

---

## 训练营适用性评估

- **适合训练营类型**：Claude Code / AI 编程入门营、企业 AI 工具上岗营、"从零到能用"速成营。本教程聚焦"登录与选型"这一所有后续课程的前置依赖，适合放在任何训练营的第 1～2 课。
- **不适合**：已假定学员会登录的高级营（Skills/MCP/Agent 开发营），那里只需引用本文做回链。
- **预计教学时长**：理论讲解 30 分钟 + 实操自检（第七步清单）20 分钟 + 实战案例演练 30 分钟，合计约 **80 分钟**（含答疑）。
- **考核点建议**：学员能独立完成"OAuth 与 API Key 两种登录各跑通一次"，并能用 `/cost` 解释一次会话的花费构成。
- **教学风险**：第三方登录与地区可用性是敏感点，讲师需提前为学员准备好**至少一种正规可用的认证方式**，避免现场卡在登录环节。

---

## 参考来源

1. [Authentication — Claude Code Docs](https://code.claude.com/docs/en/authentication) — 官方认证方式总览（订阅 OAuth / Console API Key / Bedrock / Vertex / Foundry / LLM gateway）。
2. [Quickstart — Claude Code Docs](https://code.claude.com/docs/en/quickstart) — 官方首次启动与 Console 自动创建 "Claude Code" workspace 的说明。
3. [Claude Code model configuration — Claude Help Center](https://support.claude.com/en/articles/11940350-claude-code-model-configuration) — `/model`、`--model`、环境变量三种模型切换方式的官方指引。
4. [Model configuration — Claude Code Docs](https://code.claude.com/docs/en/model-config) — 官方模型别名（fable/opus/sonnet/haiku）解析与固定版本说明。
5. [Claude Code Authentication: How to Connect Your Anthropic Account — lowcode.agency](https://www.lowcode.agency/blog/claude-code-authentication-setup) — 订阅登录与 API Key 两条路径的实操对比（技术博客，2026-06 更新）。

> [!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 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)