ClaudeCode安装指南

安装ClaudeCode本体

搜索命令提示符，打开。

在光标处粘贴以下指令并回车：

winget install Anthropic.ClaudeCode   # Windows系统

npm install-g @anthropic-ai/claude-code   # macOS / Linux / Windows系统

• winget 仅限 Windows系统。
• npm 方式需要先安装 Node.js（建议 18+ 版本）。

等待执行执行完成后，claude就安装好了。

在光标处输入用 claude --version 并回车验证。出现以下内容则安装成功。

修改配置

Claude Code 首次启动会检测账号区域。

在配置文件中添加 hasCompletedOnboarding 字段可跳过此检查。

配置文件路径：

如果文件不存在，先运行一次 claude 让其自动生成，再退出编辑。

找到 "changelogLastFetched" 字段，在其下一行添加：

"hasCompletedOnboarding":true,

示例：

{  "changelogLastFetched":"2025-05-25T00:00:00.000Z",  "hasCompletedOnboarding":true,  ...}

保存后重新运行 claude 即可进入。

二、CC Switch 安装

CC Switch 通过拦截 Claude Code 的 API 请求并将其转发到第三方 API 端点，实现模型的自由切换。它提供了一个图形界面来管理多个 API 配置，无需手动修改环境变量。

下载地址：github开源项目，或后台发送“cc”获取。

• Windows 下载 .exe 安装包。
• macOS 下载 .dmg 文件。

安装完成界面：

启动后，点击右上角的"添加"创建新配置，填写以下两项：

• 中转站域名：API 服务提供商的端点地址。
• API Key：在对应平台生成的密钥。

配置完成后，在 CC Switch 中选中该配置即可生效。Claude Code 的 /model 命令将列出该 API 支持的模型。

三、API 购买

在以下平台注册并创建 API Key：

将获取的 API Key 和对应端点填入 CC Switch 即可。

中转站说明

如果你使用的是 API 代理/聚合服务（如 OpenRouter、API2D 等），它们会提供统一的中转域名，填入该域名后即可同时访问多个后端模型。

四、使用Claude Code

安装完毕后，在终端输入 claude 启动。Claude Code 作为 CLI 工具，可在任意终端的任意 IDE 中使用，无需额外安装插件。

常用命令：

• /resume — 继续之前的对话。
• /btw — 在对话中插入一个临时问题，不打断当前上下文，也不会留下记录。
• /model — 切换模型。可用模型取决于 CC Switch 中当前选中 API 提供的能力；有 Opus 时建议优先使用。
• /rename — 重命名当前对话。未重命名时，标题默认为首次提问的内容。
• /add-dir — 加载工作目录，Claude 的上下文将包含该目录中的所有文件。可多次使用加载多个目录。
• /copy — 复制最近一次回答。/copy 3 复制倒数第三次回答。
• /clear — 清除当前对话历史，开始新对话。
• /doctor — 运行诊断，检查安装和环境配置是否正确。
• /help — 列出所有可用命令。

五、更新

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

winget upgrade Anthropic.ClaudeCode

CC Switch 在 GitHub Releases 页面下载最新版本覆盖安装即可。

六、常见问题

• claude 命令无法识别：检查 Node.js 是否已安装且 npm 全局路径是否在 PATH 环境变量中。
• CC Switch 配置后 Claude Code 仍无法使用：确认 CC Switch 正在运行且已选中目标配置；确认 API Key 有效且额度未耗尽。
• 若还有其他问题，欢迎留言。