Linux / WSL 安装与使用
Last updated on
给 Linux 和 WSL 用户的一条完整主线：装依赖、配 API Key、安装 Claude Code、第一次启动。
先选对系统页
如果你不是 Linux / WSL 用户，直接改看：
这一页同时适合两类人
- 直接在 Linux 电脑上使用 Claude Code 的用户
- 在 Windows 里通过 WSL 使用 Claude Code 的用户
主线步骤一样：准备依赖、准备 API Key、安装 Claude Code、第一次启动。
第 1 步：装好 Node.js、npm 和 Git
Claude Code 在 Linux / WSL 下的基础依赖也是：Node.js、npm 和 Git。
先确认你在正确的环境里安装
如果你用的是 WSL，就在 WSL 终端里 安装依赖、配置环境变量、运行 Claude Code。
不要把 Windows 里的安装结果直接当成 WSL 里的安装结果来用。
1. 安装 Node.js 和 npm
先用你当前发行版熟悉的方式装好 Node.js。
如果你刚开始接触 Linux / WSL，最简单的原则只有一个：不管你用什么方式安装，最后一定要让下面两条命令正常返回版本号。
node -v
npm -v第 2 步：准备可用的 API Key
先登录 api.dingjiai.com，完成充值并创建新的 API Key。
创建完成后，把这串 Key 保存好，不要提交到仓库，也不要随手发给别人。
第 3 步：安装 Claude Code
2. 运行安装命令
npm install -g @anthropic-ai/claude-code第 4 步：把 API Key 配进当前 shell
第一次先用临时方式验证
先确认 Claude Code 能跑通，再决定要不要写进长期配置。
当前 shell 临时生效
export ANTHROPIC_API_KEY="你的 API Key"如果你的接入方式还要求 Base URL，再补一条：
export ANTHROPIC_BASE_URL="你的 Base URL"想长期生效，再写进 shell 配置文件
如果你常用的是 bash，可以执行：
echo 'export ANTHROPIC_API_KEY="你的 API Key"' >> ~/.bashrc如果还需要 Base URL，再补一条：
echo 'export ANTHROPIC_BASE_URL="你的 Base URL"' >> ~/.bashrc写完后执行：
source ~/.bashrc如果你用的是 zsh，就把同样的内容写进 ~/.zshrc。
第 5 步：进入项目并启动 Claude Code
Linux / WSL 下最常见的 3 个问题
1. claude --version 找不到命令
先检查：
node -v
npm -v如果依赖本身不正常，就先修依赖，不要先怀疑 Claude Code 本身。
2. WSL 里能看到项目，但命令行为很怪
优先检查你是不是在 WSL 里 完整安装了当前要用的依赖和命令。
不要混用 Windows 和 WSL 的安装结果来判断。
3. 启动时报认证或连接错误
优先检查这 3 件事：
ANTHROPIC_API_KEY有没有写对- 如果你的路线需要
ANTHROPIC_BASE_URL，有没有一起配好 - 你当前运行
claude的 shell，会不会根本没加载到你刚写的配置
做到什么状态算完成
满足下面这几条，就说明 Linux / WSL 这条路线已经跑通了
- Node.js、npm 和 Git 都可用
- 你已经准备好 API Key
- 你已经成功运行过
npm install -g @anthropic-ai/claude-code claude --version能正常返回版本号- 你已经在项目目录里成功启动过
claude
跑通后，下一步继续看 更多。