博客

Claude CLI 安装教程 2026：macOS、Windows、WSL2 完整安装指南 | TeamoRouter

快速回答

Claude CLI（品牌名 Claude Code）通过 npm 安装：npm install -g @anthropic-ai/claude-code。需要 Node.js 18 或更高版本。macOS 上也可使用 Homebrew（brew install claude-code）。Windows 上推荐 WSL2 + npm。安装后配置 API 端点——可直连 Anthropic 官方 API（需海外支付），或接入 TeamoRouter 等统一网关（支持支付宝/微信、免 VPN）。完整教程如下。

什么是 Claude CLI（Claude Code）？

Claude CLI——官方品牌名为 Claude Code——是 Anthropic 的命令行 agentic 编程工具。它在终端中运行，可以跨整个项目读取、写入和重构代码，执行 Shell 命令，管理 Git 操作，并与 MCP（Model Context Protocol）服务器交互以获得数据库访问、网页搜索和 API 集成等扩展能力。

与 claude.ai 网页界面不同，Claude CLI 拥有直接的文件系统访问权限，在你的 Shell 环境中运行，并作为 agent 工作：它可以规划多步骤任务、执行它们、观察结果并迭代。它是终端中 AI 辅助软件开发的主要工具。

核心能力包括：

  • 多文件代码生成、重构和审查
  • 执行 Shell 命令并观察输出
  • Git 操作（commit、diff、分支管理）
  • MCP 服务器集成（数据库、API、网页搜索、文件系统）
  • 自定义斜杠命令用于项目特定工作流
  • 会话历史和导出

前置条件：Node.js 18+

Claude CLI 以 npm 包形式发行，需要 Node.js 18 或更高版本。

检查当前版本：

bash
node --version  # 应输出 v18.0.0 或更高

安装或升级 Node.js（推荐 nvm）：

bash
# macOS / Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 20
nvm use 20

安装：macOS

方式一：Homebrew（推荐）

bash
# 安装 Node.js（如未安装）
brew install node@20

# 验证
node --version
npm --version

# 安装 Claude Code
brew install claude-code
claude --version

Homebrew 会自动处理 Node.js 依赖。更新：brew upgrade claude-code。

方式二：npm

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

使用 nvm 管理 Node.js 可避免全局安装时的 sudo 权限问题。Apple Silicon（M1/M2/M3/M4）原生支持，无需 Rosetta。

安装：Windows

WSL2 + npm（推荐）

Claude CLI 为类 Unix 环境设计，WSL2 在 Windows 上提供完整 Linux 环境。

第一步：安装 WSL2

以管理员身份打开 PowerShell：

powershell
wsl --install

重启电脑后，Ubuntu 终端将自动打开。

第二步：在 WSL2 中安装 Node.js

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

第三步：安装 Claude CLI

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

性能提示： 将项目文件放在 WSL2 内部文件系统中（~/projects/）而非 Windows 挂载（/mnt/c/），以获得更好的 I/O 性能。

原生 Windows npm（有局限）

powershell
# 先从 nodejs.org 安装 Node.js，然后：
npm install -g @anthropic-ai/claude-code

原生 Windows 存在已知问题：Shell 命令行为差异、部分 MCP 服务器不兼容、文件路径边界情况。WSL2 是强烈推荐的方式。

安装：Linux

bash
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

# Fedora/RHEL
sudo dnf module install nodejs:20
npm install -g @anthropic-ai/claude-code

# Arch Linux
sudo pacman -S nodejs npm
npm install -g @anthropic-ai/claude-code

首次运行配置

方式一：Anthropic 官方直连

bash
export ANTHROPIC_API_KEY="sk-ant-api03-your-key-here"

需要 Anthropic 账户和海外支付方式。

方式二：TeamoRouter 网关（推荐）

bash
export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="tr-your-key-here"

在 https://teamorouter.com/zh 注册、充值（支付宝/微信）、生成 Key。不需要海外银行卡。

TeamoRouter 路线优势：

  • 支付宝/微信以人民币支付
  • 浮动费率低至官价 1-2 折
  • 提示词缓存命中率 >99%（大幅降低长会话成本）
  • 一把 Key 同时访问 Claude、GPT、Gemini、DeepSeek

更多详情参见 TeamoRouter AI API 网关。

持久化配置

bash
# zsh 用户（macOS 默认）
echo 'export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="tr-your-key"' >> ~/.zshrc
source ~/.zshrc

# bash 用户（Linux 默认）
echo 'export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="tr-your-key"' >> ~/.bashrc
source ~/.bashrc

或编辑 ~/.claude/settings.json：

json
{
  "apiKey": "tr-your-key",
  "baseUrl": "https://api.teamorouter.com/anthropic"
}

测试配置

bash
echo "用 Python 写一个反转字符串的函数" | claude

收到正常回复即配置成功。

连接架构对比：官方直连 vs 网关

方面 Anthropic 官方直连 TeamoRouter 网关
支付方式 海外 Visa/MC/AmEx 支付宝、微信支付
每 Token 成本 官方标价 官价 1-2 折（浮动费率）
提示词缓存 支持（内置） 支持（>99% 命中率）
多模型访问 仅 Claude 模型 Claude + GPT + Gemini + DeepSeek
中国发票 无法提供 企业账户可开具
配置复杂度 需 Anthropic 账户 + 海外卡 邮箱注册 + 支付宝/微信充值

常见安装问题排查

npm 安装后提示 "command not found: claude"

bash
npm config get prefix
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

全局 npm 安装权限错误

使用 nvm 管理 Node.js（无需 sudo）：

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 20
nvm use 20
npm install -g @anthropic-ai/claude-code

Node.js 版本太旧

bash
nvm install 20
nvm use 20
nvm alias default 20

首次运行时提示 "ANTHROPIC_API_KEY not set"

设置 TeamoRouter 网关：

bash
export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="tr-your-key-here"

WSL2：文件系统性能问题

将项目从 Windows 文件系统迁移到 WSL2 原生文件系统：

bash
cp -r /mnt/c/Users/你的用户名/Projects/my-project ~/projects/my-project
cd ~/projects/my-project
claude

macOS：提示"无法验证开发者"

前往系统设置 > 隐私与安全性，在被阻止的应用旁边点击仍要打开。

卸载与更新

bash
# 卸载（Homebrew）
brew uninstall claude-code

# 卸载（npm）
npm uninstall -g @anthropic-ai/claude-code

# 删除所有本地配置
rm -rf ~/.claude

# 更新
brew upgrade claude-code           # Homebrew
npm update -g @anthropic-ai/claude-code  # npm

常见问题

我需要 Anthropic 账户才能使用 Claude CLI 吗？

走官方直连需要。走 TeamoRouter 则不需要——只需 TeamoRouter 账户，通过支付宝/微信以人民币付费，无需 Anthropic 账户和海外卡。

可以不安 Node.js 就装 Claude CLI 吗？

不可以。Claude CLI 仅以 npm 包形式发行，运行时需要 Node.js。macOS 上的 Homebrew 安装会自动捆绑 Node.js，但运行时仍需要。截至 2026 年没有独立二进制发行版。

Windows 用户必须用 WSL2 吗？

强烈推荐，但非严格必须。原生 Windows 安装可以用于基本使用，但会遇到 Shell 命令、MCP 服务器和文件路径处理的边界问题。WSL2 是正确选择。

怎么更新 Claude CLI？

Homebrew：brew upgrade claude-code；npm：npm update -g @anthropic-ai/claude-code。运行 claude --version 查看当前版本。

能同时用 Claude CLI 连接多个 API 吗？

可以。通过更改 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 切换供应商。有了 TeamoRouter，一把 Key 就能通过同一接口访问所有模型，很少需要切换。也可创建 Shell 别名管理多个端点。

使用 Claude CLI 要花多少钱？

Claude CLI 本身免费，你为 API 使用付费。通过 TeamoRouter 的浮动费率和缓存保留，典型开发者每月花费 $20-$50，远低于直接支付官方标价的 $100-$500。

Claude CLI 能离线使用吗？

不能。Claude CLI 是瘦客户端，每次交互都需要活跃的网络连接向远程服务器发送 API 请求。如需离线 AI 辅助，可考虑本地模型（Ollama、LM Studio），但能力和 Claude 不在同一水平。

准备好接入了吗？登录控制台 · 购买额度 · 创建 API Key，三步即可开始。
获取 API Key查看帮助文档
关闭文章
Claude CLI 安装教程 2026：macOS、Windows、WSL2 完整安装指南 | TeamoRouter · TeamoRouter