跳到主要内容

Claude Code

Claude Code 是 Anthropic 推出的 AI 编程助手工具。跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。

提示

模力方舟提供对 Claude Code 的原生支持，你可以使用模力方舟的任一编码模型，享受更优质的中文支持和更低的调用成本。

1. 安装 Node.js 环境​

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

Windows 安装方法​

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

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

方法二：使用包管理器

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

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

Windows 注意事项

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

macOS 安装方法​

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

  1. 打开浏览器访问 https://nodejs.org/
  2. 点击 "LTS" 版本进行下载
  3. 下载完成后双击 .pkg 文件
  4. 按照安装向导完成安装

方法二：使用 Homebrew

# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 使用 Homebrew 安装 Node.js
brew install node

Linux / WSL2 安装方法​

使用包管理器安装

Ubuntu/Debian:

# 更新包列表
sudo apt update

# 安装 Node.js 和 npm
sudo apt install nodejs npm

CentOS/RHEL/Fedora:

# 对于 CentOS/RHEL
sudo yum install nodejs npm

# 对于 Fedora
sudo dnf install nodejs npm

验证安装是否成功​

安装完成后，打开终端（Windows 使用 PowerShell），输入以下命令：

node --version
npm --version

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

2. 安装 Claude Code​

打开终端（Windows 使用 PowerShell），运行以下命令：

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

提示

  • Windows 用户建议使用 PowerShell 而不是 CMD，功能更强大
  • 如果遇到权限问题，以管理员身份运行 PowerShell

验证 Claude Code 安装​

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

claude --version

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

3. 获取访问令牌​

开发者首先需要访问 工作台->设置->访问令牌 中获取访问令牌，没有购买 Serverless API 的开发者，可以使用免费体验访问令牌（仅供体验，每日调用次数有限），复制想要使用的令牌即可。

4. 配置环境变量​

为了让 Claude Code 连接到我们的服务，需要设置相关环境变量。

推荐模型：目前 kimi-k2-instruct 和 GLM-4_5 两个模型效果最佳，建议优先使用。

Windows (PowerShell)​

临时设置（当前会话）

$env:ANTHROPIC_BASE_URL = "https://ai.gitee.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
$env:ANTHROPIC_MODEL = "GLM-4_5"
$env:ANTHROPIC_SMALL_FAST_MODEL = "GLM-4_5"

永久设置（用户级）

# 设置用户级环境变量（永久生效）
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://ai.gitee.com/anthropic", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "GLM-4_5", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "GLM-4_5", [System.EnvironmentVariableTarget]::User)

macOS / Linux / WSL2​

临时设置（当前会话）

export ANTHROPIC_BASE_URL="https://ai.gitee.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export ANTHROPIC_MODEL="GLM-4_5"
export ANTHROPIC_SMALL_FAST_MODEL="GLM-4_5"

永久设置

将以下内容添加到 ~/.bashrc 或 ~/.zshrc 文件中：

export ANTHROPIC_BASE_URL="https://ai.gitee.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"
export ANTHROPIC_MODEL="GLM-4_5"
export ANTHROPIC_SMALL_FAST_MODEL="GLM-4_5"

然后重新加载配置文件：

# 如果使用 bash
source ~/.bashrc

# 如果使用 zsh
source ~/.zshrc

重要提示：记得将 "你的API密钥" 替换为在上方 "获取访问令牌" 步骤中获取的实际密钥。

验证环境变量设置​

Windows (PowerShell)

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_MODEL
echo $env:ANTHROPIC_SMALL_FAST_MODEL

macOS / Linux / WSL2

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_MODEL
echo $ANTHROPIC_SMALL_FAST_MODEL

预期输出示例：

https://ai.gitee.com/anthropic
你的API密钥
GLM-4_5
GLM-4_5

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。设置后需要重新打开终端窗口才能生效。

5. 开始使用 Claude Code​

配置完成后，你就可以开始使用 Claude Code 了！在任何目录下运行：

claude

这将启动 Claude Code 交互界面，你可以开始与 AI 编程助手进行对话了。

更多资源​