3.7 Claude Code 首次启动与认证

面向经管学生、研究者与从业者的 AI 智能体设计教材

作者

李学恒、林建浩、严翊歆、张一帆

最后更新

2026-06-13

Claude Code 是 Anthropic 发布的 AI 编码代理（Agentic Coding Tool），在终端中运行。它能直接读写文件、执行命令、搜索代码库，用自然语言即可控制。

本书从第二篇开始的所有章节，均以 Claude Code 作为主要教学工具。本节介绍它的认证与首次启动方法。

认证准备

Claude Code 首次使用前要完成身份认证，有三种方式：

认证方式	说明
Claude Pro/Max 订阅	OAuth 登录绑定 Anthropic 订阅，无需单独购买 API 额度
Anthropic API 密钥	按量付费，使用 Anthropic 官方 API
第三方模型服务	用智谱 GLM Coding Plan、DeepSeek、MiniMax 等国内厂商的密钥接入，国内可直接付费

前两种走 Anthropic 官方，需要海外支付能力；第三种接入国内模型厂商，注册、付费和网络访问都更方便，是大多数国内读者的首选。

知识卡片

Claude Pro 是 Anthropic 的付费订阅服务（20 美元/月），Claude Max 是更高额度的订阅方案（100 或 200 美元/月）。订阅用户可以通过 OAuth 登录直接使用 Claude Code，无需单独购买 API 额度。

首次启动

先进入工作目录，再启动 Claude Code。根据认证方式不同，分两种情况。

方式一：Anthropic 订阅或官方 API

直接启动：

cd ~/opencode-lab
claude

首次启动时，Claude Code 会要求认证身份：

OAuth 登录（订阅用户）：选择登录 Anthropic 账户，浏览器自动打开认证页面，登录后回到终端，认证自动完成。
API 密钥：选择输入 API Key，粘贴你的 Anthropic API 密钥。

获取 Anthropic API 密钥

Anthropic API 密钥在 https://console.anthropic.com/settings/keys 页面创建。注册 Anthropic 账户后，点击 Create Key，复制并保存。密钥以 sk-ant- 开头。

方式二：第三方模型服务

接入智谱、DeepSeek、MiniMax 等国内厂商时，需要在启动前设置两个环境变量，把 Claude Code 指向厂商的兼容端点：

# macOS
export ANTHROPIC_BASE_URL="厂商提供的服务地址"
export ANTHROPIC_AUTH_TOKEN="你的 API 密钥"
claude

Windows PowerShell 改用：

$env:ANTHROPIC_BASE_URL="厂商提供的服务地址"
$env:ANTHROPIC_AUTH_TOKEN="你的 API 密钥"
claude

以智谱 GLM Coding Plan 为例：在智谱开放平台开通套餐后，官方文档会提供服务地址和密钥，填入上面两个变量再启动 claude，不再走官方登录。DeepSeek、MiniMax 的接入方式类似，各自官方文档都提供了三步说明。

知识卡片

Claude Code 与模型通信使用 Anthropic 专属协议，第三方端点必须兼容该协议才能正常工作。智谱、DeepSeek、MiniMax 等厂商要么自带兼容端点，要么提供官方接入指引，照文档配置即可。

选择哪种方式

本书后续操作不依赖具体厂商，三种方式都能跑通。国内读者若不便进行海外支付，推荐第三方模型服务，注册付费都在国内完成。

认证通过后，终端显示 Claude Code 的交互界面。输入一句话测试：

▶ Claude Code

你好，请介绍一下你自己

AI 正常回复，说明一切就绪。

按 /exit 或 Ctrl+C 两次可退出 Claude Code。

基本操作速查

操作	方法
启动	在工作目录中输入 `claude`
发送消息	在输入框中输入文字，按回车
换行不发送	`Shift+Enter`
接受 AI 的文件修改	按 `y` 确认
拒绝修改	按 `n` 拒绝
新建对话	输入 `/clear`
退出	输入 `/exit` 或按 `Ctrl+C` 两次
恢复上次对话	`claude --continue`

Claude Code 与 Opencode 的区别

两者都是在终端中运行的 AI 编码助手，核心交互方式相同：用自然语言描述任务，AI 执行操作。区别在于定位和功能范围。

维度	Opencode	Claude Code
开发者	开源社区	Anthropic（Claude 模型的开发公司）
支持的模型	多家提供商（智谱、Kimi、OpenAI 等），内置切换	原生为 Claude 优化，可通过环境变量接入第三方模型
认证方式	API 密钥	Anthropic 订阅/API 密钥，或第三方模型服务
Skills	社区扩展包	内置 Skills 机制（`.claude/skills/`）
子代理	不支持	支持（`.claude/agents/`）
Hooks	不支持	支持（事件驱动的自动化脚本）
项目规则文件	`AGENTS.md`	`CLAUDE.md`
适用场景	快速上手、多模型切换	深度项目协作、多智能体编排

Opencode 适合初步体验 AI 编码助手的工作方式，上手门槛低，模型选择灵活。Claude Code 提供了完整的项目协作机制——Skills、子代理、Hooks、Agent Teams，是构建复杂智能体系统的基础。

本书第二篇开始，所有概念和操作均基于 Claude Code 展开。Opencode 用户可以对照使用，核心的人机协作方法是相通的。

--- title: "3.7 Claude Code 首次启动与认证" --- Claude Code 是 Anthropic 发布的 AI 编码代理（Agentic Coding Tool），在终端中运行。它能直接读写文件、执行命令、搜索代码库，用自然语言即可控制。本书从第二篇开始的所有章节，均以 Claude Code 作为主要教学工具。本节介绍它的认证与首次启动方法。 ## 认证准备 Claude Code 首次使用前要完成身份认证，有三种方式： | 认证方式 | 说明 | |------|------| | Claude Pro/Max 订阅 | OAuth 登录绑定 Anthropic 订阅，无需单独购买 API 额度 | | Anthropic API 密钥 | 按量付费，使用 Anthropic 官方 API | | 第三方模型服务 | 用智谱 GLM Coding Plan、DeepSeek、MiniMax 等国内厂商的密钥接入，国内可直接付费 | 前两种走 Anthropic 官方，需要海外支付能力；第三种接入国内模型厂商，注册、付费和网络访问都更方便，是大多数国内读者的首选。 ::: {.callout-note} ## 知识卡片 Claude Pro 是 Anthropic 的付费订阅服务（20 美元/月），Claude Max 是更高额度的订阅方案（100 或 200 美元/月）。订阅用户可以通过 OAuth 登录直接使用 Claude Code，无需单独购买 API 额度。 ::: ## 首次启动先进入工作目录，再启动 Claude Code。根据认证方式不同，分两种情况。 **方式一：Anthropic 订阅或官方 API** 直接启动： ```bash cd ~/opencode-lab claude ``` 首次启动时，Claude Code 会要求认证身份： - **OAuth 登录**（订阅用户）：选择登录 Anthropic 账户，浏览器自动打开认证页面，登录后回到终端，认证自动完成。 - **API 密钥**：选择输入 API Key，粘贴你的 Anthropic API 密钥。 ::: {.callout-tip} ## 获取 Anthropic API 密钥 Anthropic API 密钥在 <https://console.anthropic.com/settings/keys> 页面创建。注册 Anthropic 账户后，点击 Create Key，复制并保存。密钥以 `sk-ant-` 开头。 ::: **方式二：第三方模型服务** 接入智谱、DeepSeek、MiniMax 等国内厂商时，需要在启动前设置两个环境变量，把 Claude Code 指向厂商的兼容端点： ```bash # macOS export ANTHROPIC_BASE_URL="厂商提供的服务地址" export ANTHROPIC_AUTH_TOKEN="你的 API 密钥" claude ``` Windows PowerShell 改用： ```powershell $env:ANTHROPIC_BASE_URL="厂商提供的服务地址" $env:ANTHROPIC_AUTH_TOKEN="你的 API 密钥" claude ``` 以智谱 GLM Coding Plan 为例：在智谱开放平台开通套餐后，官方文档会提供服务地址和密钥，填入上面两个变量再启动 `claude`，不再走官方登录。DeepSeek、MiniMax 的接入方式类似，各自官方文档都提供了三步说明。 ::: {.callout-note} ## 知识卡片 Claude Code 与模型通信使用 Anthropic 专属协议，第三方端点必须兼容该协议才能正常工作。智谱、DeepSeek、MiniMax 等厂商要么自带兼容端点，要么提供官方接入指引，照文档配置即可。 ::: ::: {.callout-tip} ## 选择哪种方式本书后续操作不依赖具体厂商，三种方式都能跑通。国内读者若不便进行海外支付，推荐第三方模型服务，注册付费都在国内完成。 ::: 认证通过后，终端显示 Claude Code 的交互界面。输入一句话测试： ```opencode 你好，请介绍一下你自己 ``` AI 正常回复，说明一切就绪。按 `/exit` 或 `Ctrl+C` 两次可退出 Claude Code。 ## 基本操作速查 | 操作 | 方法 | |------|------| | 启动 | 在工作目录中输入 `claude` | | 发送消息 | 在输入框中输入文字，按回车 | | 换行不发送 | `Shift+Enter` | | 接受 AI 的文件修改 | 按 `y` 确认 | | 拒绝修改 | 按 `n` 拒绝 | | 新建对话 | 输入 `/clear` | | 退出 | 输入 `/exit` 或按 `Ctrl+C` 两次 | | 恢复上次对话 | `claude --continue` | ## Claude Code 与 Opencode 的区别两者都是在终端中运行的 AI 编码助手，核心交互方式相同：用自然语言描述任务，AI 执行操作。区别在于定位和功能范围。 | 维度 | Opencode | Claude Code | |------|----------|-------------| | 开发者 | 开源社区 | Anthropic（Claude 模型的开发公司） | | 支持的模型 | 多家提供商（智谱、Kimi、OpenAI 等），内置切换 | 原生为 Claude 优化，可通过环境变量接入第三方模型 | | 认证方式 | API 密钥 | Anthropic 订阅/API 密钥，或第三方模型服务 | | Skills | 社区扩展包 | 内置 Skills 机制（`.claude/skills/`） | | 子代理 | 不支持 | 支持（`.claude/agents/`） | | Hooks | 不支持 | 支持（事件驱动的自动化脚本） | | 项目规则文件 | `AGENTS.md` | `CLAUDE.md` | | 适用场景 | 快速上手、多模型切换 | 深度项目协作、多智能体编排 | Opencode 适合初步体验 AI 编码助手的工作方式，上手门槛低，模型选择灵活。Claude Code 提供了完整的项目协作机制——Skills、子代理、Hooks、Agent Teams，是构建复杂智能体系统的基础。本书第二篇开始，所有概念和操作均基于 Claude Code 展开。Opencode 用户可以对照使用，核心的人机协作方法是相通的。