非技术背景也能看懂。每个模块说清楚：是什么 → 为什么要用 → 怎么操作。
搞懂"为什么打不开"，再学会"怎么翻过去"——包括 AI 工具为什么也需要代理
中国有一套叫 GFW（Great Firewall / 防火长城） 的国家级网络审查系统，守在所有对外网络出口。 被它列入黑名单的网站（Google、YouTube、Twitter 等），请求到不了目的地，直接超时。
Google 全家桶、YouTube、Twitter/X、Facebook、Telegram 等被主动封锁。
ChatGPT、Claude、Gemini 等识别到中国 IP 后，主动拒绝服务——不是 GFW 挡的，而是对方不让进来。
没被完全封，但门缝挤得很窄——网页极慢、代码拉取频繁断线、图片无法显示。
代理服务器部署在香港、日本、美国等地区，不受 GFW 管辖。你和代理之间的通信是加密的， 且伪装成普通 HTTPS 流量，GFW 看到的只是你在访问一个普通境外地址。
| 场景 | 实际体验 |
|---|---|
| GitHub 网页 | 加载十几秒甚至超时，反复刷都打不开 |
| git clone / push | 频繁断线，几秒钟的操作卡几分钟最后失败 |
| GitHub 图片 | 大量裂图，README 文档的截图全是空白 |
| ChatGPT / Claude | 完全无法访问，直接提示"不在支持的地区" |
老师/管理员会发给你一个订阅链接，格式通常是：
不需要自己找，等老师发就行。
下载 Clash Verge Rev（Windows 选 .exe，macOS 选 .dmg），双击安装，一路点"下一步"。
打开 Clash Verge Rev → 左侧点「订阅」→ 粘贴订阅链接 → 点「导入」，等节点列表加载完成。
左侧点「设置」→ 打开「系统代理」开关 → 托盘图标变色 = 代理已生效。
左侧点「代理」→ 选延迟低的节点（优先香港或日本）→ 打开浏览器访问 google.com，能打开就成功了！
浏览器已走代理，但 Git 命令行默认不走，需要额外配置：
当前节点的 IP 被 AI 服务商标记了（太多人用同一节点，或者是数据中心 IP）。 技术上你已经翻墙，但 AI 公司那边还是识别出了异常。
git config --global --get http.proxy。git config --global --unset http.proxy 和 git config --global --unset https.proxy。git config --global --get http.proxy 有输出）先搞懂"时光机" Git，再学会用团队的"共享代码云盘" GitHub
运行在你电脑本地的工具。每改好一个阶段就"拍一张快照"，任意历史版本都能找回来。不依赖网络。
全球最大代码托管平台。把 Git 记录同步上去，团队所有人都能看到最新版本、谁改了什么。
| 词 | 大白话 |
|---|---|
| 仓库 Repository | 一个被 Git 管理的项目文件夹，存在 GitHub 上 |
| 提交 commit | 给当前状态"拍一张照片，写个备注"保存起来 |
| 分支 branch | 开一条"草稿通道"，改好了再合进主版本，不影响主线 |
| clone | 把 GitHub 上的仓库整个下载到本地（只做一次） |
| pull | 别人更新了，我把最新版本拉取到本地 |
| push | 我改好了，推送到 GitHub 让别人也能看到 |
| Pull Request（PR） | 申请把自己的改动合并进主版本，等团队审查通过 |
| Issue | 问题追踪——报 Bug 或提需求用的"工单" |
两人同时改同一个文件，其中一个的改动消失了，还不知道是谁改的。有了 Git：谁改的、什么时候、改了哪几行，一目了然，任意版本都能找回来。
打开「终端 Terminal」（启动台 → 其他），输入：
如果没装，系统会自动弹窗提示安装「命令行开发者工具」，点「安装」等待完成即可。
下载 Git for Windows（老师会发链接），双击安装包一路「下一步」，保持默认选项。安装后开始菜单会出现 Git Bash——以后打 Git 命令就用它。
告诉 Git 你是谁，之后每次提交都会带上你的名字：
GitHub 在国内需要代理，先开代理再访问。
填邮箱（建议公司邮箱）、密码（大小写+数字，8位以上）、用户名（如 zhangsan）。
打开注册邮件，点击链接完成验证。
头像 → Settings → 上传头像、填写姓名，方便同事认出你。
Settings → Password and authentication → Two-factor authentication → Enable。 用手机认证器 App（Microsoft Authenticator 或 Google Authenticator）扫描二维码。
三次询问都直接回车（默认路径，不设密码）。
执行后没有任何提示，但公钥已在剪贴板，正常。
GitHub → 头像 → Settings → SSH and GPG keys → New SSH key → 粘贴公钥 → 保存。
| 想干的事 | 命令 | 大白话 |
|---|---|---|
| 第一次下载项目 | git clone 网址 | 整个抄一份到我电脑 |
| 获取最新版本 | git pull | 有新的就更新下来 |
| 查看改了哪些文件 | git status | 我刚动了哪些东西？ |
| 打包所有改动 | git add . | 把改动放进"购物车" |
| 提交快照 | git commit -m "说明" | 给这次改动"拍照存档" |
| 推送到 GitHub | git push | 把存档同步到网上 |
| 查看历史记录 | git log --oneline | 之前都做过哪些存档？ |
| 撤销未打包的改动 | git restore 文件名 | 改乱了，恢复到上次存档 |
git pull 拉取合并，再 git push。git config --global http.proxy http://127.0.0.1:7890ssh -T git@github.com 是否返回成功消息。如果 SSH 没问题，说明没有该仓库的写权限，联系管理员添加。git restore 文件名 或 git restore .git restore --staged 文件名，再 git restore 文件名。
git --version 显示版本号ssh -T git@github.com 返回成功消息gh auth status 显示已登录搞懂 Markdown，看懂 AI 输出，写出漂亮文档——用最少的符号表达最清晰的格式
**你好** → 显示出来就是 你好.md，纯文本，记事本都能打开。
今天做了两件事：
备注：需要补充第三部分
AI 没法"点按钮加粗"，只能输出字符串。Markdown 是纯文本里能表达格式的最自然方式。
GitHub、技术博客、Wiki 里有海量 Markdown。AI 学了大量例子，自然就会用。
ChatGPT、Claude 的界面内置渲染器，你看到的已经是"好看版本"，背后是 Markdown。
💡 # 后面必须有一个空格，否则不生效。
行内代码 — 命令/文件名用三个反引号 ``` 包裹，第一行可以加语言名称（实现语法高亮）：
1 的左边，Esc 键的下面。注意要切换到英文输入法。| 姓名 | 部门 | 工号 |
|---|---|---|
| 张三 | 技术部 | 001 |
| 李四 | 产品部 | 002 |
在 GitHub 的 Issue 和 PR 中经常用到，[x] 会显示为打勾的复选框。
| 想要的效果 | 怎么写 | 备注 |
|---|---|---|
| 一级标题 | # 标题 | 前面一个 #，后跟空格 |
| 二级标题 | ## 标题 | 前面两个 # |
| 加粗 | **加粗** | 两边各两个星号 |
| 斜体 | *斜体* | 两边各一个星号 |
~~删除线~~ | 两边各两个波浪号 | |
| 无序列表 | - 内容 | 减号加空格 |
| 有序列表 | 1. 内容 | 数字加点加空格 |
| 超链接 | [文字](网址) | 方括号放文字，圆括号放链接 |
| 图片 |  | 比超链接多一个感叹号 |
| 行内代码 | `代码` | 用反引号包裹 |
| 代码块 | ```语言 + 代码 + ``` | 三个反引号开头和结尾 |
| 引用 | > 引用内容 | 大于号加空格 |
| 分隔线 | --- | 三个减号 |
| 待办已完成 | - [x] 内容 | 方括号里有 x |
| 待办未完成 | - [ ] 内容 | 方括号里是空格 |
#标题 不生效，必须写 # 标题（# 后有空格）。列表 - 内容 中减号后也必须有空格。1 的左边，Esc 键的下面。注意切换到英文输入法，中文下的顿号「、」不是反引号。Cmd/Ctrl+Shift+V），或 Typora（所见即所得）
让"换 Claude Code 线路"这件事，从需要懂技术变成人人都会的一键操作
每次输入，Claude Code 都要连接远程服务器。这个服务器的地址 + 你的身份凭证，统称为一条「线路」。
| 线路的三要素 | 通俗解释 | 示例 |
|---|---|---|
| 名称 | 你给这条线路取的名字 | 主力线路、备用 |
| 地址（Base URL） | 服务商的"门牌号" | https://api.xxx.com |
| 密钥（API Key） | 你的专属"通行证" | sk-xxxxxxxxxxxx |
Claude 服务器在国外，代理没开，请求根本发不出去。
服务商维护、用户太多、IP 被临时标记，换一条线路通常立刻恢复。
每条线路有有效期和使用配额，超出后需要换新密钥或换线路。
主力 + 备用 + 再备用，都存在 CC Switch 里。
点选线路 → 点切换 → 重开 Claude Code，30 秒恢复正常。
手动改 JSON 配置容易出错；CC Switch 在后台帮你写好，不需要你碰任何文件。
双击下载的 .dmg 文件，把 CC Switch 图标拖进「应用程序」文件夹。
从「启动台」打开。若提示"无法验证开发者"，去
「系统设置 → 隐私与安全性」→ 点「仍要打开」。
双击 .exe 安装包。若弹出"Windows 已保护你的电脑"，点「更多信息 → 仍要运行」。
一路点「下一步」完成安装，从桌面或开始菜单打开。
你会收到类似这样的信息：
填入 CC Switch：
| CC Switch 表单字段 | 填什么 |
|---|---|
| 名称 / Name | 你给这条线路取的名字，如「主力」「老师的线路」 |
| 地址 / Base URL | 以 https:// 开头的网址 |
| 密钥 / API Key | 以 sk- 开头的字符串 |
在配置列表里找到你想用的线路，点击选中。
等待成功提示。
Claude Code 在启动时读取配置，切换后必须关掉再开一次，否则还用的是老配置。
输入「你好，能听到我吗？」，Claude 正常回复 = 切换成功。
代理客户端（Clash 等）是否开着？
开着的话，当前节点能访问 Google 吗？
不能 → 在 Clash 里换一个节点。
打开 CC Switch，换一条备用线路，切换完重开 Claude Code。
可能是密钥过期或线路整体故障，联系管理员处理。