03 · 工作原理、API 配置与第三方模型

📚 系列导航：上一篇 02 安装与运行形态让你装好了 Claude Code。这一篇拆开盖子看清它怎么干活，再配好 API 让它真正跑起来，最后了解怎么接第三方模型省钱。

第一部分：工作原理

01 代理循环：想 → 做 → 看

Claude Code 干任何活都在重复三个动作：

想（收集上下文）：先搞清楚状况——读相关文件、看报错、查 git 状态
做（采取行动）：动手——改代码、跑命令、新建文件
看（验证结果）：检查刚才做的对不对——跑测试、看输出，不对就再来一轮

每次循环的输出决定下一步。修个 Bug 可能循环好几轮，问「这段代码什么意思」可能只要「想」这一步就够。

TIP

你也在循环里：Claude 自主干活时，你随时能插手：

Esc 按一下：立刻刹车，正在跑的命令取消，等你下一条指令
打字 + Enter：不打断当前操作，发一句补充，它做完手头的就读

02 5 类工具：它凭什么能动手

工具是 Claude Code 能真正动手的原因。没有工具，Claude 只能回你文字；有了工具，它能真的读代码、改文件、跑命令。

工具类别	它能干什么	对应你平时的操作
文件操作	读文件、改代码、新建、重命名	编辑器里打开、敲字、保存
搜索	按文件名找、正则搜内容、翻代码库	`Ctrl+F` 或 `grep`
执行	跑 shell 命令、起服务器、跑测试、用 git	终端里敲命令
网络	搜网页、抓文档、查报错信息	打开浏览器搜一段错误
代码智能	看类型错误、跳转定义、查引用	IDE 的「转到定义」（需插件）

用哪个工具，是模型根据你的话和当前进展自己挑的，不需要你指定。

第二部分：API 配置

03 两种身份验证方式

Claude Code 连模型有两种主流方式：

维度	订阅登录（Claude.ai 账户）	API key（Console / 环境变量）
怎么连	终端跑 `claude`，浏览器登录	配 `ANTHROPIC_API_KEY` 环境变量
怎么计费	按月订阅（Pro / Max / Team）	按 token 用量，从 Console 余额扣
适合谁	个人日常交互式开发	脚本 / CI / 团队按量结算
优先级	低（最底层）	高（盖过订阅）

WARNING

优先级陷阱：环境里只要有 ANTHROPIC_API_KEY，它的优先级就压过你的订阅。你明明登录了 Max 订阅，实际却在烧 API 的钱。切回订阅：unset ANTHROPIC_API_KEY，然后跑 /status 确认。

查当前状态：在 Claude Code 里输入 /status，输出显示当前生效的身份验证方式和模型。

切换模型：输入 /model 弹出选择器，或 /model sonnet 直接切。

模型选择：

opus：最强推理，适合复杂架构/难题
sonnet：日常编程，性价比最高
haiku：快速高效，简单任务
default：跟你的订阅层级走（Pro 默认 Sonnet，Max 默认 Opus）

第三部分：第三方模型接入

04 该不该换第三方模型

维度	官方 Claude	第三方/国产模型
使用成本	高，Opus 尤其消耗明显	低，常低一个数量级
国内直连	需魔法上网	部分国产模型直连
代码能力	第一梯队	够用，复杂任务偶尔翻车
工具调用	最稳	兼容接口偶有边缘行为
配置成本	填 Key 就行	要配一组环境变量
官方支持	一等公民	实验性，没人兜底

该换：API 账单月几百上千的重度用户；连官方费劲的国内用户。 别折腾：已买订阅的（订阅固定费用，换 API 反而额外花钱）；主力干复杂架构/疑难调试的。

05 接 DeepSeek（或任何兼容 Anthropic 协议的模型）

原理：改 ANTHROPIC_BASE_URL 把请求发到第三方地址，配对应的 Key 鉴权。

Mac / Linux：

bash

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-chat

Windows PowerShell：

powershell

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-chat"

TIP

永久生效：临时 export 关窗即失效。要长期用就写进 ~/.zshrc（Mac）、~/.bashrc（Linux）或系统环境变量（Windows）。

验证： 进 Claude Code 后敲 /status，Base URL 应显示为 DeepSeek 的地址。

分层省钱的进阶配置： 给不同档位分配不同模型

bash

# 复杂任务用强模型
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-chat
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-chat
# 轻量任务和子代理用便宜快的
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-chat
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-chat

06 小结

知识点	关键结论
代理循环	想→做→看，转圈直到办完
5 类工具	文件/搜索/执行/网络/代码智能，用哪个模型自己挑
身份验证	API key 优先级 > 订阅，切回订阅就 `unset`
模型选择	难题 `opus`、日常 `sonnet`、杂活 `haiku`
第三方模型	改 `BASE_URL` + `AUTH_TOKEN` + 模型名，`/status` 验证

NOTE

下一篇：04 项目初始化与 CLAUDE.md：API 配好了，接下来进项目干正事——用 /init 让 Claude 自己生成项目说明书，把规矩写进它的记忆，从此不用每次重复交代。

03 · 工作原理、API 配置与第三方模型 ​

第一部分：工作原理 ​

01 代理循环：想 → 做 → 看 ​

02 5 类工具：它凭什么能动手 ​

第二部分：API 配置 ​

03 两种身份验证方式 ​

第三部分：第三方模型接入 ​

04 该不该换第三方模型 ​

05 接 DeepSeek（或任何兼容 Anthropic 协议的模型） ​

06 小结 ​