跳到主要内容

Claude Code Windows 使用指南

推荐

建议使用 CC-Switch 可视化管理工具进行配置，无需手动编辑配置文件，一键完成 ByteCatCode 接入。

一、安装 Claude Code​

一键安装​

PowerShell：

irm https://claude.ai/install.ps1 | iex

CMD：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

npm 安装​

前置准备

npm 安装方式需要先完成 Node.js 环境安装。

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

验证 Claude Code 安装​

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

claude --version

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

更新 Claude Code​

运行：

claude update

window poweshell 安装特定版本​

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58 #←这里指定你想要安装的版本

更多高级安装指南参考官方相关中文文档：https://code.claude.com/docs/zh-CN/setup

二、配置 Claude Code​

方法一：通过文件设置​

在 C:\Users\你的用户名\.claude\ 目录下创建或编辑 settings.json，添加以下内容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://bytecat.lamclod.cn",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}
备选地址

如首选地址不可用，可替换为以下备选地址：

  • https://www.bytecatcode.org（优选CF，可直连，也可挂代理）
  • https://codecdn.bytecatcode.org（国内可直连）
  • https://code.bytecatcode.org（需挂代理访问）
字段说明
  • ANTHROPIC_AUTH_TOKEN：你在 ByteCatCode 控制台创建的 API 令牌（sk-开头）
  • ANTHROPIC_BASE_URL：请求地址
  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：禁用非必要的遥测请求，使用中转服务时建议开启

方法二：通过环境变量设置​

PowerShell 临时设置（当前会话）​

在 PowerShell 中运行以下命令：

$env:ANTHROPIC_BASE_URL = "https://bytecat.lamclod.cn"
$env:ANTHROPIC_AUTH_TOKEN = "你的API密钥"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

PowerShell 永久设置（用户级）​

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

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://bytecat.lamclod.cn", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的API密钥", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", [System.EnvironmentVariableTarget]::User)

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

验证环境变量​

PowerShell：

echo $env:ANTHROPIC_BASE_URL

CMD：

echo %ANTHROPIC_BASE_URL%

输出应为 https://bytecat.lamclod.cn，如果输出为空，请确认已重新打开终端窗口。

三、开始使用​

在项目目录下打开终端，输入 claude 即可启动。

常见问题​

安装时提示 "permission denied" 错误​

以管理员身份运行 PowerShell 重新执行安装命令。

PowerShell 执行策略错误​

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

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

环境变量设置后不生效​

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

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