Claude Code 使用教程

跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code

新用户注册即送 $1 体验额度
模型倍率 0.3，低至 三折 优惠
立刻开始 Claude Code 点击前往管理站点，注册账号并获取你的 API 密钥
1

安装 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

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

2

安装 Claude Code

全局安装 Claude Code

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

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

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

提示

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

验证 Claude Code 安装

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

claude --version

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

3

获取 API 密钥

在使用 Claude Code 之前，你需要先获取一个 API 密钥。

打开管理站点

在浏览器中访问以下地址：

https://api.jdctools.com.cn
创建令牌
  1. 登录后，在左侧菜单中找到 「令牌管理」
  2. 点击 「添加令牌」 按钮
  3. 在分组选项中选择 「Claude Code」 分组
  4. 填写令牌名称（如：我的电脑）
  5. 点击确认创建令牌

保存你的密钥

创建成功后，系统会显示你的 API 密钥（以 cr_ 开头）。

⚠️ 重要：请立即复制并妥善保存这个密钥，它只会显示一次！

提示

  • 如果你还没有账号，请先注册或联系管理员获取
  • 一个令牌可以在多台设备上使用
  • 如果密钥丢失，可以删除旧令牌并创建新的
4

设置环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

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

在 PowerShell 中运行以下命令：

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

💡 记得将 "你的API密钥" 替换为实际的密钥。

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

在 PowerShell 中运行以下命令设置用户级环境变量：

# 设置用户级环境变量（永久生效） [System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.jdctools.com.cn", [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 窗口才能生效。

VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件，需要在配置文件中进行设置：

配置文件位置：C:\Users\你的用户名\.claude\config.json

💡 如果该文件不存在，请手动创建。

{ "primaryApiKey": "crs" }

验证环境变量设置

设置完环境变量后，可以通过以下命令验证是否设置成功：

在 PowerShell 中验证：

echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中验证：

echo %ANTHROPIC_BASE_URL% echo %ANTHROPIC_AUTH_TOKEN%

预期输出示例：

https://api.jdctools.com.cn cr_xxxxxxxxxxxxxxxxxx

💡 如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。

5

开始使用 Claude Code

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

启动 Claude Code
claude
在特定项目中使用
# 进入你的项目目录 cd C:\path\to\your\project # 启动 Claude Code claude

Windows 常见问题解决

安装时提示 "permission denied" 错误

这通常是权限问题，尝试以下解决方法：

  • 以管理员身份运行 PowerShell
  • 或者配置 npm 使用用户目录：npm config set prefix %APPDATA%\npm
PowerShell 执行策略错误

如果遇到执行策略限制，运行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
环境变量设置后不生效

设置永久环境变量后需要：

  • 重新启动 PowerShell 或 CMD
  • 或者注销并重新登录 Windows
  • 验证设置：echo $env:ANTHROPIC_BASE_URL
1

安装 Node.js 环境

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

方法一：使用 Homebrew（推荐）

如果你已经安装了 Homebrew，使用它安装 Node.js 会更方便：

# 更新 Homebrew brew update # 安装 Node.js brew install node
方法二：官网下载
  1. 访问 https://nodejs.org/
  2. 下载适合 macOS 的 LTS 版本
  3. 打开下载的 .pkg 文件
  4. 按照安装程序指引完成安装

macOS 注意事项

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

验证安装是否成功

安装完成后，打开 Terminal，输入以下命令：

node --version npm --version

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

2

安装 Claude Code

全局安装 Claude Code

打开 Terminal，运行以下命令：

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

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

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

验证 Claude Code 安装

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

claude --version

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

3

获取 API 密钥

在使用 Claude Code 之前，你需要先获取一个 API 密钥。

打开管理站点

在浏览器中访问以下地址：

https://api.jdctools.com.cn
创建令牌
  1. 登录后，在左侧菜单中找到 「令牌管理」
  2. 点击 「添加令牌」 按钮
  3. 在分组选项中选择 「Claude Code」 分组
  4. 填写令牌名称（如：我的 Mac）
  5. 点击确认创建令牌

保存你的密钥

创建成功后，系统会显示你的 API 密钥（以 cr_ 开头）。

⚠️ 重要：请立即复制并妥善保存这个密钥，它只会显示一次！

提示

  • 如果你还没有账号，请先注册或联系管理员获取
  • 一个令牌可以在多台设备上使用
  • 如果密钥丢失，可以删除旧令牌并创建新的
4

设置环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

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

在 Terminal 中运行以下命令：

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

💡 记得将 "你的API密钥" 替换为实际的密钥。

方法二：永久设置

编辑你的 shell 配置文件（根据你使用的 shell）：

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

VSCode Claude 插件配置

如果使用 VSCode 的 Claude 插件，需要在配置文件中进行设置：

配置文件位置：~/.claude/config.json

💡 如果该文件不存在，请手动创建。

{ "primaryApiKey": "crs" }
5

开始使用 Claude Code

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

启动 Claude Code
claude
在特定项目中使用
# 进入你的项目目录 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
macOS 安全设置阻止运行

如果系统阻止运行 Claude Code：

  • 打开"系统偏好设置" → "安全性与隐私"
  • 点击"仍要打开"或"允许"
  • 或者在 Terminal 中运行：sudo spctl --master-disable
环境变量不生效

检查以下几点：

  • 确认修改了正确的配置文件（.zshrc 或 .bash_profile）
  • 重新启动 Terminal
  • 验证设置：echo $ANTHROPIC_BASE_URL
1

安装 Node.js 环境

Claude Code 需要 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

打开终端，运行以下命令：

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

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

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

验证 Claude Code 安装

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

claude --version

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

3

获取 API 密钥

在使用 Claude Code 之前，你需要先获取一个 API 密钥。

打开管理站点

在浏览器中访问以下地址：

https://api.jdctools.com.cn
创建令牌
  1. 登录后，在左侧菜单中找到 「令牌管理」
  2. 点击 「添加令牌」 按钮
  3. 在分组选项中选择 「Claude Code」 分组
  4. 填写令牌名称（如：我的 Linux）
  5. 点击确认创建令牌

保存你的密钥

创建成功后，系统会显示你的 API 密钥（以 cr_ 开头）。

⚠️ 重要：请立即复制并妥善保存这个密钥，它只会显示一次！

提示

  • 如果你还没有账号，请先注册或联系管理员获取
  • 一个令牌可以在多台设备上使用
  • 如果密钥丢失，可以删除旧令牌并创建新的
4

设置环境变量

为了让 Claude Code 连接到你的中转服务，需要设置两个环境变量：

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

在终端中运行以下命令：

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

💡 记得将 "你的API密钥" 替换为实际的密钥。

方法二：永久设置

编辑你的 shell 配置文件：

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

开始使用 Claude Code

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

启动 Claude Code
claude
在特定项目中使用
# 进入你的项目目录 cd /path/to/your/project # 启动 Claude Code claude

Linux 常见问题解决

安装时提示权限错误

尝试以下解决方法：

  • 使用 sudo 安装：sudo npm install -g @anthropic-ai/claude-code
  • 或者配置 npm 使用用户目录：npm config set prefix ~/.npm-global
  • 然后添加到 PATH：export PATH=~/.npm-global/bin:$PATH
缺少依赖库

某些 Linux 发行版需要安装额外依赖：

# Ubuntu/Debian sudo apt install build-essential # CentOS/RHEL sudo dnf groupinstall "Development Tools"
环境变量不生效

检查以下几点：

  • 确认修改了正确的配置文件（.bashrc 或 .zshrc）
  • 重新启动终端或运行 source ~/.bashrc
  • 验证设置：echo $ANTHROPIC_BASE_URL

🎉 恭喜你！

你已经成功安装并配置了 Claude Code，现在可以开始享受 AI 编程助手带来的便利了。

如果在使用过程中遇到任何问题，可以扫描右侧二维码加入群聊获取帮助。