11号登机口GATE 11 · 机场推荐与选购笔记
AI 工具 · Claude Code

Claude Code 使用教程(2026):国内安装、登录、代理设置与常用命令

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

更新于 约 6860 字 · 15 分钟读完11号登机口编辑
快速结论

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

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

在国内用 Claude Code,比用网页版 Claude 多两个环节:终端要单独走代理,登录时浏览器和终端要走同一个出口。账号层面的门槛和网页版一样,注册要过支持地区的手机号验证,见 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)的代理写法见 终端走代理教程。

安装前先确认三件事

系统。 官方文档列出的支持范围是 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,首次启动会打开浏览器让你登录并授权,完成后终端显示登录成功。几个实用细节,都来自官方文档:

  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 模式,开不了见 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 很容易忘。有三种持久化办法,选一种:

  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 使用教程 里桌面应用的网络设置处理,连不上就开 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 风控。

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

  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 使用教程 和 Codex CLI 使用教程。套餐和功能变化较快,以各家官方说明为准。

长任务断连怎么处理

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

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

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

你这边能做的:

  1. 固定节点。 这是最有效的一条。自动测速组每隔几分钟重新选节点,对长连接是灾难。
  2. 避开晚高峰不稳定的节点。 判断方法见 延迟、丢包与速度。
  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 看代理是否生效,最后才看账号。基础连接问题见 机场连不上怎么办 和 节点超时。

账号安全注意事项

  • 登录凭据就是密码。 官方说明 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;官方排错页有各系统的具体步骤。