前言
Claude Code 是目前终端端最强的 AI 编程助手之一，可以直接在命令行中和 AI 实时协作编程、读代码、改项目、排查 BUG，极大提升开发效率。
但官方原版配置对国内开发者很不友好，网络、API 鉴权、接口地址都是大难题。今天给大家整理一套全平台通用、零折腾的完整安装配置教程，Windows、Mac、Linux 都能用，照着步骤一步步来即可直接上手。
一、系统前置要求
在安装前先核对环境，避免后续报错：
- Node.js 版本≥ 18.0，推荐 LTS 版
- 支持系统：macOS、Linux、Windows（WSL 环境）
- 无需复杂代理，国内普通网络即可正常使用
二、第一步：安装 Node.js 环境
1. Ubuntu / Debian 系统
# 安装 Node.js LTS 版本curl-fsSLhttps://deb.nodesource.com/setup_lts.x|sudobash-sudoapt-getinstall-ynodejs# 验证版本node--version2. macOS 系统
# 安装命令行工具sudoxcode-select--install# 安装 Homebrew（无则执行）/bin/bash-c"$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"# 安装 Node.jsbrewinstallnode# 验证node--version3. Windows 用户
直接去 Node.js 官网下载 LTS 版本安装包，安装时勾选Add to PATH，一路下一步即可，安装完成 cmd 输入node --version验证。
三、第二步：全局安装 Claude Code
Node 环境准备好后，直接 npm 全局安装：
npminstall-g@anthropic-ai/claude-code# 验证是否安装成功claude--version输出版本号即代表安装完成。
四、第三步：关键配置（国内可用接口）
这一步是国内能用的核心，不用官方原版复杂翻墙和订阅，只需配置两个关键参数即可正常调用。
1. 配置参数说明
| 配置项 | 作用 | 备注 |
|---|---|---|
ANTHROPIC_AUTH_TOKEN | API 认证令牌 | 以sk-开头的密钥 |
ANTHROPIC_BASE_URL | 接口转发地址 | 国内专用稳定地址 |
API_TIMEOUT_MS | 接口超时时间 | 建议设 300000 毫秒 |
很多新手卡在没有合规可用的转发接口和密钥，这里可以试试的薛定猫 AI 平台，xuedingmao.com专门做 Claude 系列接口转发，适配 Claude Code 原生协议，不用自己折腾搭建代理，注册后就能直接生成专属
sk-开头令牌，分组选择克劳德 3 及以上模型即可，额度可自定义，对开发者非常友好。
2. 不同系统设置环境变量
Linux / Mac 终端
# 进入项目目录cd你的项目文件夹# 配置环境变量exportANTHROPIC_AUTH_TOKEN=sk-xxxxxxxexportANTHROPIC_BASE_URL=https://xuedingmao.comexportAPI_TIMEOUT_MS=300000# 启动 Claude CodeclaudeWindows PowerShell
$env:ANTHROPIC_BASE_URL ="https://xuedingmao.com"$env:ANTHROPIC_AUTH_TOKEN ="sk-xxxxxxx"$env:API_TIMEOUT_MS ="300000"claudeWindows CMD
set ANTHROPIC_BASE_URL=https://xuedingmao.com set ANTHROPIC_AUTH_TOKEN=sk-xxxxxxx set API_TIMEOUT_MS=300000 claude五、第四步：初次启动初始化配置
首次运行claude命令后，按提示简单配置即可：
- 选择喜欢的终端主题，回车确认
- 阅读安全须知，继续下一步
- Terminal 配置保持默认即可
- 信任当前工作目录，完成初始化
到此就可以正式在终端和 AI 协作写代码、改项目、分析源码了。
六、常见问题汇总及解决方案
1. 提示Invalid API Key · Please run /login
大概率是环境变量没生效、令牌填写错误，或者接口地址不对。检查是否正确配置ANTHROPIC_BASE_URL和sk-密钥，修改后重启终端重新执行配置命令即可。
2. 显示 offline 离线状态
Claude Code 默认会检测谷歌网络，国内环境基本都会显示 offline，不影响正常对话和编码使用，直接忽略即可。
3. 网页 Fetch 抓取失败、fetch failed
原生官方接口网络不稳定容易超时，改用适配好的国内转发节点就能大幅降低此类问题，接口协议完全兼容原生 Claude Code，无需修改代码，直接替换地址就能稳跑。
4. 接口频繁报错中断
先Ctrl+C退出程序，重新执行claude启动；如果持续异常，检查密钥权限和模型分组配置，更换令牌即可解决。
七、使用注意事项
- 选用适配 Claude Code 专属转发服务，只支持该工具 API 流量，不混用其他接口调用
- 妥善保管
sk-开头令牌，不要随意泄露，避免被他人盗用额度 - 超时建议固定设置 300 秒，适配国内网络延迟，减少中断概率
总结
Claude Code 作为终端编程利器，原生环境对国内开发者门槛很高，最大难点就是接口鉴权 + 网络转发。
这套教程从环境安装、工具部署到国内适配配置全部覆盖，借助成熟的 AI 接口平台省去自己搭建代理、配置协议的麻烦，新手也能五分钟快速部署上手，日常开发读源码、调试 BUG、写业务逻辑都能大幅提效。
