# Claude Code 使用教程（2026）：国内安装、登录、代理设置与常用命令

> Claude Code 使用教程：国内怎么安装和登录、代理怎么设置、日常怎么用。给出官方安装命令（脚本、Homebrew、WinGet、npm），讲 HTTPS_PROXY 与 TUN 两种代理设置、常用命令、节点验证、和 Cursor、Codex 的区别，以及地区不可用与长任务断连的处理。

来源：11号登机口（https://jichanggege.mom/ai/claude-code/）｜更新于 2026-11-19｜引用请注明来源与核对日期

Claude Code 使用教程：国内怎么安装和登录、代理怎么设置、日常怎么用。给出官方安装命令（脚本、Homebrew、WinGet、npm），讲 HTTPS_PROXY 与 TUN 两种代理设置、常用命令、节点验证、和 Cursor、Codex 的区别，以及地区不可用与长任务断连的处理。

更新于 2026 年 11 月 19 日 · 约 6860 字 · 15 分钟读完 · 11号登机口编辑

快速结论

这篇 Claude Code 使用教程先给结论：Claude Code 用官方安装脚本一条命令就能装好，账号需要 Pro、Max 等付费套餐或 Console 账号，免费套餐不包含。它是命令行程序，不读系统代理：要么在启动前设置 HTTPS_PROXY 环境变量，要么打开代理客户端的 TUN 模式。官方文档写明不支持 SOCKS 代理，所以环境变量里要填 http:// 开头的地址。长任务最怕出口 IP 中途变化，给它固定一个支持地区的节点。本文的命令都来自官方文档，动手前建议对照官方页面核对一次。

## Claude Code 国内怎么用：准备什么、按什么顺序

在国内用 Claude Code，比用网页版 Claude 多两个环节：终端要单独走代理，登录时浏览器和终端要走同一个出口。账号层面的门槛和网页版一样，注册要过支持地区的手机号验证，见 [Claude 使用教程](https://jichanggege.mom/ai/claude/)。整体顺序如下：

1. **先有一个能用 Claude Code 的账号。** 付费套餐或 Console 账号，免费套餐不行。
2. **代理客户端选好节点。** 支持地区、手动固定，记下客户端的本地 HTTP 端口（Clash 系一般叫混合端口）。
3. **让终端走代理。** 设置 HTTPS_PROXY 环境变量，或打开 TUN 模式，做法见下文「代理设置」一节。
4. **在终端里确认出口。** 用 curl 查一次出口 IP，地区要在支持名单内，并且和浏览器一致。
5. **运行官方安装命令。** 安装脚本也要访问境外服务器，所以这一步必须在第 3 步之后。
6. **运行 claude 登录。** 浏览器授权，回到终端确认登录成功。
7. **先跑一个小任务，再跑长任务。** 确认节点在长连接下也稳定。

很多人在第 5 步就卡住，原因几乎都是终端没走代理：浏览器开着代理能上 Claude，不代表终端也能。记住这条，后面的问题会少一大半。其他命令行工具（git、npm、pip）的代理写法见 [终端走代理教程](https://jichanggege.mom/jiaocheng/zhongduan-daili/)。

## 安装前先确认三件事

**系统。** 官方文档列出的支持范围是 macOS 13 及以上、Windows 10 1809 及以上、Ubuntu 20.04 及以上、Debian 10 及以上，以及 Alpine Linux；内存 4 GB 以上，x64 或 ARM64 处理器。Windows 上可以原生运行，也可以装在 WSL 里。

**账号。** 官方说明 Claude Code 需要 Pro、Max、Team、Enterprise 等付费套餐，或者 Console 账号，免费的 claude.ai 套餐不包含 Claude Code。套餐名称和价格会调整，以官方定价页为准。账号注册和手机验证的规则见 [Claude 使用教程](https://jichanggege.mom/ai/claude/)。

**地区。** 系统要求里有一条是所在地要在 Anthropic 支持的国家和地区内，名单在 https://www.anthropic.com/supported-countries。这意味着安装、登录、使用三个环节，出口 IP 都要落在支持地区。

官方文档入口是 https://code.claude.com/docs，下面的命令都来自其中的安装页。命令会更新，动手前建议对照官方页面再看一眼。

## Claude Code 安装：官方命令与各渠道对比

官方推荐原生安装脚本，它会在后台自动更新。

macOS、Linux、WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

Windows CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

其他官方渠道：

# Homebrew brew install --cask claude-code

# WinGet
winget install Anthropic.ClaudeCode

# npm，官方说明需要 Node.js 22 或更高版本，不要加 sudo
npm install -g @anthropic-ai/claude-code
</code></pre>

| 方式 | 自动更新 | 适合谁 |
| --- | --- | --- |
| 原生安装脚本 | 会，后台自动更新 | 大多数人 |
| Homebrew | 默认不会，需要手动 brew upgrade claude-code | 习惯用 brew 管理软件的 macOS 用户 |
| WinGet | 默认不会，需要手动 winget upgrade Anthropic.ClaudeCode | Windows 用户 |
| npm | 视权限而定 | 已有 Node 环境、想跟着项目管理版本的人 |
| apt、dnf、apk 软件源 | 跟随系统升级 | Linux 服务器，配置步骤见官方文档 |

装完后新开一个终端窗口验证：

claude --version claude doctor

claude --version 能打印版本号就说明装好了；claude doctor 会输出安装和配置的诊断信息。提示找不到 claude 命令，通常是安装目录没有加进 PATH，官方排错页有对应步骤。

## 安装时就要让终端走代理

安装脚本本身也要访问 Anthropic 的服务器。终端没走代理，或者出口在不支持的地区，脚本拿到的会是一个网页或错误码，而不是安装脚本。典型表现：

- syntax error near unexpected token '<'：下载到的是 HTML 页面。
- curl: (22) The requested URL returned error: 403：请求被拒绝，官方说明常见原因是网络过滤，或所在地区不被支持。
- 报错里出现 App unavailable in region：出口 IP 所在地区不被支持。

处理办法是先让当前终端走代理，再运行安装命令。官方给的写法是设置两个环境变量，地址换成你代理客户端的本地端口，下面的 7890 只是示例：

export HTTP_PROXY=http://127.0.0.1:7890 export HTTPS_PROXY=http://127.0.0.1:7890 curl -fsSL https://claude.ai/install.sh | bash $env:HTTP_PROXY = 'http://127.0.0.1:7890' $env:HTTPS_PROXY = 'http://127.0.0.1:7890' irm https://claude.ai/install.ps1 | iex

想先确认下载服务器是否可达，可以用官方排错页里的检查命令，第一行返回 200 就说明连得上：

curl -sI https://downloads.claude.ai/claude-code-releases/latest

端口号在代理客户端的设置页能看到，一般叫混合端口或 HTTP 端口。更多终端代理的写法见 [终端、Git、npm、Docker 走代理](https://jichanggege.mom/jiaocheng/zhongduan-daili/)。

## Claude Code 怎么登录：浏览器授权与无界面环境

在项目目录里运行 claude，首次启动会打开浏览器让你登录并授权，完成后终端显示登录成功。几个实用细节，都来自官方文档：

1. 浏览器没有自动打开时，按 c 复制登录链接，手动粘贴到浏览器。
2. 浏览器登录后显示的是一串代码而不是自动跳回，就把代码粘贴到终端的提示处。
3. 在 SSH、WSL、容器里登录，浏览器可能开在另一台机器上，同样用复制链接、粘贴代码的方式完成。也可以运行 claude auth login。
4. 重新登录用 /login，退出用 /logout，查看当前登录方式和代理状态用 /status。

登录环节有两处和代理有关。浏览器里的授权页面走的是浏览器的代理设置，终端里的令牌交换走的是终端的代理设置，两边都要通，而且最好是同一个出口。只有浏览器通，会表现为网页上授权成功、终端却一直等待或报连接错误。

所以登录之前先做一次检查：在终端里查一下出口地区，确认和浏览器一致、并且在支持名单内，再运行 claude。这一步能省掉大半登录类的报错。

## Claude Code 代理设置：环境变量与 TUN 模式

命令行程序默认不读系统代理，所以"浏览器能上 Claude，终端里的 Claude Code 连不上"几乎是每个新用户都会遇到的情况。有两条路。

**环境变量。** Claude Code 支持标准的代理环境变量：

export HTTPS_PROXY=http://127.0.0.1:7890 export HTTP_PROXY=http://127.0.0.1:7890 claude

官方文档里有三点要记住：

- **不支持 SOCKS 代理。** 地址必须是 http:// 开头。Clash 系客户端的混合端口同时提供 HTTP 代理，直接填它即可；只设置 all_proxy=socks5://... 是不够的。
- **变量只在启动时读取一次。** 先设置变量再运行 claude，已经在运行的会话不会感知后来的修改。
- **可以写进配置文件。** 这些变量也能放在 ~/.claude/settings.json 的 env 字段里，省得每次手动设置。官方还特别说明，放到后台运行的会话不一定继承你当前终端的环境，网络相关的变量要放在这个配置文件里才能稳定生效。

{ "env": { "HTTPS_PROXY": "http://127.0.0.1:7890", "HTTP_PROXY": "http://127.0.0.1:7890" } }

进入会话后运行 /status，其中有一行显示当前生效的代理地址，用来确认配置有没有被读到。

需要让公司内网地址或本机服务绕开代理时，可以同时设置 NO_PROXY，列出不走代理的地址，用逗号分隔。具体支持哪些写法，以官方网络配置文档的当前说明为准。

**TUN 模式。** 打开代理客户端的 TUN 模式后，所有程序的流量都在网络层被接管，Claude Code 不需要任何设置，它调用的 git、npm 等工具也一并走代理。代价是需要管理员权限，可能和公司 VPN 冲突。原理见 [规则、全局与 TUN 模式](https://jichanggege.mom/jiaocheng/fenliu-tun/)，开不了见 [TUN 模式开不了](https://jichanggege.mom/paicha/tun-kaibuqi/)。

| 对比 | 环境变量 | TUN 模式 |
| --- | --- | --- |
| 生效范围 | 只有设置了变量的终端和它启动的程序 | 整台电脑 |
| 权限 | 不需要 | 需要管理员权限或安装服务 |
| 子进程 | 多数会继承，个别工具有自己的代理配置 | 全部覆盖 |
| 适合 | 只在终端里用 Claude Code | 还要用桌面应用、IDE 插件，或者不想逐个配置 |

WSL 里的情况多一层：WSL 是一台虚拟机，127.0.0.1 指向的是它自己而不是 Windows。这时要么在 Windows 侧开 TUN，要么让客户端允许局域网连接，并把代理地址换成 Windows 主机的地址，思路见 [局域网共享代理](https://jichanggege.mom/jiaocheng/juyuwang-gongxiang/)。Linux 服务器上直接跑内核的做法见 [Linux 上用 mihomo](https://jichanggege.mom/jiaocheng/linux-mihomo/)。

## 各平台的差异：macOS、Windows、WSL、Linux 服务器

同一套命令在不同系统上的细节不一样，下面这张表把容易踩坑的地方放在一起。

| 平台 | 推荐的安装方式 | 代理变量的写法 | 需要留意 |
| --- | --- | --- | --- |
| macOS | 安装脚本或 Homebrew | export 写进 ~/.zshrc | 凭据存在系统钥匙串；从程序坞启动的 IDE 不继承终端里的变量 |
| Windows 原生 | PowerShell 脚本或 WinGet | $env: 只对当前窗口有效 | 原生运行所需的组件以官方文档当前说明为准 |
| WSL | 在 WSL 里运行 Linux 安装脚本 | export，地址不能写 127.0.0.1 | 要在 Windows 侧开 TUN，或让客户端允许局域网连接 |
| Linux 服务器 | 安装脚本或系统软件源 | export 或 settings.json | 没有浏览器，登录用复制链接；服务器自身的出口也要在支持地区 |

**让变量长期生效。** 每次手动 export 很容易忘。有三种持久化办法，选一种：

1. 写进 ~/.claude/settings.json 的 env 字段。只影响 Claude Code，代理客户端关掉时其他程序不受连累，最推荐。
2. 写进 shell 的配置文件，例如 ~/.zshrc 或 ~/.bashrc。这样 git、npm 等也一起走代理，但代理客户端一旦退出，这些命令全部连不上。
3. Windows 上设为用户级环境变量，写法是 [Environment]::SetEnvironmentVariable('HTTPS_PROXY','http://127.0.0.1:7890','User')，设置后要重新打开终端。

服务器上用 Claude Code，还要注意一点：服务器本身的出口地区就是 Anthropic 看到的地区。服务器在不支持的地区，本地开多少代理都没有用，要么让服务器自己走代理，要么换一台位于支持地区的服务器。

## 在 IDE 和桌面应用里使用

官方提供了 VS Code 扩展和 JetBrains 插件，入口在 Claude 官方下载页和 Claude Code 文档里，Claude 桌面应用里也能使用 Claude Code。这几种用法共享同一个账号和同一份配置，网络上的区别在于它们由谁启动。

- **从图形界面启动的 IDE。** 它不继承你在终端里 export 的变量，这是"终端里好好的，IDE 里连不上"的最常见原因。把代理写进 ~/.claude/settings.json 的 env 字段，或者开 TUN。
- **从终端启动的 IDE。** 例如在终端里输入 code . 打开的 VS Code，会继承这个终端的变量，但只限这一次启动。
- **桌面应用。** 按 [Claude 使用教程](https://jichanggege.mom/ai/claude/) 里桌面应用的网络设置处理，连不上就开 TUN。

IDE 里的扩展同样需要安装，扩展市场本身也可能要走代理才能顺利下载，扩展只从 IDE 内置的官方市场或官方文档给出的入口安装。

## Claude Code 用什么节点：地区与分流规则

简短回答：用支持地区的节点，手动固定，香港节点不行，不要用自动测速组。Claude Code 主要访问 api.anthropic.com，登录时还会用到 claude.ai、claude.com、platform.claude.com，安装和更新走 downloads.claude.ai。官方网络文档里有完整的域名表。分流规则至少包含下面几条，并指向一个手动选择的策略组：

rules: - DOMAIN-SUFFIX,anthropic.com,AI - DOMAIN-SUFFIX,claude.ai,AI - DOMAIN-SUFFIX,claude.com,AI

节点选择上，地区要在支持名单内，香港节点不行；策略组用手动选择，不要用自动测速；IP 类型上，标注原生 IP 或家宽 IP 的节点一般更不容易被拦，这些是机场的官方标注，本站未验证。背后的原因见 [AI 工具的网络环境怎么配](https://jichanggege.mom/ai/wangluo-huanjing/) 和 [机房 IP 与 AI 风控](https://jichanggege.mom/zhishi/jifang-ip/)。

**在终端里验证一个节点。** 浏览器里的检查不能代替终端，因为两者可能走的是不同出口。按下面的顺序在终端里确认：

1. 用 curl 访问任意一个查询出口 IP 的服务，确认终端的落地地区在支持名单内，并且和浏览器查到的一致。
2. 运行 curl -I https://api.anthropic.com，能返回响应头就说明终端到 API 是通的，状态码本身不重要。
3. 启动 claude，运行 /status，确认代理地址被读到了。
4. 先让它做一件小事，例如总结项目里的说明文件；再交给它一个需要几分钟的任务，观察中途有没有断连提示。
5. 在晚高峰重复第 4 步。能稳定跑完长任务的节点才适合固定下来。

| 现象 | 判断 |
| --- | --- |
| 第 1 步查到的地区和浏览器不同 | 终端没走代理，或走了另一个策略组 |
| 第 2 步超时 | 终端到 API 不通，先查变量或 TUN |
| 小任务正常，长任务频繁断 | 节点或线路不稳，换节点比调大超时更有效 |
| 白天和晚上都能跑完长任务 | 适合固定使用 |

## Claude Code 怎么用：第一次会话与常用命令

装好、登录、网络都通了之后，日常用法其实很简单：进入项目目录，运行 claude，用自然语言告诉它要做什么。它会读代码、提出修改方案、在你确认后改文件和运行命令。下面是新手最常用的命令，完整列表在会话里输入 /help 查看，不同版本略有差异，以 /help 的输出为准：

| 命令 | 作用 |
| --- | --- |
| claude | 在当前目录启动交互式会话 |
| claude -p "问题" | 不进入交互界面，直接输出一次回答，适合写进脚本 |
| claude --continue | 继续当前目录最近一次会话 |
| claude --resume | 从历史会话列表里选择一个继续 |
| /init | 让它扫描项目，生成一份项目说明文件，之后每次会话都会读取 |
| /clear | 清空当前对话上下文，开始新任务时用 |
| /compact | 压缩较长的对话历史，节省上下文 |
| /model | 切换使用的模型，可选范围取决于你的套餐 |
| /status | 查看账号、模型和代理状态，排查网络问题时先看它 |
| /login、/logout | 重新登录、退出登录 |

几条上手建议：

- **第一次进一个项目先运行 /init。** 生成的说明文件里写上项目怎么构建、怎么测试、有哪些约定，它之后会照着做，比每次口头交代省事。
- **任务说具体。** 「修一下登录的 bug」不如「用户在登录页输入错误密码时页面没有提示，找到原因并修复，改完运行现有测试」。
- **改动前先有版本管理。** 在 git 仓库里用，出了问题可以回退。权限确认提示看清楚再同意，尤其是删除文件和运行安装命令。
- **换任务就 /clear。** 上下文里堆着上一个任务的内容，会干扰新任务，也更耗额度。

## Claude Code 和 Cursor、Codex 有什么区别

三者都能帮你写代码，形态和网络要求不一样：

| 对比 | Claude Code | Cursor | Codex CLI |
| --- | --- | --- | --- |
| 形态 | 命令行工具，也有 IDE 扩展和桌面应用入口 | 独立的代码编辑器 | 命令行工具，另有 IDE 扩展和云端任务 |
| 账号 | Claude 付费套餐或 Console 账号 | Cursor 自己的账号与套餐 | ChatGPT 账号或 OpenAI API 密钥 |
| 地区名单 | Anthropic 支持名单 | 受所选模型提供方的地区限制影响 | OpenAI 支持名单 |
| 代理方式 | 环境变量或 TUN，不支持 SOCKS | 系统代理，不通再开 TUN | 环境变量或 TUN |

选哪个主要看你习惯在终端里工作还是在编辑器里工作，以及手里已有哪家的订阅。各自的网络设置见 [Cursor 使用教程](https://jichanggege.mom/ai/cursor/) 和 [Codex CLI 使用教程](https://jichanggege.mom/ai/codex/)。套餐和功能变化较快，以各家官方说明为准。

## 长任务断连怎么处理

Claude Code 的一个任务可能连续跑十几分钟，中间是一条条流式长连接。节点抖动、策略组自动切换、电脑休眠，都会让连接中断。

先了解它自身的容错，下面的行为来自官方的错误说明页：

- 遇到临时性错误会自动重试，默认最多十次，间隔逐步拉长。
- 响应还没开始就断开，它会重新发起请求，这一轮对话继续。
- 响应进行到一半、已经完成了部分输出或工具调用之后才断开，它不会重跑这次请求，因为那可能让工具调用被执行两遍。它会保留已完成的部分，并提示 API Error: Connection lost mid-response. The response above may be incomplete.，这时再发一条消息让它接着做即可。
- 连接长时间没有任何数据，内置的看门狗会判定连接已死并中止，避免一直挂着。

你这边能做的：

1. **固定节点。** 这是最有效的一条。自动测速组每隔几分钟重新选节点，对长连接是灾难。
2. **避开晚高峰不稳定的节点。** 判断方法见 [延迟、丢包与速度](https://jichanggege.mom/zhishi/yanchi-sudu/)。
3. **别让电脑休眠。** 合盖或休眠后网络断开，会话里的请求必然失败。
4. **会话可以接着用。** 终端关掉或进程退出后，在同一个项目目录运行 claude --continue 继续最近一次会话，或用 claude --resume 从列表里选择。
5. **代理响应慢时调整超时。** 官方说明 Request timed out 可以通过调大 API_TIMEOUT_MS 缓解，但这只是治标，节点不稳还是要换节点。

## 常见报错与处理

| 报错 | 含义 | 处理 |
| --- | --- | --- |
| App unavailable in region | 出口 IP 所在地区不被支持 | 换到支持地区的节点，确认终端确实走了代理 |
| Unable to connect to API 及各种连接类提示 | 终端到 API 不通 | 检查环境变量或 TUN，再看节点是否可用 |
| 提示无法通过代理连接 | 代理地址或端口写错，或客户端没有运行 | 核对端口，确认地址以 http:// 开头 |
| API Error: 403 Request not allowed | 官方列的原因是订阅未生效、Console 角色不对或代理干扰 | 先在 claude.ai 的设置页确认订阅状态，再查代理 |
| OAuth error: Invalid code | 登录代码过期或复制不完整 | 重新登录，尽快完成授权 |
| Login expired · Please run /login | 登录过期 | 运行 /login；频繁出现时检查系统时间是否准确 |
| This organization has been disabled | 环境里残留的 ANTHROPIC_API_KEY 覆盖了订阅登录 | unset ANTHROPIC_API_KEY，并从 shell 配置文件里删掉 |
| 用量上限类提示 | 套餐额度用完 | 等待重置，与网络无关 |
| 证书类错误，例如 unable to get local issuer certificate | 公司网络或安全软件在解密 HTTPS 流量 | 官方企业网络文档有配置自定义证书的方法，以文档为准；不要关闭证书校验 |
| IDE 里连不上，终端里正常 | IDE 从图形界面启动，没继承终端变量 | 把代理写进 settings.json 的 env，或开 TUN |

排查顺序建议固定下来：先用 curl -I https://api.anthropic.com 看终端能不能连上，再用 /status 看代理是否生效，最后才看账号。基础连接问题见 [机场连不上怎么办](https://jichanggege.mom/jiaocheng/lianbushang/) 和 [节点超时](https://jichanggege.mom/paicha/jiedian-chaoshi/)。

## 账号安全注意事项

- **登录凭据就是密码。** 官方说明 macOS 上凭据存在系统钥匙串里，Linux 和 Windows 上存在用户目录下的 .claude/.credentials.json。不要把这个文件发给别人，也不要提交进代码仓库。
- **不要共用订阅。** 把账号登录到多台不同地区的机器上，等于同时触发共享和跨地区两种风控信号。
- **API 密钥不要写进项目。** 用环境变量或官方支持的密钥助手，并留意 .env 文件有没有被纳入版本管理。
- **留意它执行的命令。** Claude Code 会在你的机器上读写文件、运行命令，权限确认提示要看清楚再同意，重要目录先做版本管理。
- **只从官方渠道安装。** 所谓"免登录版""中转版"安装包会经手你的代码和凭据，不要用。

不同国家和地区的规定不同，请遵守当地法律和服务条款。

## Claude Code 使用教程进阶：五个常见工作流

装好之后最常见的用法可以归成五类，每一类说清楚目标和验收方式，它的完成度会明显更高。下表里的提问写法只是示例，换成你项目里的真实情况即可。

| 工作流 | 怎么开口 | 你要检查什么 |
| --- | --- | --- |
| 读懂陌生项目 | 「这个项目的入口在哪，数据从哪里进来、在哪里落库，按目录给我讲一遍」 | 让它列出它读过的文件，回答里提到的函数名去代码里搜一下确认存在 |
| 修 bug | 描述现象、复现步骤和期望结果，再加一句「先找原因，说明后再改」 | 先看它给的原因是否说得通，再同意修改；改完跑一遍原有测试 |
| 加功能 | 先让它出方案和要改的文件清单，确认后再动手 | 方案里有没有改到你不希望动的模块，新加的依赖是否必要 |
| 补测试 | 「给某个模块补单元测试，覆盖正常输入、空值和异常输入」 | 测试是否真的断言了结果，而不是只跑一遍不报错 |
| 整理提交 | 「看一下当前改动，按功能拆成几次提交，写好提交说明」 | 提交前用 git diff 自己过一遍，提交说明和改动是否对得上 |

一个通用习惯：大任务先让它「只出计划不改文件」，计划确认后再执行。会话里切换权限模式的快捷操作和各模式的名称，以当前版本的界面提示和 /help 为准。这样做的好处是，即使中途因为网络断开，你手里也有一份写清楚的计划，重新连上后让它按计划接着做即可。

## Claude Code 权限设置：哪些操作要你确认

Claude Code 默认在读文件之外的操作前征求同意，例如修改文件、运行命令。结论是：新手保持默认确认，熟悉之后再按项目放开少数命令，不要一上来就全部放行。

| 操作类型 | 默认行为 | 建议 |
| --- | --- | --- |
| 读取项目内文件 | 一般直接进行 | 敏感文件不要放在项目目录里 |
| 修改、新建文件 | 需要确认，可选择本次会话内同类操作都允许 | 在 git 仓库里用，随时能回退 |
| 运行命令 | 需要确认 | 测试、构建这类固定命令可以加进允许列表；删除、安装、推送类命令每次都看清楚 |
| 访问网络 | 视具体工具而定 | 留意它要访问的地址是不是你认识的 |

允许列表可以写在项目或用户级的配置文件里，写法和字段名以官方设置文档为准。团队项目里，把项目级配置提交进仓库，大家的放行范围就一致了；个人偏好放在用户级配置，不要提交。

## 用 API 密钥或第三方中转接入 Claude Code 要注意什么

结论：官方支持用 Console 账号的 API 密钥按量计费，网上流行的「中转站」不是官方渠道，代码和密钥都要经过对方服务器，使用前要想清楚。

**官方 API 密钥。** 在 Console 创建密钥后，可以通过 ANTHROPIC_API_KEY 环境变量提供给 Claude Code。注意上文报错表里提到的情况：环境变量里留着 API 密钥时，会覆盖订阅登录，按量扣费。用订阅的人不要随手把密钥写进 shell 配置文件。

**第三方中转。** 中转站的做法一般是让你把 ANTHROPIC_BASE_URL 改成它的地址，再填它发的密钥，这样终端里不走代理也能用。代价有三条：项目代码和对话内容会经过一个你不了解的服务器；对方实际调用的是什么模型，你无法核实；服务停掉或密钥被盗刷，没有官方渠道可以申诉。本站不推荐，也不列举任何中转服务。

**常见状态码怎么理解。** 无论官方还是中转，接口报错大多按 HTTP 状态码分类：

| 状态码 | 一般含义 | 先查什么 |
| --- | --- | --- |
| 401 | 认证失败 | 密钥是否复制完整、是否已被删除，环境变量是否被别的值覆盖 |
| 403 | 没有权限或请求被拒 | 订阅或 Console 角色是否生效，出口地区是否在支持名单 |
| 404 | 地址或模型不存在 | ANTHROPIC_BASE_URL 是否写错，模型名称是否拼错 |
| 429 | 请求过于频繁或额度用尽 | 等一段时间，查看用量页面；与节点无关的情况居多 |
| 5xx | 服务端临时故障或过载 | 稍后重试，官方状态页可以看到是否有故障 |

**密钥和代码的保管。** 密钥只放在环境变量或官方支持的密钥管理方式里，.env 一类文件要写进 .gitignore；给 Claude Code 的项目说明文件里不要写密钥、内网地址和客户数据，因为它每次会话都会被读进上下文。

## 常见问题

### Claude Code 怎么安装？

macOS、Linux、WSL 运行 curl -fsSL https://claude.ai/install.sh | bash，Windows PowerShell 运行 irm https://claude.ai/install.ps1 | iex。也可以用 Homebrew、WinGet 或 npm，命令以官方安装文档为准。

### Claude Code 免费吗，多少钱？

官方说明免费的 claude.ai 套餐不包含 Claude Code，需要 Pro、Max、Team、Enterprise 等付费套餐，或者按量计费的 Console 账号。各套餐的价格和用量额度会调整，以官方定价页的当前说明为准。

### 浏览器能打开 Claude，终端里 Claude Code 却连不上，为什么？

浏览器读取系统代理，命令行程序不读。在启动 claude 之前设置 HTTPS_PROXY，或者打开代理客户端的 TUN 模式。

### Claude Code 支持 SOCKS5 代理吗？

官方文档明确写了不支持 SOCKS 代理。代理地址要用 http:// 开头的 HTTP 代理，Clash 系客户端的混合端口可以直接使用。

### Claude Code 提示 App unavailable in region 怎么办？

出口 IP 所在地区不在 Anthropic 的支持名单里。确认终端已经走代理，并把节点换到支持地区。详细步骤见 [Claude 提示地区不支持怎么办](https://jichanggege.mom/paicha/claude-diqu-buzhichi/)。

### Claude Code 跑到一半断了，之前的工作会丢吗？

已经写入磁盘的文件修改不会丢。已完成的输出会保留，再发一条消息让它继续，或者用 claude --continue 回到最近的会话。减少断连的根本办法是固定一个稳定的节点。

### 用 Claude Code 费流量吗？

不费。它传输的主要是文本，日常使用每月几个 GB 以内。选机场时把预算放在线路和 IP 质量上，候选名单见 [AI 用机场怎么选](https://jichanggege.mom/tuijian/ai/)。

### WSL 里的 Claude Code 怎么用 Windows 上的代理？

WSL 里的 127.0.0.1 指向 WSL 自己，填它连不到 Windows 上的代理客户端。最省事的是在 Windows 侧打开 TUN；也可以让客户端允许局域网连接，再把代理地址换成 Windows 主机在 WSL 里看到的地址。思路见 [局域网共享代理](https://jichanggege.mom/jiaocheng/juyuwang-gongxiang/)。

### 没有 Claude 账号，能用 Claude Code 吗？

官方渠道需要 Claude 的付费套餐或 Console 账号，二选一。没有任何账号的用法只剩第三方中转，代码和密钥要经过对方服务器，本站不推荐，原因见上文「API 密钥或第三方中转」一节。

### 安装 Claude Code 前要先装 Node.js 吗？

用官方原生安装脚本、Homebrew 或 WinGet 安装时不需要。只有走 npm 渠道时才需要 Node.js，版本要求以官方安装文档为准。以前用 npm 装过的，可以按官方文档迁移到原生安装，避免两份程序同时存在。

### 装完提示找不到 claude 命令，怎么办？

先新开一个终端窗口再试，安装脚本修改的 PATH 只对新窗口生效。仍然找不到，运行安装脚本时留意它输出的安装位置，把这个目录加进 PATH；官方排错页有各系统的具体步骤。

## 接着读

Codex

### OpenAI Codex CLI 使用教程（2026）：国内安装、登录与代理设置

OpenAI Codex CLI 使用教程：Codex 怎么用、国内怎么安装、登录失败怎么办、代理怎么设置。给出安装脚本、npm、Homebrew 三种官方命令，讲 ChatGPT 账号与 API 密钥登录、1455 回调端口、终端代理、常用命令、和 Claude Code 的区别与连接失败排查。

阅读 → Gemini

### Gemini 使用教程（2026）：国内怎么用、AI Studio 与地区限制

Gemini 使用教程：Gemini 怎么用、国内怎么用、Google AI Studio 怎么用、提示地区不支持怎么办。Gemini 应用和 AI Studio 是两份不同的官方地区名单，判断依据除了出口 IP 还有账号地区。本文讲官方入口、API 密钥申请、节点验证与报错处理。

阅读 → Cursor

### Cursor 使用教程（2026）：国内下载安装、代理设置与模型不可用

Cursor 使用教程：Cursor 怎么用、国内怎么下载安装、代理怎么设置、模型不可用怎么办、怎么设置中文。只从官网 cursor.com/download 下载，讲系统代理与 TUN、Network 页的 HTTP 兼容模式与诊断、节点地区验证，以及模型列表缺模型的原因。

阅读 →
