Claude Code安装+ API 配置完整教程:国内直连无需海外账号,亲测跑通(Linux/WSL2)
前言
最近想尝试Claude Code,但国内直接使用海外API总是遇到网络或账号问题?要么翻墙麻烦,要么注册海外账号费时间。
这篇教程用88api中转,帮你省掉这些步骤,直接在Linux/WSL2环境下完成Claude Code的安装和配置,亲测能跑通,跟着做就行。
正文
1. 安装Node.js
最低要求:Node.js >=18(建议LTS版本)
方法一:官网下载
访问Node.js官网下载LTS版本的Linux二进制包,或使用nvm安装。
方法二:包管理器安装(Ubuntu/Debian)
sudo apt update
sudo apt install -y nodejs npm
验证安装
出现版本号即安装成功:
node --version
# 输出示例:v20.11.0
npm --version
# 输出示例:10.2.4
2. 安装Claude Code
npm install -g @anthropic-ai/claude-code
验证安装
claude --version
3. 配置API连接
获取API KEY
我最近用的是88api中转(https://api.88api.shop),步骤如下:
1.注册登录后,点击 “API 令牌”
2.点击添加令牌
3. 创建令牌
名称随便写,没有含义,直接点击提交即可。

- 获取 API KEY
获得 API Key 后请妥善保管,API Key 是你的身份凭证,等同于账号密码,切勿公开或分享给他人。
- 点击“知道了”,可以看到我们刚才创建的,在这里也同样可以点击 复制 按钮去获取 API Key。

方法一:配置文件(推荐)
在用户目录创建.claude文件夹和settings.json:
路径:~/.claude/settings.json
内容:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "你的API密钥",
"ANTHROPIC_BASE_URL": "https://api.88api.shop"
}
}
创建步骤:
# 创建目录(如已存在则跳过)
mkdir -p ~/.claude
# 编辑配置文件
nano ~/.claude/settings.json
粘贴内容后,按Ctrl+O保存,Ctrl+X退出。
方法二:环境变量
临时设置(当前终端):
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
永久设置:
写入~/.bashrc或~/.zshrc:
export ANTHROPIC_BASE_URL="https://api.88api.shop"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
保存后执行:
source ~/.bashrc
⚠️ 注意:替换“你的API密钥”为实际值;配置后需重启终端或IDE生效。
VSCode插件配置(可选)
创建~/.claude/config.json:
内容:
{
"primaryApiKey": "any"
}
步骤:
mkdir -p ~/.claude
nano ~/.claude/config.json
保存退出即可。
⚠️ 注意:这是VSCode插件专用配置,与命令行工具的
settings.json不同。
4. 开始使用
claude
运行claude --help查看命令说明。
5. 常见问题排查
问题1:Unable to connect to Anthropic services
症状:启动后提示无法连接服务。
解决方案:创建~/.claude.json跳过引导:
cat > ~/.claude.json << 'EOF'
{
"hasCompletedOnboarding": true
}
EOF
验证文件:cat ~/.claude.json,重启Claude Code即可。
总结
这篇教程覆盖了Claude Code在Linux/WSL2环境下的安装、88api中转配置及常见问题解决。用88api中转可避免翻墙和海外账号,简化配置流程。如果遇到问题,先检查配置是否正确,或参考常见问题部分。希望这篇教程能帮到你,有疑问欢迎留言交流。
更多推荐


所有评论(0)