如何使用 Claude Code：先安装并登录，在项目目录用最小任务验收「能读写文件」，国内再补 Clash Verge 出站。浏览器能开 Claude.ai，不代表终端里的 Claude Code 已经通网。
代理专文见国内 Claude Code 代理配置；网页/Desktop 见Claude.ai / Desktop；同类 CLI：如何使用 Codex CLI、Codex 代理、Tun 与 AI 工具。
它适合干什么、不适合干什么
| 场景 | 适合 | 不适合 / 慎用 |
|---|---|---|
| 读仓库、改小范围代码 | 是 | 无版本控制就大删大改 |
| 跑测试、看报错日志 | 是 | 把生产密钥写进提示词 |
| 国内访问 Anthropic | 需代理 | 只开系统代理却指望 CLI 自动跟上 |
| 替代 IDE 全部功能 | 否 | 当成「装完就永不看 diff」 |
安装与登录（先本地跑通）
- 按 Anthropic / Claude Code 官方说明安装（常见为独立安装包或 npm 全局命令，以官网当前文档为准）。
- 打开新终端，执行登录或写入 API Key；旧窗口可能读不到刚导出的环境。
-
cd到你的 Git 仓库根目录，不要在随意的家目录里试——路径乱时它改的文件你更难审查。 - 先问一个只读问题：「这个目录是什么项目？入口文件在哪？」确认它真的看见了仓库。
安装包来源只用官方渠道。本站提供的是 Clash Verge Rev 下载，不是 Claude Code 安装包。
日常怎么用：可复用的五步
-
说清楚边界：「只改
src/foo.ts，不要动配置文件」。 -
给可验证目标：「改完后
npm test要过」比「优化一下」好验收。 - 一次一事：重构 + 新功能 + 改 CI 拆开，失败时才分得清是哪一步。
- 看 diff 再提交：Agent 会漏看约束；你负责最后一道闸。
- 网络异常先停手：连续 timeout 时先查代理，别连换三个模型「碰运气」。
国内环境：什么时候必须上 Clash Verge
出现 connection timeout、fetch failed、长时间无响应，而浏览器访问正常——优先怀疑终端没走代理。处理顺序：
- Clash Verge 已连接可用节点；浏览器能开一个海外站点。
- 开 Tun，或按代理专文导出
HTTP_PROXY/HTTPS_PROXY到 Mixed Port。 - 新开终端再跑 Claude Code；旧会话常不带新变量。
- 在 Clash 连接页看有没有 Anthropic 相关出站；没记录=路径问题，有记录仍失败=节点地区或账号侧。
PowerShell / Git / npm 一并要代理时，对照终端代理；WSL2 见WSL2 代理。
和 Cursor、Codex 怎么分工
- Claude Code：偏终端 Agent、仓库级改动。
- Cursor：偏 IDE 内编辑；代理见Cursor 代理。
- Codex CLI：OpenAI 生态；用法见如何使用 Codex，代理见专文。
同一台机可以共用一个 Clash，但验收要分开做：今天只测 Claude Code，就只打它的最小请求，避免连接页刷成一团。
常见翻车与止损
| 现象 | 先查 | 下一步 |
|---|---|---|
| timeout / 无响应 | 连接页有无记录 | Tun / 变量 / 新终端 |
| 鉴权失败 | Key、订阅、组织权限 | 别和代理混谈 |
| 改错目录 | 当前 cwd | 回到仓库根再开任务 |
| 端口对不上 | 界面 Mixed Port | 端口冲突 |
小结
会用 Claude Code = 会下小任务 + 会看 diff + 国内会验代理。客户端从下载中心获取；Tun 总览给 AI 工具开全局代理；入门代理排错仍回Claude Code 代理配置。