ubuntu22.04 配置cluade code & 硅基流动API

这里写自定义目录标题

- 主要步骤
- [步骤 1：更新环境](#步骤 1：更新环境)
- [步骤 2：安装 Node.js](#步骤 2：安装 Node.js)
- [步骤 3：安装 Git](#步骤 3：安装 Git)
- [步骤 4：安装 Claude Code CLI](#步骤 4：安装 Claude Code CLI)
- [步骤 5：配置 Claude Code 的环境变量（核心步骤,绕过引导与连接API）](#步骤 5：配置 Claude Code 的环境变量（核心步骤,绕过引导与连接API）)
- - [① 配置强制跳过官方引导（必做）](#① 配置强制跳过官方引导（必做）)
  - [② 配置~/.claude/settings.json](#② 配置~/.claude/settings.json)
  - - [方法一：使⽤ settings.json ⽂件](#方法一：使⽤ settings.json ⽂件)
    - [方法二：设置系统环境变量在 shell 配置⽂件（如 ~/.bashrc 或 ~/.zshrc）](#方法二：设置系统环境变量在 shell 配置⽂件（如 ~/.bashrc 或 ~/.zshrc）)
- 终端输入claude
- 参考

主要步骤

基本要求

操作系统： Ubuntu18.04+、CentOS7+等主流 Linux 发⾏版。Node.js：版本需 ≥ 18.0，这是运⾏ Claude Code CLI 的基础；更稳妥的推荐：v20+。

Git：⽤于版本控制集成。

⽹络：直接连接Anthropic官⽅服务需要相应的⽹络权限。

对于国内⽤⼾，下⽂将重点介绍使⽤国内API中转服务或国内⼤模型API的替代⽅案。

步骤 1：更新系统环境（强烈建议先执行）

步骤 2：安装 Node.js

步骤 3：安装 Git

步骤 4：安装 Claude Code CLI

步骤 5：配置 Claude Code 的环境变量（核心步骤）

步骤 6：首次运行 Claude Code（本地模式）

步骤 1：更新环境

以下步骤适用于 Ubuntu 20.04 / 22.04 / 24.04（云服务器、本地桌面版均可）。

bash 复制代码

sudo apt update && sudo apt upgrade -y

步骤 2：安装 Node.js

推荐使用 NodeSource 官方源安装最新 LTS。

bash 复制代码

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

检查版本：

bash 复制代码

node -v
npm -v

若node.js 版本太旧，则无法运行 @anthropic-ai/claude-code 包，卸载旧版node.js:

bash 复制代码

# 1. 移除所有旧版本 nodejs 和 libnode-dev 相关包
sudo apt remove --purge nodejs libnode-dev
sudo apt autoremove   # 清理不再需要的依赖

# 2. 重新安装 Node.js 22
sudo apt install -y nodejs

步骤 3：安装 Git

bash 复制代码

sudo apt install -y git
git --version

并配置git config,查询方法：

bash 复制代码

git config --list

步骤 4：安装 Claude Code CLI

bash 复制代码

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

检查是否安装成功：

bash 复制代码

claude --version

步骤 5：配置 Claude Code 的环境变量（核心步骤,绕过引导与连接API）

① 配置强制跳过官方引导（必做）

安装后⾸次运⾏claude通常会强制要求登录官⽅账号并连接其服务，这对于国内⽤⼾是不可⾏的。必须通过配置跳过此流程并指向可⽤的API端点。跳过强制登录引导这是使⽤第三⽅API前的必需步骤。在⽤⼾主⽬录（~）下创建或修改 .claude.json ⽂件：

在json中加入：

bash 复制代码

{
"hasCompletedOnboarding": true
}

若json⽂件中没有该字段，则新增之；此配置会告知ClaudeCode已完成初始设置，从⽽跳过⽹络连接检查。

② 配置~/.claude/settings.json

配置API密钥与端点（关键）需要配置API密钥和基础URL。

API推荐使用硅基流动平台，主流模型都有，且免费额度大，新人送16元使用权，可以使用各类主流模型。
如果本wiki对您有帮助，在注册账号时，请大佬们邀请码填写：4Upt6eMu
或者直接点链接注册：

https://cloud.siliconflow.cn/i/4Upt6eMu

方法一：使⽤ settings.json ⽂件

claude Code 会在 ~/.claude/settings.json 中读取配置。

bash 复制代码

cd ~/.claude
touch settings.json

在settings.json中配置：

bash 复制代码

{
  "env": {
  "ANTHROPIC_AUTH_TOKEN": "你的API",
  "ANTHROPIC_BASE_URL":"https://api.siliconflow.cn/",
  "ANTHROPIC_MODEL":"deepseek-ai/DeepSeek-V4-Flash"
  }
}

方法二：设置系统环境变量在 shell 配置⽂件（如 ~/.bashrc 或 ~/.zshrc）

在~/.bashrc或者 ~/.zshrc中加入：

bash 复制代码

export ANTHROPIC_AUTH_TOKEN="你的API"
export ANTHROPIC_BASE_URL="https://api.siliconflow.cn/"
export ANTHROPIC_MODEL:"deepseek-ai/DeepSeek-V4-Flash"

终端输入claude

上述配置完成，终端输入claude，测试

ubuntu22.04 配置cluade code & 硅基流动API

这里写自定义目录标题

主要步骤

步骤 1：更新环境

步骤 2：安装 Node.js

步骤 3：安装 Git

步骤 4：安装 Claude Code CLI

步骤 5：配置 Claude Code 的环境变量（核心步骤,绕过引导与连接API）

① 配置强制跳过官方引导（必做）

② 配置~/.claude/settings.json

方法一：使⽤ settings.json ⽂件

方法二：设置系统环境变量在 shell 配置⽂件（如 ~/.bashrc 或 ~/.zshrc）

终端输入claude

参考