Xu an's Web
0%

Claud code windows 配置指南

发表于 分类于 Valine：
cc改善生活

前置要求

依赖项 最低版本 说明
Node.js 18.x 及以上 运行环境
npm 随 Node.js 安装 包管理器
Git 任意版本 可选，代码管理
Anthropic API Key — 必须提前申请

一、安装 Node.js

  1. 访问 https://nodejs.org，下载 LTS 版本安装包
  2. 运行安装程序，全程点击 Next，保持默认选项
  3. 安装完成后，打开 PowerShell 或 CMD 验证：
1
2
node -v
npm -v

二、安装 Claude Code

打开 PowerShell（管理员） 或 CMD，执行：

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

验证安装成功：

1
claude --version

三、配置 API Key

方式一：环境变量（推荐）

临时设置（当前会话有效）：

1
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxxxxxxxxxx"

永久设置（系统级）：

  1. 按 Win + S 搜索"环境变量"
  2. 点击 "编辑系统环境变量"
  3. 点击 "环境变量" 按钮
  4. 在"用户变量"中点击 "新建"
    • 变量名：ANTHROPIC_API_KEY
    • 变量值：sk-ant-xxxxxxxxxxxxxxxx
  5. 点击确定保存，重启终端生效

方式二：登录命令

1
claude

首次运行会引导你输入 API Key，自动保存到配置文件。

四、首次运行

1
2
3
4
5
# 进入你的项目目录
cd D:\your-project

# 启动 Claude Code
claude

或直接带任务启动：

1
claude "帮我解释这个项目的结构"

五、常用命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 交互式对话
claude

# 执行单次任务
claude "帮我写一个 README"

# 查看帮助
claude --help

# 查看版本
claude --version

# 更新到最新版本
npm update -g @anthropic-ai/claude-code

六、使用 cc-switch 管理配置

cc-switch 是一个跨平台桌面工具，支持通过统一界面管理 Claude Code、Codex、Gemini CLI 等多个 CLI 工具的配置，无需手动编辑配置文件。

安装

前往 GitHub Releases 页面下载 Windows 安装包：

https://github.com/farion1231/cc-switch/releases

文件名 说明
CC-Switch-vX.X.X-Windows.msi 标准安装版（推荐）
CC-Switch-vX.X.X-Windows-Portable.zip 免安装便携版

下载后双击 .msi 安装，或解压 .zip 直接运行。

主要功能

功能 说明
50+ 供应商预设 一键切换 API 提供商（官方、第三方中转、AWS Bedrock 等）
统一 MCP 管理 跨应用同步 MCP / Prompts / Skills 配置
系统托盘快切 无需打开主界面，托盘直接切换 Provider
云同步 支持 OneDrive、Dropbox、WebDAV 等同步配置
用量追踪 可视化 Token 消耗、费用与请求趋势
会话管理 浏览和恢复各工具的历史对话

基本使用流程

  1. 打开 cc-switch，点击 "Add Provider"
  2. 选择内置预设（如官方 Claude、第三方中转）或手动填写自定义配置
  3. 点击切换目标 Provider（或通过系统托盘快速切换）
  4. 重启终端使配置生效（Claude Code 支持热切换，无需重启）

恢复官方登录

如需切回 Anthropic 官方账号：

  1. 在 cc-switch 中添加 官方预设
  2. 切换至该 Provider
  3. 在终端执行 claude 完成 OAuth 登录授权

Windows 注意事项

  • 安装时若出现 SmartScreen 警告，点击 "更多信息" → "仍要运行" 即可
  • v3.9.1 起已修复 Windows 下 npx/npm 命令兼容性问题（通过 cmd /c 包装）
  • 默认代理端口为 15721（旧版为 5000，如有冲突请检查端口占用）

七、IDE 集成

VS Code

  1. 安装 VS Code 插件：搜索 Claude Code
  2. 在设置中填入 API Key
  3. 使用 Ctrl + Shift + P 呼出命令面板，搜索 Claude

终端推荐

Windows 下推荐使用以下终端以获得最佳体验：

  • Windows Terminal（推荐）
  • PowerShell 7+
  • Git Bash

⚠️ 不推荐使用老版 CMD，可能存在字符编码问题

八、配置文件

Claude Code 的配置文件路径：

1
2
3
C:\Users\<用户名>\.claude\
├── settings.json       # 全局配置
└── projects\           # 项目记忆目录

settings.json 示例：

1
2
3
4
5
{
  "model": "claude-opus-4-6",
  "theme": "dark",
  "autoApprove": false
}

九、常见问题

Q: 提示 claude 命令不存在？

检查 npm 全局路径是否在 PATH 中：

1
npm config get prefix

将输出路径（如 C:\Users\xxx\AppData\Roaming\npm）添加到系统环境变量 PATH 中。

Q: API Key 无效？

  • 确认 Key 以 sk-ant- 开头
  • 检查账户余额是否充足
  • 确认没有多余的空格或换行符

Q: 中文乱码？

在 PowerShell 中执行：

1
2
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
chcp 65001

或在 Windows Terminal 设置中将默认编码改为 UTF-8。

Q: 网络连接问题？

如需代理，设置环境变量：

1
2
$env:HTTPS_PROXY = "http://127.0.0.1:7890"
$env:HTTP_PROXY  = "http://127.0.0.1:7890"

十、卸载

1
npm uninstall -g @anthropic-ai/claude-code

如需清除配置文件：

1
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude"

参考链接

  • 官方文档：https://docs.anthropic.com/claude-code
  • API Key 申请：https://console.anthropic.com
  • GitHub Issues：https://github.com/anthropics/claude-code/issues