1、科学上网设置代理，建议用美国的地址
终端输入
export http_proxy=192.168.222.162:7890
export https_proxy=192.168.222.162:7890
2、打开claude的官网找到一键安装脚本：https://claude.com/product/claude-code会适配你的系统自动提供安装脚本
3、在终端直接执行脚本往往会假成功，由于网络的原因。所以将一键安装脚本拆解
一键安装脚本：curl -fsSL https://claude.ai/install.sh | bash
拆解为：
wget https://claude.ai/install.sh
bash install.sh
注：该安装脚本会在家目录的.claude/downloads下面下载最新版的claude code，如果直接执行一键安装脚本，往往会由于网络超时，不下载安装文件，直接跳转到安装成功提示，实际上是没有安装成功。
4、实际上下载的这个文件就是claude的二进制运行文件

既然知道了它的逻辑，我们不需要强行跑这个脚本，直接把它的底层逻辑拆解出来，在 Ubuntu 上用绝对能成功的方式手动执行：

第一步：安装必须的依赖（解决 jq 和网络证书问题）
Bash
sudo apt-get update
sudo apt-get install -y curl jq ca-certificates
第二步：手动下载并解压官方最新二进制文件
我们跳过脚本复杂的正则匹配，直接获取下载地址：

Bash

  1. 获取最新版本号
    VERSION=$(curl -fsSL https://downloads.claude.ai/claude-code-releases/latest)
  2. 自动检测你的系统架构 (x86_64 或 arm64)
    ARCH=$(uname -m)
    if [ "$ARCH" = "x86_64" ]; then PLATFORM="linux-x64"; else PLATFORM="linux-arm64"; fi
  3. 创建临时目录并下载
    mkdir -p ~/.claude/downloads
    curl -fL -o ~/.claude/downloads/claude "https://downloads.claude.ai/claude-code-releases/${VERSION}/${PLATFORM}/claude"
    第三步：正确放置到系统路径（关键）
    为了让你在任何地方输入 claude 都能用，且不需要配置复杂的环境变量，直接把它放到 Ubuntu 专用的用户本地目录：

Bash

  1. 确保用户本地 bin 目录存在
    mkdir -p ~/.local/bin
  2. 移动并赋予执行权限
    mv ~/.claude/downloads/claude ~/.local/bin/
    chmod +x ~/.local/bin/claude
  3. 清理临时目录
    rm -rf ~/.claude/downloads
    第四步：刷新环境变量
    确保你的系统能够识别 ~/.local/bin 路径：

Bash
如果没有加过，把它加到 .bashrc 中
if [[ ":$PATH:" != *":$HOME/.local/bin:"* ]]; then

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

fi
source ~/.bashrc
验证安装
现在在终端直接输入：

Bash
claude -v
只要能正常输出版本号，就说明安装完全成功。接着输入 claude 就会正式进入登录和初始化流程。

安装ccswitch用于模型切换

方法一：安装图形界面桌面端（GUI 推荐）
官方为 Linux 系统提供了 .deb 安装包或 AppImage。

  1. 快捷一键下载安装（以目前最新的 v3.15.0 为例）
    打开终端，运行以下命令自动下载并安装适用于 Ubuntu (x86_64) 的 .deb 包：

Bash

创建临时目录并下载 deb 包

cd /tmp
curl -LO https://github.com/farion1231/cc-switch/releases/download/v3.15.0/CC-Switch-v3.15.0-Linux-x86_64.deb

使用 apt 安装（可自动处理依赖）

sudo apt install ./CC-Switch-v3.15.0-Linux-x86_64.deb -y
💡 提示：如果是 ARM64 架构（例如树莓派或 ARM 架构云服务器），请将链接中的 x64 改为 arm64。

安装完成后，你可以在 Ubuntu 的应用菜单中搜索 CC-Switch 直接点击启动。

方法二：安装命令行版本（CLI）
如果你在没有图形界面的 Ubuntu 服务器（Headless）上工作，或者习惯在终端完成所有操作，官方提供了专门的 cc-switch-cli 工具，通常通过 npm 全局安装：

  1. 前置环境检查
    确保你已经安装了 Node.js（推荐使用你的系统上已经配好的环境，Node 18+ 即可）：

Bash
node -v
npm -v

  1. 全局安装客户端
    Bash
    npm install -g @saladday/cc-switch-cli
    ⚠️ 注意：如果遇到权限报错（Permission Denied），建议配置终端用户目录免 sudo（见上一轮提及的 ~/.npm-global 方法），或者使用 sudo npm install -g @saladday/cc-switch-cli --allow-root。
  2. 常用 CLI 操作命令
    安装成功后，在终端直接输入 cc-switch 即可查看帮助。以下是一些高频操作：

查看当前的 API 提供商：

Bash
cc-switch provider current
一键切换到其他配置（如你在 GUI 中设置好的备份节点或自定义路由）：

Bash

cc-switch provider switch <provider_id>
```
  • 检测当前环境是否存在变量冲突：
    cc-switch env check --app claude

🛠️ 常见问题排查（针对 GUI 桌面端）

1. 启动时提示缺少 libwebkit2gtk

Tauri 框架依赖系统的 WebKit 渲染引擎。如果点击应用没有反应，可以通过以下命令补齐 Ubuntu 的图形渲染依赖：

sudo apt-get update
sudo apt-get install -y libwebkit2gtk-4.0-37 libgtk-3-0
2. 图形端系统托盘（System Tray）不显示
CC-Switch 的一大特色是可以缩进系统托盘保持静默运行（Lightweight Mode）。但在 Ubuntu 默认的 GNOME 桌面下，系统托盘可能无法直接显示。

标签: none

添加新评论