《Claude Token 业务工程师基础培训》总纲
版本：v1.0 ｜ 日期：2026-08-25 ｜ 负责人：（主人）
配套文件：学习网站.md、模块写作规范.md、各模块 课程.md / 课件.md / 作业.md
公司主营业务为 Claude token 销售，通过 sub2api / newapi 网关跑计费，核心链路为
上游（Claude 密钥/端点）→ 中游（网关 + 计费）→ 下游（客户）。
四位新聘工程师为应届/实习背景，本次基础培训目标：结业时能看懂公司业务链路、能独立完成日常开发与运维任务、能用 Claude Code 交付完整模块。
| 项 | 说明 |
|---|
| 学员 | 4 名应届/实习工程师 |
| 培养方向 | 全栈综合 + 网络基础（TCP/IP、DNS、网站、域名、邮箱）+ AI 工具使用 |
| 课程定位 | 贴合公司技术栈（Python/FastAPI、Vue3/Vite、Postgres、Docker、K8s、GitHub Actions、sub2api） |
| 周期 | 约 4 周（23 个工作日 + 弹性日），可按需伸缩 |
| 教学原则 | 业务驱动、每天有作业、AI 原生（Claude Code 贯穿 + 团队项目收尾） |
业务理解 → 基础设施 → 开发能力 → 核心业务 → 团队实战
每阶段都指向一个目标：看得懂业务、能上手干活。
上游 中游 下游
Claude 端点/key ──► sub2api / newapi 网关 ──► 客户(Claude Code / API)
（鉴权/转发/计费/限流）
| 时段 | 安排 | 说明 |
|---|
| 09:00-10:00 | 昨日作业点评 + 答疑 | 先纠偏再上新 |
| 10:00-12:00 | 授课（对应课件.md） | 理论 + 讲师演示 |
| 13:30-17:00 | 上机实操（对应作业.md） | 用 Claude Code 辅助完成 |
| 17:00-17:30 | 当日小结 + 次日预告 | 记录遗留问题 |
第 4 周为项目期，按"每日站会 + 开发 + 联调"组织，不走上述模板。
| 天 | 模块 | 核心内容 | 当天作业（简） |
|---|
| D1 | 业务全景与开发环境 | Claude token 销售模式、上下游架构、sub2api/newapi 角色、服务清单、环境搭建（账号/SSH key/工具链）、公司规范 | 手画业务架构图 |
| D2 | 网络·TCP/IP | 四层模型、握手挥手、IP/端口/NAT、抓包实操 | tcpdump 抓一次完整请求 |
| D3 | 网络·HTTP/HTTPS | 方法/状态码/Header、TLS/证书、用 curl 调 API | curl 完成带鉴权的 API 调用 |
| D4 | 网络·DNS/域名/网站/邮箱 | DNS 记录、域名→解析→反代→HTTPS 全流程、邮箱协议与域名邮箱配置 | 解析新域名 + 配好邮箱 MX |
| D5 | Linux 基础 | 文件系统/权限/进程/日志、常用命令、SSH | 测试机完成操作清单 |
| D6 | Git + GitHub | Git 工作流、分支/冲突、PR/review/issue、公司仓库规范 + git tag 触发 CI/CD 机制 | 提交第一个 PR |
| 天 | 模块 | 核心内容 | 当天作业（简） |
|---|
| D7 | Docker | 镜像/容器/Dockerfile/compose、镜像仓库(zot) | 容器化一个小服务 |
| D8 | Kubernetes | Pod/Deployment/Service/Ingress、kubectl、公司 prod 只读实操 | 用 kubectl 排查一次服务状态 |
| D9 | Python 基础 | 语法/结构/函数、venv/pip、模块化 | 用 Claude Code 写命令行工具 |
| D10 | FastAPI + API 设计 | 路由/依赖注入/鉴权、REST 规范、Swagger | 写 mini CRUD API |
| D11 | Postgres/SQL | SQL 增删改查、表设计/索引/事务 | mini API 接上数据库 |
| D12 | Vue3 + Vite | 组合式 API、组件/路由、对接后端 | 给 mini API 做管理页 |
| 天 | 模块 | 核心内容 | 当天作业（简） |
|---|
| D13 | LLM 基础与 Claude API | Token/模型/上下文/定价、messages API 调用 | 用 Claude API 完成对话 |
| D14 | 端点验证（核心技能） | 验证 key+base、拉模型、辨可调用模型、上游指纹溯源、RPM/限流 | 完整端点验证并出交付 |
| D15 | sub2api / newapi 计费 | 渠道/令牌/分组/定价、token 计费、余额流水、sub-box | 测试环境跑通 充值→调用→扣费 |
| D16 | Claude Code 工作流 | 安装配置、plan mode、子代理、AI 方法论：生成→看懂→验证→提交（不盲信） | 用 Claude Code 重构前期作业 |
| D17 | 项目立项 | Mini LLM 网关+计费 分工、接口契约评审、数据模型定稿 | 各人完成模块设计文档 |
| 天 | 模块 | 核心内容 | 当天作业 |
|---|
| D18-D20 | 项目开发 | 四人各开发一模块（A代理/B计费/C前端/D部署），每日站会，Claude Code 全程辅助 | 模块内联调 |
| D21 | 集成联调 | 四模块打通、问题修复、准备演示 | 完整链路跑通 |
| D22 | 运维与 CI/CD 实操 | tag→构建→部署全流程实操、监控/日志/备份、OPS_JOURNAL、故障排查演练 | 完成一次真实部署 |
| D23 | 答辩 + 结业考核 | 四人演示各自模块、整体演示、理论考核、结业评估 | — |
项目：Mini LLM API 网关 + 计费系统（复刻 sub2api 核心逻辑，公司真实栈）
| 学员 | 模块 | 职责 | 依赖 |
|---|
| A | 代理服务（FastAPI） | OpenAI 兼容 /v1/chat/completions；Key 鉴权；转发上游 Claude 端点（流式）；调用计费 | 调 B 的计费 API |
| B | 计费引擎（FastAPI + Postgres） | 用户/Key/定价表；token 计数、余额扣减、流水；RPM 限流；暴露计费 API | 供 A 调用 |
| C | 管理面板（Vue3 + Vite） | 用户/Key/充值/用量看板；对接 A/B 的 API | 调 A/B |
| D | 部署与 CI/CD（Docker + GitHub Actions） | Dockerfile、compose、tag 自动构建、集成部署、联调指挥 | 集成 A/B/C |
接口契约：立项日（D17）四人共同评审并定稿接口文档，作为开发期的"法律文件"。
| 维度 | 权重 | 考核方式 |
|---|
| 日常作业 | 30% | 每日作业按时、达标（见各模块作业.md 验收标准） |
| 理论考核 | 20% | D23 笔试（网络/Docker/K8s/LLM/计费基础） |
| 团队项目 | 40% | D23 答辩：四人各演示模块 + 整体链路跑通 |
| 综合表现 | 10% | 学习态度、提问质量、协作 |
结业线：总分 ≥ 70 分，且团队项目链路完整跑通。
- 与 AI 协作、写代码、提交信息一律使用中文。
- git 提交信息规范：中文，格式见 D6 课程。
- 涉及集群操作须遵守 AGENTS.md/CLAUDE.md 的操作分级（Class A 需批准，Class B 直接执行）。
- 有运维价值的操作要在
OPS_JOURNAL.md 记录。
- 新人只读操作公司集群，禁止增删改，练习用测试环境。
docs/training/
00-总纲.md ← 本文档
学习网站.md ← 全模块学习资源清单
模块写作规范.md ← 各模块文件如何写（讲师/维护者用）
01-第1周/D1~D6/ 每模块含 课程.md + 课件.md + 作业.md
02-第2周/D7~D12/ 〃
03-第3周/D13~D17/ 〃
04-第4周/D18~D23/ 〃
| 版本 | 日期 | 变更 |
|---|
| v1.0 | 2026-08-25 | 初版总纲（依据主人需求：应届生/全栈/网络基础/AI使用/贴合公司栈/Claude Code 团队项目） |