在日常的 AI 开发中,Claude Code 是一个提升研发效能的超级神器。但在实际部署时,我们经常会遇到两个痛点:

1. 公司或实验室的远程服务器没有 Root 权限;

2. 存在区域网络限制,必须走中转 API。

今天这篇保姆级教程,就手把手教你如何在纯普通用户(无 Root 权限)的情况下,通过 SSH 丝滑配置 Claude Code,并无缝接入中转 API!

📌 前置准备

  • 可以通过 SSH 正常连接的远程 Linux 服务器

  • 已获取的中转 Base URL 以及对应的 API Key

🌟 第一步:免 Root 安装 Node.js (基于 nvm)

既然没有 root 权限,我们就不能用 sudo aptyum。最优雅的方案是使用 nvm (Node Version Manager) 安装 Node.js,所有环境均隔离在用户自己的目录下。

直接在终端依次执行以下命令:

# 1. 下载并运行 nvm 安装脚本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# 2. 重新加载 shell 配置使其生效(或直接重新连接 SSH)
\. "$HOME/.nvm/nvm.sh"

# 3. 下载并安装 Node.js 24 版本
nvm install 24

# 4. 验证是否安装成功
node -v   # 正常应输出类似 "v24.15.0"
npm -v    # 正常应输出类似 "11.12.1"

🌟 第二步:全局安装 Claude Code CLI

有了 npm 环境后,直接一键安装 Anthropic 官方的 Claude CLI 工具:

npm install -g @anthropic-ai/claude-code

🌟 第三步:一秒绕过区域登录限制

由于部分网络环境原因,直接启动可能会卡在 Onboarding(引导登录)流程。我们可以通过直接注入配置文件,跳过这一步验证。

在命令行输入以下命令,一键写入配置:

cat > ~/.claude.json <<EOF
{
  "hasCompletedOnboarding": true
}
EOF

此时,你在终端输入 claude 已经可以唤出界面,但还没有配置我们自己的大模型中转密钥,先按 Ctrl+C 退出,继续下一步。

🌟 第四步:注入中转 API 与模型配置(核心!)

这是最关键的一步。我个人在日常写代码和做架构时,重度依赖逻辑能力最强的 Claude Opus 4.8,因此在下面的配置中,我将默认模型和工作模式都指向了 Opus。你可以根据自己的实际需求修改模型名称。

在终端直接复制粘贴执行以下命令(注意替换中文提示部分):

mkdir -p ~/.claude
cat > ~/.claude/settings.json <<'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "这里替换成中转商家给出的 Base URL",
    "ANTHROPIC_AUTH_TOKEN": "这里替换成你的 API Key",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-3-5-haiku-20241022",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-3-5-sonnet-20241022",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8"
  },
  "model": "opus",
  "theme": "dark",
  "hasCompletedOnboarding": true
}
EOF

💡 配置说明:

  • ANTHROPIC_BASE_URL:填写中转商提供的接口地址(注意是否需要带 /v1 后缀,依中转商说明为准)。

  • ANTHROPIC_AUTH_TOKEN:填写你的专属令牌。

  • theme:默认开启深色模式。

🎉 第五步:起飞!终端/插件验证使用

全部配置完成后,在终端直接输入:

claude

此时打开侧边插件栏,发现也可以正常使用了。

📢 结语

参考本文配置,不仅解决了权限痛点,还完美规避了繁琐的登录流程。如果你在部署过程中遇到任何环境依赖问题,欢迎在评论区留言讨论!

参考资料致谢:CSDN - 连接到远程服务器配置Claude使用中转

Logo

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目,面向数字基础设施四大核心场景(服务器、云计算、边缘计算、嵌入式),全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐