Claude Code 使用教程(2026):国内安装、登录、代理设置与常用命令
Claude Code 使用教程:国内怎么安装和登录、代理怎么设置、日常怎么用。给出官方安装命令(脚本、Homebrew、WinGet、npm),讲 HTTPS_PROXY 与 TUN 两种代理设置、常用命令、节点验证、和 Cursor、Codex 的区别,以及地区不可用与长任务断连的处理。
这篇 Claude Code 使用教程先给结论:Claude Code 用官方安装脚本一条命令就能装好,账号需要 Pro、Max 等付费套餐或 Console 账号,免费套餐不包含。它是命令行程序,不读系统代理:要么在启动前设置 HTTPS_PROXY 环境变量,要么打开代理客户端的 TUN 模式。官方文档写明不支持 SOCKS 代理,所以环境变量里要填 http:// 开头的地址。长任务最怕出口 IP 中途变化,给它固定一个支持地区的节点。本文的命令都来自官方文档,动手前建议对照官方页面核对一次。
Claude Code 国内怎么用:准备什么、按什么顺序
在国内用 Claude Code,比用网页版 Claude 多两个环节:终端要单独走代理,登录时浏览器和终端要走同一个出口。账号层面的门槛和网页版一样,注册要过支持地区的手机号验证,见 Claude 使用教程。整体顺序如下:
- 先有一个能用 Claude Code 的账号。 付费套餐或 Console 账号,免费套餐不行。
- 代理客户端选好节点。 支持地区、手动固定,记下客户端的本地 HTTP 端口(Clash 系一般叫混合端口)。
- 让终端走代理。 设置
HTTPS_PROXY环境变量,或打开 TUN 模式,做法见下文「代理设置」一节。 - 在终端里确认出口。 用 curl 查一次出口 IP,地区要在支持名单内,并且和浏览器一致。
- 运行官方安装命令。 安装脚本也要访问境外服务器,所以这一步必须在第 3 步之后。
- 运行
claude登录。 浏览器授权,回到终端确认登录成功。 - 先跑一个小任务,再跑长任务。 确认节点在长连接下也稳定。
很多人在第 5 步就卡住,原因几乎都是终端没走代理:浏览器开着代理能上 Claude,不代表终端也能。记住这条,后面的问题会少一大半。其他命令行工具(git、npm、pip)的代理写法见 终端走代理教程。
安装前先确认三件事
系统。 官方文档列出的支持范围是 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 使用教程。
地区。 系统要求里有一条是所在地要在 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
| 方式 | 自动更新 | 适合谁 |
|---|---|---|
| 原生安装脚本 | 会,后台自动更新 | 大多数人 |
| 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 走代理。
Claude Code 怎么登录:浏览器授权与无界面环境
在项目目录里运行 claude,首次启动会打开浏览器让你登录并授权,完成后终端显示登录成功。几个实用细节,都来自官方文档:
- 浏览器没有自动打开时,按
c复制登录链接,手动粘贴到浏览器。 - 浏览器登录后显示的是一串代码而不是自动跳回,就把代码粘贴到终端的提示处。
- 在 SSH、WSL、容器里登录,浏览器可能开在另一台机器上,同样用复制链接、粘贴代码的方式完成。也可以运行
claude auth login。 - 重新登录用
/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 模式,开不了见 TUN 模式开不了。
| 对比 | 环境变量 | TUN 模式 |
|---|---|---|
| 生效范围 | 只有设置了变量的终端和它启动的程序 | 整台电脑 |
| 权限 | 不需要 | 需要管理员权限或安装服务 |
| 子进程 | 多数会继承,个别工具有自己的代理配置 | 全部覆盖 |
| 适合 | 只在终端里用 Claude Code | 还要用桌面应用、IDE 插件,或者不想逐个配置 |
WSL 里的情况多一层:WSL 是一台虚拟机,127.0.0.1 指向的是它自己而不是 Windows。这时要么在 Windows 侧开 TUN,要么让客户端允许局域网连接,并把代理地址换成 Windows 主机的地址,思路见 局域网共享代理。Linux 服务器上直接跑内核的做法见 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 很容易忘。有三种持久化办法,选一种:
- 写进
~/.claude/settings.json的env字段。只影响 Claude Code,代理客户端关掉时其他程序不受连累,最推荐。 - 写进 shell 的配置文件,例如
~/.zshrc或~/.bashrc。这样 git、npm 等也一起走代理,但代理客户端一旦退出,这些命令全部连不上。 - 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 使用教程 里桌面应用的网络设置处理,连不上就开 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 工具的网络环境怎么配 和 机房 IP 与 AI 风控。
在终端里验证一个节点。 浏览器里的检查不能代替终端,因为两者可能走的是不同出口。按下面的顺序在终端里确认:
- 用 curl 访问任意一个查询出口 IP 的服务,确认终端的落地地区在支持名单内,并且和浏览器查到的一致。
- 运行
curl -I https://api.anthropic.com,能返回响应头就说明终端到 API 是通的,状态码本身不重要。 - 启动
claude,运行/status,确认代理地址被读到了。 - 先让它做一件小事,例如总结项目里的说明文件;再交给它一个需要几分钟的任务,观察中途有没有断连提示。
- 在晚高峰重复第 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 使用教程 和 Codex CLI 使用教程。套餐和功能变化较快,以各家官方说明为准。
长任务断连怎么处理
Claude Code 的一个任务可能连续跑十几分钟,中间是一条条流式长连接。节点抖动、策略组自动切换、电脑休眠,都会让连接中断。
先了解它自身的容错,下面的行为来自官方的错误说明页:
- 遇到临时性错误会自动重试,默认最多十次,间隔逐步拉长。
- 响应还没开始就断开,它会重新发起请求,这一轮对话继续。
- 响应进行到一半、已经完成了部分输出或工具调用之后才断开,它不会重跑这次请求,因为那可能让工具调用被执行两遍。它会保留已完成的部分,并提示
API Error: Connection lost mid-response. The response above may be incomplete.,这时再发一条消息让它接着做即可。 - 连接长时间没有任何数据,内置的看门狗会判定连接已死并中止,避免一直挂着。
你这边能做的:
- 固定节点。 这是最有效的一条。自动测速组每隔几分钟重新选节点,对长连接是灾难。
- 避开晚高峰不稳定的节点。 判断方法见 延迟、丢包与速度。
- 别让电脑休眠。 合盖或休眠后网络断开,会话里的请求必然失败。
- 会话可以接着用。 终端关掉或进程退出后,在同一个项目目录运行
claude --continue继续最近一次会话,或用claude --resume从列表里选择。 - 代理响应慢时调整超时。 官方说明
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 看代理是否生效,最后才看账号。基础连接问题见 机场连不上怎么办 和 节点超时。
账号安全注意事项
- 登录凭据就是密码。 官方说明 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 提示地区不支持怎么办。
Claude Code 跑到一半断了,之前的工作会丢吗?
已经写入磁盘的文件修改不会丢。已完成的输出会保留,再发一条消息让它继续,或者用 claude --continue 回到最近的会话。减少断连的根本办法是固定一个稳定的节点。
用 Claude Code 费流量吗?
不费。它传输的主要是文本,日常使用每月几个 GB 以内。选机场时把预算放在线路和 IP 质量上,候选名单见 AI 用机场怎么选。
WSL 里的 Claude Code 怎么用 Windows 上的代理?
WSL 里的 127.0.0.1 指向 WSL 自己,填它连不到 Windows 上的代理客户端。最省事的是在 Windows 侧打开 TUN;也可以让客户端允许局域网连接,再把代理地址换成 Windows 主机在 WSL 里看到的地址。思路见 局域网共享代理。
没有 Claude 账号,能用 Claude Code 吗?
官方渠道需要 Claude 的付费套餐或 Console 账号,二选一。没有任何账号的用法只剩第三方中转,代码和密钥要经过对方服务器,本站不推荐,原因见上文「API 密钥或第三方中转」一节。
安装 Claude Code 前要先装 Node.js 吗?
用官方原生安装脚本、Homebrew 或 WinGet 安装时不需要。只有走 npm 渠道时才需要 Node.js,版本要求以官方安装文档为准。以前用 npm 装过的,可以按官方文档迁移到原生安装,避免两份程序同时存在。
装完提示找不到 claude 命令,怎么办?
先新开一个终端窗口再试,安装脚本修改的 PATH 只对新窗口生效。仍然找不到,运行安装脚本时留意它输出的安装位置,把这个目录加进 PATH;官方排错页有各系统的具体步骤。