Claude Code 安装

Claude Code 安装教程

这是一个完整的 Claude Code 安装指南，支持 Windows、macOS 和 Linux 系统。

目录

• Windows 安装
• macOS 安装
• Linux 安装
• 开始使用

---

Windows 安装

1. 打开命令行

在开始安装之前，我们需要先打开”命令行”。命令行是一个黑色的窗口，你可以在里面输入文字命令来操作电脑，就像发短信一样，只不过是和电脑”对话”。

方法一：使用搜索功能（最简单，推荐新手）

1. 点击屏幕左下角的开始菜单（就是那个Windows图标）
2. 在搜索框中输入：cmd 或者 PowerShell
3. 点击搜索结果中的程序
   • 如果你看到”命令提示符”或”PowerShell”，点击它就可以了
   • 推荐选择”PowerShell”，它功能更强大

方法二：使用快捷键（熟练后很方便）

1. 同时按住：Windows键 + R键
   • Windows键就是键盘上有Windows图标的那个键
2. 在弹出的小窗口中输入：cmd 或 powershell
3. 按回车键，命令行窗口就会打开

方法三：从文件夹打开（在特定位置很有用）

1. 打开任意文件夹（比如桌面、文档等）
2. 在文件夹的空白处，按住 Shift键 + 右键
3. 在弹出的菜单中，选择”在此处打开PowerShell窗口”或”在此处打开命令窗口”

如何识别命令行已经打开

成功打开后，你会看到一个黑色或深蓝色的窗口，里面有一些文字，通常以 C:\ 开头，后面有一个闪烁的光标。这就是命令行窗口，你可以在光标位置输入命令了。

💡 小贴士：如果你是第一次使用，建议选择PowerShell，它的功能更完善，后续操作会更顺利。

2. 安装 Node.js 环境

Claude Code 需要 Node.js 环境才能运行。

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

1. 打开浏览器访问 https://nodejs.org/
2. 点击 “LTS” 版本进行下载（推荐长期支持版本）
3. 下载完成后双击 .msi 文件
4. 按照安装向导完成安装，保持默认设置即可

方法二：使用包管理器

如果你安装了 Chocolatey 或 Scoop，可以使用命令行安装：

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项

• 建议使用 PowerShell 而不是 CMD
• 如果遇到权限问题，尝试以管理员身份运行
• 某些杀毒软件可能会误报，需要添加白名单

验证安装

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

node --version
npm --version

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

3. 安装 Claude Code

打开 PowerShell 或 CMD，运行以下命令：

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

验证 Claude Code 安装

安装完成后，输入以下命令检查是否安装成功：

claude --version

如果显示版本号，恭喜你！Claude Code 已经成功安装了。

4. 设置环境变量

配置 Claude Code 环境变量

方法一：PowerShell 临时设置（当前会话）

$env:ANTHROPIC_BASE_URL = "https://api.cceverything.com/api"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"

方法二：PowerShell 永久设置（用户级）

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.cceverything.comm/api", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)

查看已设置的环境变量：

# 查看用户级环境变量
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", [System.EnvironmentVariableTarget]::User)
[System.Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", [System.EnvironmentVariableTarget]::User)

💡 设置后需要重新打开 PowerShell 窗口才能生效。

验证环境变量设置

# 在 PowerShell 中验证
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

# 在 CMD 中验证
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

配置 Gemini CLI 环境变量（可选）

# 临时设置
$env:CODE_ASSIST_ENDPOINT = "https://api.cceverything.comm/gemini"
$env:GOOGLE_CLOUD_ACCESS_TOKEN = "你的API密钥"
$env:GOOGLE_GENAI_USE_GCA = "true"

# 永久设置
[System.Environment]::SetEnvironmentVariable("CODE_ASSIST_ENDPOINT", "https://api.cceverything.comm/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_CLOUD_ACCESS_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GOOGLE_GENAI_USE_GCA", "true", [System.EnvironmentVariableTarget]::User)

配置 OpenAI API 环境变量（可选）

# 临时设置
$env:OPENAI_BASE_URL = "https://api.cceverything.comm/openai"
$env:OPENAI_API_KEY = "你的API密钥"

# 永久设置
[System.Environment]::SetEnvironmentVariable("OPENAI_BASE_URL", "https://api.cceverything.comm/openai", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的API密钥", [System.EnvironmentVariableTarget]::User)

---

macOS 安装

1. 打开命令行

在 macOS 系统中，命令行叫做”终端”（Terminal），它是一个可以输入文字命令来操作电脑的程序，就像和电脑进行文字聊天一样。

方法一：使用聚焦搜索（最简单，推荐新手）

1. 按快捷键：Command键 + 空格键
   • Command键就是键盘上有⌘符号的那个键
2. 在弹出的搜索框中输入：Terminal 或者 终端
3. 按回车键，或者用鼠标点击搜索结果中的”终端”

方法二：通过启动台（Launchpad）

1. 点击程序坞（屏幕底部的那一排图标）中的”启动台”图标
   • 启动台图标看起来像一个有9个小方格的火箭
2. 寻找”其他”文件夹，点击打开
3. 找到”终端”图标，点击打开

方法三：通过访达（Finder）

1. 点击程序坞中的访达图标（看起来像一个笑脸）
2. 在左侧边栏点击”应用程序”
3. 找到并打开”实用工具”文件夹
4. 双击”终端”应用程序

方法四：从文件夹右键打开（在特定位置很有用）

1. 打开任意文件夹
2. 在文件夹空白处右键
3. 选择”在文件夹位置打开终端”（某些版本可能需要先在系统偏好设置中启用）

如何识别终端已经打开

成功打开后，你会看到一个窗口，通常是白色或黑色背景，里面有一些文字，类似于：

User-MacBook:~ username$ 

后面有一个闪烁的光标，这就是终端窗口，你可以在光标位置输入命令了。

💡 小贴士：

• 如果你觉得默认的终端不够好用，可以下载 iTerm2，它是一个功能更强大的终端替代品
• 第一次使用可能需要在”系统偏好设置”→“安全性与隐私”中允许终端访问某些功能

2. 安装 Node.js 环境

方法一：使用 Homebrew（推荐）

# 更新 Homebrew
brew update

# 安装 Node.js
brew install node

方法二：官网下载

1. 访问 https://nodejs.org/
2. 下载适合 macOS 的 LTS 版本
3. 打开下载的 .pkg 文件
4. 按照安装程序指引完成安装

macOS 注意事项

• 如果遇到权限问题，可能需要使用 sudo
• 首次运行可能需要在系统偏好设置中允许
• 建议使用 Terminal 或 iTerm2

验证安装

node --version
npm --version

3. 安装 Claude Code

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 如果遇到权限问题
sudo npm install -g @anthropic-ai/claude-code

验证安装

claude --version

4. 设置环境变量

配置 Claude Code 环境变量

方法一：临时设置（当前会话）

export ANTHROPIC_BASE_URL="https://api.cceverything.com/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

方法二：永久设置

# 对于 zsh (默认)
echo 'export ANTHROPIC_BASE_URL="https://api.cceverything.com/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

# 对于 bash
echo 'export ANTHROPIC_BASE_URL="https://api.cceverything.com/api"' >> ~/.bash_profile
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bash_profile
source ~/.bash_profile

配置 Gemini CLI 环境变量（可选）

# 临时设置
export CODE_ASSIST_ENDPOINT="https://api.cceverything.com/gemini"
export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"
export GOOGLE_GENAI_USE_GCA="true"

# 永久设置 (zsh)
echo 'export CODE_ASSIST_ENDPOINT="https://api.cceverything.com/gemini"' >> ~/.zshrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.zshrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.zshrc
source ~/.zshrc

配置 OpenAI API 环境变量（可选）

# 临时设置
export OPENAI_BASE_URL="https://api.cceverything.com/openai"
export OPENAI_API_KEY="你的API密钥"

# 永久设置 (zsh)
echo 'export OPENAI_BASE_URL="https://api.cceverything.com/openai"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

验证环境变量

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

---

Linux 安装

1. 安装 Node.js 环境

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

# 添加 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

Linux 注意事项

• 某些发行版可能需要安装额外的依赖
• 如果遇到权限问题，使用 sudo
• 确保你的用户在 npm 的全局目录有写权限

验证安装

node --version
npm --version

2. 安装 Claude Code

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 如果遇到权限问题
sudo npm install -g @anthropic-ai/claude-code

验证安装

claude --version

3. 设置环境变量

配置 Claude Code 环境变量

方法一：临时设置（当前会话）

export ANTHROPIC_BASE_URL="https://api.cceverything.comm/api"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

方法二：永久设置

# 对于 bash (默认)
echo 'export ANTHROPIC_BASE_URL="https://api.cceverything.comm/api"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

# 对于 zsh
echo 'export ANTHROPIC_BASE_URL="https://api.cceverything.com/api"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

配置 Gemini CLI 环境变量（可选）

# 临时设置
export CODE_ASSIST_ENDPOINT="https://api.cceverything.com/gemini"
export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"
export GOOGLE_GENAI_USE_GCA="true"

# 永久设置 (bash)
echo 'export CODE_ASSIST_ENDPOINT="https://api.cceverything.com/gemini"' >> ~/.bashrc
echo 'export GOOGLE_CLOUD_ACCESS_TOKEN="你的API密钥"' >> ~/.bashrc
echo 'export GOOGLE_GENAI_USE_GCA="true"' >> ~/.bashrc
source ~/.bashrc

配置 OpenAI API 环境变量（可选）

# 临时设置
export OPENAI_BASE_URL="https://api.cceverything.com/openai"
export OPENAI_API_KEY="你的API密钥"

# 永久设置 (bash)
echo 'export OPENAI_BASE_URL="https://api.cceverything.com/openai"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

验证环境变量

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

---

开始使用

现在你可以开始使用 Claude Code 了！

启动 Claude Code

claude

在特定项目中使用

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

# 启动 Claude Code
claude

---

重要提示

1. API 密钥替换：记得将所有命令中的 “你的API密钥” 替换为你在 “API Keys” 标签页中创建的实际密钥
2. 环境变量生效：永久设置环境变量后需要重新打开终端/PowerShell 窗口才能生效
3. 权限问题：如果遇到权限问题，在命令前添加 sudo（Linux/macOS）或以管理员身份运行（Windows）
4. API 密钥格式：API 密钥格式通常为 cr_xxxxxxxxxxxxxxxxxx

安装完成后，你就可以享受 Claude Code 强大的 AI 编程助手功能了！