安装教程

在 Windows、macOS、Linux 系统上安装和配置 Claude Code

安装教程 ¶

跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。整个过程只需要 5 分钟。

前置要求 ¶

Claude Code 需要 Node.js 环境才能运行。请确保你的电脑已安装 Node.js 18.0 或更高版本（推荐 Node.js 22 LTS）。

Windows 系统 ¶

步骤 1：安装 Node.js ¶

方法一：官网下载（推荐）¶

打开浏览器，访问 https://nodejs.org/
点击 "LTS" 版本下载（推荐的长期支持版本）
下载完成后双击 .msi 文件
按照安装向导，使用默认设置完成安装

方法二：使用包管理器 ¶

如果你已经安装了 Chocolatey 或 Scoop：

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

验证安装 ¶

安装完成后，打开 PowerShell 或 CMD，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功了！

步骤 2：安装 Claude Code ¶

打开 PowerShell 或 CMD，运行：

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

验证安装：

claude --version

步骤 3：设置环境变量 ¶

临时设置（当前会话）¶

在 PowerShell 中运行：

$env:ANTHROPIC_BASE_URL = "https://asia.qcode.cc/api"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key"

永久设置（推荐）¶

设置用户级环境变量：

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://asia.qcode.cc/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key", [System.EnvironmentVariableTarget]::User)

记得将 your-api-key 替换为在 QCode.cc 控制台中创建的实际密钥。

验证设置 ¶

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

步骤 4：开始使用 ¶

# 进入你的项目目录
cd C:\path\to\your\project

# 启动 Claude Code
claude

Windows 常见问题 ¶

权限错误？

以管理员身份运行 PowerShell
或配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm

PowerShell 执行策略错误？

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量不生效？

设置永久环境变量后重启 PowerShell 或 CMD
或注销并重新登录 Windows

macOS 系统 ¶

步骤 1：安装 Node.js ¶

方法一：使用 Homebrew（推荐）¶

如果你已经安装了 Homebrew：

# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二：官网下载 ¶

访问 https://nodejs.org/
下载 macOS 的 LTS 版本
打开下载的 .pkg 文件
按照安装说明完成安装

验证安装 ¶

node --version
npm --version

步骤 2：安装 Claude Code ¶

方法一：Homebrew（推荐）¶

brew install --cask claude-code

方法二：npm 安装 ¶

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

如果遇到权限问题，使用 sudo：

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

验证安装：

claude --version

步骤 3：设置环境变量 ¶

临时设置（当前会话）¶

export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

永久设置（推荐）¶

编辑你的 shell 配置文件：

# 对于 zsh（macOS 默认）
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bash_profile
source ~/.bash_profile

记得将 your-api-key 替换为在 QCode.cc 控制台中创建的实际密钥。

步骤 4：开始使用 ¶

# 进入你的项目目录
cd /path/to/your/project

# 启动 Claude Code
claude

macOS 常见问题 ¶

权限错误？

使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
或配置 npm 使用用户目录：npm config set prefix ~/.npm-global

系统阻止执行？

打开 "系统偏好设置" → "安全性与隐私"
点击 "仍要打开" 或 "允许"

Linux / WSL2 系统 ¶

步骤 1：安装 Node.js ¶

方法一：使用 NodeSource 官方仓库（推荐）¶

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

方法二：使用系统包管理器 ¶

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

验证安装 ¶

node --version
npm --version

步骤 2：安装 Claude Code ¶

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

如果遇到权限问题：

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

验证安装：

claude --version

步骤 3：设置环境变量 ¶

临时设置 ¶

export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="your-api-key"

永久设置 ¶

# 对于 bash（默认）
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.bashrc
source ~/.bashrc

# 对于 zsh
echo 'export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key"' >> ~/.zshrc
source ~/.zshrc

步骤 4：开始使用 ¶

cd /path/to/your/project
claude

Linux 常见问题 ¶

缺少依赖库？

# Ubuntu/Debian
sudo apt install build-essential

# CentOS/RHEL
sudo dnf groupinstall "Development Tools"

高级配置（可选环境变量）¶

除了必需的两个环境变量外，还可以通过以下变量进行更多自定义：

ANTHROPIC_MODEL ¶

指定默认使用的模型（不设置时默认使用 Sonnet 4.6）：

# 使用 Sonnet 4.6（默认，推荐）
export ANTHROPIC_MODEL=claude-sonnet-4-6-20250929

# 使用 Opus 4.6（最强模型，费用更高）
export ANTHROPIC_MODEL=claude-opus-4-6

MAX_THINKING_TOKENS ¶

控制模型思考过程的最大 token 数（设为 0 禁用思考）：

export MAX_THINKING_TOKENS=16000

CLAUDE_CODE_EFFORT_LEVEL ¶

调整 Claude 的工作努力程度：

# 可选值：low / medium / high
export CLAUDE_CODE_EFFORT_LEVEL=high

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC ¶

禁用非必要的网络请求（如遥测）：

export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

下一步 ¶

恭喜！你已经成功安装了 Claude Code。接下来：

查看快速上手学习基本用法
探索命令行技巧提高效率

← 上一篇

介绍

快速上手

🚀

开始使用 QCode — AI 编程助手

Claude Code 官方中继，稳定快速，开箱即用

查看套餐定价 → 注册账号