这篇Claude使用教程只讲Claude Code:从安装到首次运行、API Key 绑定、账号切换,再到订阅与常见报错排查,按步骤做就能在本地终端把Claude Code跑起来。文中命令适用于 Windows/macOS/Linux,尽量把坑点写在前面,少走弯路。
1)安装Claude Code:环境准备与首次运行
Claude Code依赖Node.js,建议先安装Node.js 18及以上版本,并确认终端能用npm。随后执行全局安装:
npm install -g @anthropic-ai/claude-code
安装后用
claude --version
检查是否输出版本号。
第一次运行Claude Code时,通常会提示配置Anthropic API Key。你也可以提前在系统里设置环境变量ANTHROPIC_API_KEY,再启动Claude Code,省去重复输入。
2)账号绑定与切换:用API Key管理最省事
Claude Code的“登录”核心是API Key绑定:一把Key对应一个计费与权限来源。想切换账号,最稳妥的方法是更换ANTHROPIC_API_KEY(或在Claude Code首次运行生成的配置文件里替换Key,具体路径会在初始化时提示)。
如果你在公司与个人账号之间切换,建议为不同终端会话分别设置环境变量,避免把Key写死在全局配置里,减少误用与泄露风险。
3)套餐区别与省钱思路:按使用场景选
Claude相关的订阅常见有Pro与Max(价格与权益会随官方调整),更适合网页端高频对话;而Claude Code更常见的成本来自API调用量。对开发者来说,把大任务集中在一两天做完、其余时间只做小改动,通常比“长期高频开着”更省。
国内用户如果遇到支付或网络限制,优先选择合规的API付费渠道或企业/团队统一结算方式;不建议使用来路不明的Key,容易触发风控导致Claude Code用到一半被中断。
4)常见问题与错误排查:订阅失败、请求错误、账号锁定
订阅失败多发生在支付方式、地区或账单信息不匹配,先检查卡的3DS验证、账单地址与币种支持;若只用Claude Code,确认自己是否实际上需要订阅,还是只需要可用的API Key与额度。
请求错误(如超时/中断)通常是网络不稳定、并发过高或上下文过长。处理顺序建议:换更稳定的网络→降低一次性输入与改动范围→分步骤让Claude Code执行(先分析再修改再测试)。
账号锁定或Key失效时,先在控制台检查Key是否被撤销、额度是否用尽,以及是否触发异常调用。更换新的API Key后重启Claude Code通常能恢复;如果持续报错,再检查本地代理/证书拦截与系统时间是否正确。