API 与配置：从申请密钥到文件任务
在官方平台申请API Key，再用CC Switch配置支持的Agent。
1. 准备 Key 和配置工具
先安装 Agent，再申请模型服务的 APIKey。Claude Code、Codex 和 Pi 的配置优先使用CC Switch，DeepSeek Harness 则在自己的模型设置中填写。Key 是服务商签发的秘密凭据，CC Switch 只负责管理配置。想用GPT模型的朋友可以来我自己的中转
邀请码：
445c4578875b82843ed4aa3d97bd7462
ae40f971e9c2caeefb1035b2a57c546f
2ca702874e1166d7b96d60968f5e0a39
fb3f3b390aa73d67c67767d9d6baf600
e39e27036a179e1167f07a3392cdf8fb| 目标 | 接下来读什么 |
|---|---|
| 用 DeepSeek API 跑通 Codex | Codex 入门和DeepSeek 专门指南 |
| 在终端中使用 DeepSeek | Pi 入门 |
| 先用 Web 界面操作 | DeepSeek Harness 入门 |
| Claude Code 接 DeepSeek 供应商适配 | Claude Code 及支持边界 |
下面先介绍 DeepSeek 和百炼。GLM、MiniMax、Kimi 的申请教程会后续补充。
2. 获取 DeepSeek API Key
- 打开DeepSeek 首次调用官方文档。
- 从文档中的官方平台／API Key 入口进入控制台，自行完成账号步骤。
- 查看当前服务、费用、余额要求，再决定是否充值。聊天会员不直接等于 API 余额。
- 创建 Key，保存在自己的密码管理器或客户端私有配置中；不要粘贴到本站、公开笔记或截图。
- 返回所选 Agent 的专门指南，取得其协议、地址与模型标识，不把通用接口复制给全部工具。
准备好 Key 后，记下对应的服务入口和模型名，继续配置客户端。具体填写、添加和启用步骤见CC Switch 教程；DeepSeek Harness 按自己的模型设置操作。
3. 百炼：按自己的套餐分支操作
分别阅读百炼 Claude Code或百炼 Codex。
| 检查项 | 操作 |
|---|---|
| 服务类型 | 确认按量计费、Coding Plan 还是 Token Plan |
| Key | 从对应服务创建，不假设不同套餐通用 |
| Base URL | 使用同一分支的地址与地域 |
| 模型 | 核对该套餐支持的完整标识 |
| 客户端版本 | 对照协议分支，不照搬旧版参数 |
| 调用规则 | 先看当前 Coding Plan 说明 |
百炼 Codex 文档存在要求旧版的 Chat/Completions 分支，不是最新版通用配置；也不由单家供应商说明推断所有 Codex 实现均不支持 Chat。新手不默认降级，先确认具体版本、模型、协议组合。
Coding Plan 限制编程工具交互场景。因此这类套餐不采用 curl、Postman、SDK 或脚本批量调用作为本站默认验证；应在允许的客户端中交互测试。普通 API 同样先确认服务规则和预算。
4. 把 Key 交给客户端
还没有 API Key，先按上面的申请步骤准备；需要使用 Claude Code、Codex 或 Pi 时，按CC Switch 教程完成下载、备份、添加供应商、填写 Key、启用及切回。配置时重点检查 Key 属于哪个套餐、地址属于哪个服务、模型是否可用。预设能减少手写配置，但不会替你补足模型权限或余额。
DeepSeek Harness 继续使用自带模型设置。遇到错误时，先看各工具入门课中的特有问题。
5. 试一次文件任务
Key 配置完成后，按第一项任务在练习目录完成读取、创建、检查和定向修改；练习时使用无隐私数据，并在完成后查看服务商用量。扩展安装放在基础任务之后。
6. 失败时按现象检查
| 现象 | 第一检查项 | 下一步 |
|---|---|---|
| 401／鉴权失败 | Key 是否属于当前套餐／入口 | 查启动终端变量、旧凭据覆盖 |
| 模型不存在 | 完整模型名和账号权限 | 回到当前官方模型目录 |
| 超时 | 端点与网络条件 | 区分安装下载与模型调用，保留脱敏错误 |
| 能聊但不读写 | 工具协议和客户端权限 | 检查工具调用返回，不只看聊天响应 |
| 配置未生效 | 用户／项目范围和旧会话 | 重新启动，检查覆盖顺序 |
| 429额度／限流 | 余额、套餐和速率 | 控制台核对，不无限重试 |
反馈只提供版本、系统、服务分支、脱敏错误和复现步骤。Key 泄露先撤销并重建，不只是删截图。
参考资料
- 菜鸟 Coding Plan：概念导读，历史促销和价格不当作当前购买依据。
- 菜鸟 Codex 接入 DeepSeek：流程导读，模型及脚本行为以 DeepSeek 官方为准。
- 资源导航：按工具找中文课程和官方材料。
资料整理于2026-09-13；API 调用与各网络环境尚待实测。