安装与配置

1. 安装 Git（前置依赖）

Claude Code 依赖 Git 进行版本管理。安装 Claude Code 之前必须先装好 Git，以下按平台说明。

平台	安装方式
macOS	`xcode-select --install`（系统自带提示）或 `brew install git`
Windows	从 git-scm.com 下载安装包，按默认选项安装
Linux	`sudo apt install git`（Debian/Ubuntu）或 `sudo dnf install git`（Fedora）

安装后验证：


git --version

2. 安装 Claude Code

官方提供三种安装方式，推荐使用原生安装脚本（自动更新）。

如果下载失败或超时，可能需要先配置代理，见下方常见问题 — 网络代理配置。

方式一：原生安装脚本（推荐）

安装后会自动在后台更新，始终保持最新版本。

macOS / Linux / WSL：


curl -fsSL https://claude.ai/install.sh | bash

macOS 安装 Claude Code — macOS / Linux 终端执行原生安装脚本

Windows PowerShell：


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

Windows CMD：


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

Windows 安装 Claude Code — Windows PowerShell 执行安装脚本

方式二：Homebrew（macOS）


brew install --cask claude-code

Homebrew 安装不会自动更新，需定期执行 brew upgrade claude-code 获取最新版本。

方式三：WinGet（Windows）


winget install Anthropic.ClaudeCode

WinGet 安装不会自动更新，需定期执行 winget upgrade Anthropic.ClaudeCode 获取最新版本。

安装后 `claude` 命令找不到（Windows）

如果安装后 claude 命令无法识别，需要将安装目录加入系统 PATH：

找到安装路径（默认在 %USERPROFILE%\.claude 或安装脚本提示的路径）
右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
在 Path 中点击「新建」，粘贴安装目录路径
重新打开终端后再试

验证安装

所有平台安装完成后，打开一个新的终端窗口，执行：


claude --version
claude --help

验证安装 — 执行 claude --version 和 claude --help 确认安装成功

首次运行 claude 会引导你配置 API Key。

3. API Key 配置

Claude Code 通过 API Key 连接 AI 模型。可以手动编辑配置文件，也可以使用 cc-switch 图形化管理（见下一节）。

配置文件位置

平台	路径
macOS / Linux	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

配置示例


{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的 API Key",
    "ANTHROPIC_BASE_URL": "https://api.anthropic.com"
  }
}

如果使用第三方兼容 API（如 Kimi、智谱等国内模型服务），将 ANTHROPIC_BASE_URL 替换为对应的 API 地址即可：


{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的第三方 API Key",
    "ANTHROPIC_BASE_URL": "https://第三方服务地址/api"
  }
}

只有一个 API Key 时，手动编辑配置文件就够了。如果有多个 Key 需要频繁切换，推荐使用 cc-switch。

4. cc-switch：多密钥管理

为什么需要 cc-switch

Claude Code 原生只支持配置一个 API Key。实际使用中你可能有多个需求：

场景	说明
多个 API 供应商	同时使用 Anthropic、Kimi、智谱等不同供应商
多个账号	个人账号和团队账号切换
费用控制	不同 Key 分配给不同用途，方便管控额度
故障切换	某个供应商不可用时快速切到备用

cc-switch 提供图形界面，让你配置多个 API Key 并自动热切换，不需要手动编辑配置文件。

安装 cc-switch

从 cc-switch GitHub Releases 下载最新版本：

平台	安装包
Windows	`CC-Switch-v{版本}-Windows.msi`（安装版）或 `CC-Switch-v{版本}-Windows-Portable.zip`（免安装版）
macOS	`CC-Switch-v{版本}-macOS.dmg`
Linux	`CC-Switch-v{版本}-Linux.AppImage`

具体可用平台以 Releases 页面实际发布为准。

cc-switch Releases — cc-switch GitHub Releases 页面：下载对应平台安装包

配置供应商

打开 cc-switch，点击 ➕ 添加供应商：

填写供应商名称（如 anthropic、kimi-k2.5、zhipu）
填入 API Key
设置请求地址（不同供应商地址不同）

常见供应商配置参考：

供应商	请求地址
Anthropic 官方	`https://api.anthropic.com`
Kimi K2.5	`https://api.kimi.com/coding/`
智谱 GLM	`https://open.bigmodel.cn/api/anthropic`

cc-switch 添加供应商 — 添加供应商：填写名称、API Key 和请求地址

配置完成后，cc-switch 会自动管理 Claude Code 的 API 连接，在多个 Key 之间进行热切换。

详细使用文档见 cc-switch 中文说明。

5. 系统通知（Hooks）

Hooks 可以让 Claude Code 在需要你输入或任务完成时发送系统通知，避免切走后错过消息。

将以下配置加入 ~/.claude/settings.json（与 env 同级）。

Claude Code 提供两个环境变量供 Hooks 使用：

CLAUDE_CODE_ENTRYPOINT：当前使用的 IDE 或编辑器
CLAUDE_PROJECT_DIR：当前项目目录路径

macOS


{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"需要您的输入确认...\" with title \"'\"$CLAUDE_CODE_ENTRYPOINT: $(basename $CLAUDE_PROJECT_DIR)\"'\"'"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "osascript -e 'display notification \"已完成，请检查结果\" with title \"'\"$CLAUDE_CODE_ENTRYPOINT: $(basename $CLAUDE_PROJECT_DIR)\"'\"'"
          }
        ]
      }
    ]
  }
}

首次使用需要授予终端通知权限：「系统设置」→「通知」→ 找到「终端」→ 允许通知。

Windows

Windows 可以使用 PowerShell 的 Toast 通知。推荐先安装 BurntToast 模块：


Install-Module -Name BurntToast -Force

然后配置 Hooks：


{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell -Command \"New-BurntToastNotification -Text 'Claude Code', '需要您的输入确认'\""
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell -Command \"New-BurntToastNotification -Text 'Claude Code', '任务已完成，请检查结果'\""
          }
        ]
      }
    ]
  }
}

如果不想安装额外模块，也可以用基础的 MessageBox（会弹出对话框）：


{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "powershell -Command \"Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show('需要您的输入确认', 'Claude Code')\""
          }
        ]
      }
    ]
  }
}

Linux


{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' '需要您的输入确认 - 项目: $CLAUDE_PROJECT_DIR' --icon=dialog-information"
          }
        ]
      }
    ],
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "notify-send 'Claude Code' '任务完成 - IDE: $CLAUDE_CODE_ENTRYPOINT' --icon=info"
          }
        ]
      }
    ]
  }
}

Linux 需要先安装通知服务：


# Debian / Ubuntu
sudo apt install libnotify-bin
 
# Fedora / RHEL
sudo dnf install libnotify

6. IDE 集成

Claude Code 除了在终端独立使用，还可以集成到 VS Code 和 Cursor 中，提供图形化的交互体验。

VS Code 插件

打开 VS Code，点击左侧「扩展」图标
搜索 Claude Code 并安装
安装后点击侧边栏的 Claude Code 图标即可开始对话

VS Code 安装 Claude Code — VS Code 扩展市场搜索并安装 Claude Code 插件

在对话框中输入 /settings 可以查看和调整设置。

VS Code 中 Claude Code 对话 — VS Code 中 Claude Code 插件的对话界面

Cursor

Cursor 内置终端可直接运行 claude 命令。Cursor 本身也支持 MCP 配置，可以通过 .cursor/mcp.json 连接 Signal Skills，详见快速开始。

插件名称	用途
简体中文	VS Code 界面中文化
Markdown All in One	预览 AI 生成的 Markdown 分析报告
Live Server	本地预览 HTML 可视化报告
Rainbow CSV	高亮查看数据导出的 CSV 文件
GitLens / Git Graph	查看 Claude Code 的提交历史和分支

7. 连接 Signal Skills

安装和配置完成后，将 Claude Code 与 Signal Skills 技能包连接起来。

配置步骤

下载 Signal Skills 技能包并解压
在用户后台创建 API Key（详见快速开始 — API Key 获取）
将包内的 .mcp.json.example 复制为 .mcp.json，填入实际的 Feed 服务地址和 API Key：


{
  "mcpServers": {
    "trade-signal": {
      "type": "http",
      "url": "http://your-feed-server/mcp",
      "headers": {
        "x-api-key": "你的 API Key"
      }
    }
  }
}

用 Claude Code 打开技能包目录——它会自动读取 CLAUDE.md 入口文件，加载全部技能和 AI Soul
开始对话，直接提问即可

完整配置说明见快速开始。

附：常见问题

`claude` 命令找不到

安装后终端无法识别 claude 命令，通常是 PATH 未配置。

平台	解决方式
macOS / Linux	检查 `~/.zshrc` 或 `~/.bashrc` 中是否包含安装路径，修改后执行 `source ~/.zshrc` 生效
Windows	见上方安装后 claude 命令找不到

Windows 用户是否需要 WSL

不需要。Claude Code 原生支持 Windows + PowerShell，Signal Skills 的所有功能在 Windows 上都可正常使用。

如果你已经在用 WSL 或有 Linux 环境需求，也可以在 WSL 内使用 Claude Code：

在 VS Code 中安装 Remote - WSL 插件
在 WSL 终端中进入项目目录，执行 code . 打开 VS Code
Claude Code 和 Signal Skills 在 WSL 环境中同样可用

网络代理配置

如果你的网络环境需要代理才能访问 Anthropic API，需要配置 HTTP 代理。

macOS / Linux

在终端启动前设置，或写入 ~/.zshrc（~/.bashrc）：


export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"

Windows PowerShell

每次打开 PowerShell 时设置，或写入 $PROFILE 文件：


$Env:HTTP_PROXY="http://127.0.0.1:7890"
$Env:HTTPS_PROXY="http://127.0.0.1:7890"

端口号 7890 以你本地代理工具的实际端口为准。如果使用第三方兼容 API（如 Kimi、智谱），通常不需要代理。

API 请求超时

如果 API 服务响应较慢，可以在 settings.json 中调大超时时间：


{
  "env": {
    "API_TIMEOUT_MS": "300000"
  }
}

cc-switch 和手动配置冲突吗

不冲突。cc-switch 本质上是帮你管理 settings.json 中的 API 配置。启用 cc-switch 后，它会接管 API Key 的切换，你不需要再手动编辑配置文件中的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL。

附：快速检查清单

安装配置完成后，逐项确认：

Git：终端执行 git --version 有输出
Claude Code：终端执行 claude --version 有输出
API Key：首次运行 claude 后可以正常对话
cc-switch（可选）：已添加至少一个供应商，切换正常
系统通知（可选）：Hooks 配置后能收到通知
IDE 插件（可选）：VS Code / Cursor 中 Claude Code 可用
Signal Skills：MCP 配置完成，对话中可以查询数据

← 简介配置 Signal Skills →