前言

最近想尝试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. 创建令牌

名称随便写,没有含义,直接点击提交即可。

在这里插入图片描述

  1. 获取 API KEY

获得 API Key 后请妥善保管,API Key 是你的身份凭证,等同于账号密码,切勿公开或分享给他人。
在这里插入图片描述

  1. 点击“知道了”,可以看到我们刚才创建的,在这里也同样可以点击 复制 按钮去获取 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中转可避免翻墙和海外账号,简化配置流程。如果遇到问题,先检查配置是否正确,或参考常见问题部分。希望这篇教程能帮到你,有疑问欢迎留言交流。

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐