一、安装依赖

1.安装依赖(curl 需要,git 建议也装)

从Windows系统的终端进入Ubuntu系统用户终端:

输入指令:sudo apt update

sudo apt update

安装curl

sudo apt install -y curl ca-certificates git

验证 curl 可用:

curl --version

2.下载并安装 nvm

2.1参考安装步骤

接入Claude Code

2.2查看安装前提条件

我的Ubuntu系统为v20,其它选项请参考如下:

https://nodejs.org/en/download/

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 20

# Verify the Node.js version:
node -v # Should print "v20.19.6".

# Verify npm version:
npm -v # Should print "10.8.2".

2.3配置依赖环境

根据上图生成的命令来配置环境。

2.3.1下载并安装 nvm

# Download and install nvm:

这一步会在你的家目录创建 ~/.nvm/,并向你的 shell 配置文件(通常是 ~/.bashrc)写入初始化代码。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

但是,如果没有科学上网,将会克隆失败,解决方法如下(若成功则忽略下面的,直接看2.3.2):

(1)先清理半拉子目录

rm -rf ~/.nvm

(2)用 gitee 镜像克隆(通常最稳)

git clone https://gitee.com/mirrors/nvm.git ~/.nvm

2.3.2 不重启 shell,立刻加载 nvm

# in lieu of restarting the shell

\. "$HOME/.nvm/nvm.sh"

2.3.3验证 nvm 是否加载成功

# Verify the Node.js version:

command -v nvm

command -v nvm 输出 nvm 或路径,说明 OK。

查看nvm版本

nvm --version

2.3.4安装 Node.js 20

nvm install 20

2.3.5验证Node / npm 版本

(1)# Verify the Node.js version:

node -v

# Should print "v20.19.6".

(2)# Verify npm version:

npm -v

# Should print "10.8.2".

二、安装 Claude Code

进入命令行界面,安装 Claude Code

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

运行如下命令,查看安装结果,若显示版本号则表示安装成功

claude --version

三、配置 GLM Coding Plan

3.1注册账号

访问 智谱开放平台,点击右上角的「注册/登录」按钮,按照提示完成账号注册流程。

3.2获取API Key

登录后,在个人中心页面,点击 API Keys,创建一个新的 API Key。

3.3配置环境变量

通过在Linux 中使用自动化脚本设置环境变量:

在终端或 IDE 中运行以下命令即可

curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

脚本会自动通过修改 ~/.claude/settings.json 来配置如下环境变量(您无需手动修改)。

然后输入key:

配置成功后,一定确保重新打开一个新的终端窗口,以便环境配置生效。

假如在登录时提示是否使用API_key....,一定选2否,否则会引起冲突。

打开新终端并输入claude:

五、重新打开终端无法找到claude问题

重新打开终端,并输入claude,显示未找到命令:

原因如下:
在2.3.1部分,没有科学上网导致克隆失败,使用git安装时Claude Code 是装在 nvm 的 Node 环境里(~/.nvm/versions/.../bin),而新终端没有自动 nvm use(甚至没加载 nvm),所以 PATH 里没有 claude

永久修复解决方法:

打开 ~/.bashrc

nano ~/.bashrc

在文件末尾追加下面这段(直接复制粘贴,最稳):

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

# 自动切到你需要的 Node 版本(推荐写死 20,最确定)
nvm use --silent 20 >/dev/null 2>&1

具体步骤如下:

  • 把光标移到文件末尾(快捷键):Alt + / 直接跳到文件末尾(部分终端是 Esc 然后按 /
  • 粘贴你那段内容(右键粘贴或 Ctrl+Shift+V,取决于你的终端)

  • 保存(Write Out):按 Ctrl + O

  • 下面会提示文件名 File Name to Write: /home/zwj/.bashrc

  • 直接按 Enter 确认

  • 退出 nano:按 Ctrl + X

保存退出后,让它立刻生效:

验证:

claude --version

六、Auth conflict错误

同时设置了两套凭据——ANTHROPIC_AUTH_TOKEN(登录 token)和 ANTHROPIC_API_KEY(API key)。Claude Code 不知道该用哪一个,所以提示 Auth conflict,并且可能导致 401、反复登录等“玄学”。

⚠Auth conflict: Both a token (ANTHROPIC_AUTH_TOKEN) and an API key (ANTHROPIC_API_KEY) are set. This may lead to unexpected behavior. • Trying to use ANTHROPIC_AUTH_TOKEN? Unset the ANTHROPIC_API_KEY environment variable, or claude /logout then say "No" to the API key approval before login. • Trying to use ANTHROPIC_API_KEY? Unset the ANTHROPIC_AUTH_TOKEN environment variable. /model to try Opus 4.5

本人亲测以下两种方法都要使用。

6.1退出 Claude Code

在 Claude Code 里输入:或者ctrl+c两次

/exit

6.2清理 Claude Code 的本地认证/状态

zwj 执行:

这一步的目的:把 Claude Code 可能保存的旧 token/会话信息清掉,让它只能看到 API key。

mkdir -p ~/backup_claude_state
cp -a ~/.config/claude* ~/backup_claude_state/ 2>/dev/null || true
cp -a ~/.cache/claude*  ~/backup_claude_state/ 2>/dev/null || true
cp -a ~/.claude*        ~/backup_claude_state/ 2>/dev/null || true

rm -rf ~/.config/claude* ~/.cache/claude* ~/.claude* 2>/dev/null || true

6.3重新启动 Claude Code

claude

此时环境变量已经被清空,显示无授权状态:

Welcome to Claude Code v2.0.76
…………………………………………………………………………………………………………………………………………………………

     *                                       █████▓▓░
                                 *         ███▓░     ░░
            ░░░░░░                        ███▓░
    ░░░   ░░░░░░░░░░                      ███▓░
   ░░░░░░░░░░░░░░░░░░░    *                ██▓░░      ▓
                                             ░▓▓███▓▓░
 *                                 ░░░░
                                 ░░░░░░░░
                               ░░░░░░░░░░░░░░░░
       █████████                                        *
      ██▄█████▄██                        *
       █████████      *
…………………█ █   █ █………………………………………………………………………………………………………………

Welcome to Claude Code v2.0.76
…………………………………………………………………………………………………………………………………………………………

     *                                       █████▓▓░
                                 *         ███▓░     ░░
            ░░░░░░                        ███▓░
    ░░░   ░░░░░░░░░░                      ███▓░
   ░░░░░░░░░░░░░░░░░░░    *                ██▓░░      ▓
                                             ░▓▓███▓▓░
 *                                 ░░░░
                                 ░░░░░░░░
                               ░░░░░░░░░░░░░░░░
       █████████                                        *
      ██▄█████▄██                        *
       █████████      *
…………………█ █   █ █………………………………………………………………………………………………………………

 Unable to connect to Anthropic services

 Failed to connect to api.anthropic.com: ERR_BAD_REQUEST

 Please check your internet connection and network settings.

 Note: Claude Code might not be available in your country. Check supported countries at
 https://anthropic.com/supported-countries

6.4重新配置环境变量

在终端或 IDE 中运行以下命令即可

curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

脚本会自动通过修改 ~/.claude/settings.json 来配置如下环境变量(您无需手动修改)。

然后去新建一个新的key

再输入key:

配置成功后,一定确保重新打开一个新的终端窗口,以便环境配置生效。

假如在登录时提示是否使用API_key....,一定选2否,否则会引起冲突。

选完2后就没有冲突了:

七、在VSCode中通过SSH远程使用Claude code

SSH远程连接服务器并打开项目

Logo

魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。

更多推荐