Ubuntu 系统下 Claude Code 安装与配置实战

在 Linux 环境下，尤其是 Ubuntu 服务器中，Claude Code 的部署通常比 Windows 更稳定且依赖冲突更少。无论是云端生产环境还是本地开发，遵循以下流程即可快速构建可用的 AI 编程辅助工具。

1. 更新系统环境

建议先执行系统更新，确保基础库为最新状态：

sudo apt update && sudo apt upgrade -y

2. 安装 Node.js

推荐使用 NodeSource 官方源安装 LTS 版本，以保证长期运行的稳定性：

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

安装完成后验证版本：

node -v
npm -v

3. 安装 Git

部分操作可能需要 Git 支持：

sudo apt install -y git

4. 安装 Claude Code CLI

通过 npm 全局安装官方 CLI 工具：

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

验证安装是否成功：

claude --version

5. 配置环境变量

这是核心步骤。需要在用户目录下创建配置文件以指定 API Key 及其他参数。

① 创建配置目录与文件

mkdir -p ~/.claude
nano ~/.claude/settings.json

② 编辑配置文件

将以下内容填入文件中，注意替换 ANTHROPIC_AUTH_TOKEN 为你自己的密钥。若使用代理或特定网关，可配置 ANTHROPIC_BASE_URL。

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
    "API_TIMEOUT_MS": "3000000",