Skip to content

Claude Code 快速上手

本文档中,ccClaude Codeccs 指 CC Switch

三步完成从安装到使用:安装 → 配置 API → 启动。


步骤一:安装

安装 Git(按平台准备)

Windows 原生环境

Claude Code 在 Windows 原生环境下依赖 Git for Windows。

下载地址Git for Windows,全程默认选项安装。

powershell
git --version

安装 Claude Code

原生安装脚本为官方推荐方式,安装后会自动保持更新。

macOS / Linux / WSL

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

Windows PowerShell

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

Windows CMD

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

也可以使用包管理器安装:

Homebrew (macOS)

bash
brew install --cask claude-code

WinGet (Windows)

powershell
winget install Anthropic.ClaudeCode

或使用 npm 全局安装(全平台通用,安装后命令名为 claude):

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

验证:

bash
claude --version

Windows 原生环境需要先安装 Git for Windows;WSL 环境不需要。


步骤二:配置 API

先确认走哪条路

你的情况走哪条怎么做
已经有 Claude 官方账号且能正常 OAuth 登录官方账号直接 claude 启动,按提示登录,不用做下面的配置
没有官方账号 / 国内网络访问不稳定 / 想用 GPT / Gemini / 国产模型中转站 API Key继续看下面的配置

中转站 API Key 与官方账号互斥——同时配置会让 Claude Code 状态混乱。

用 CC Switch 配置(推荐)

本站默认使用 CC Switch 统一管理所有环境的 API 配置,无需手动编辑配置文件。完整步骤、Linux 安装方式见 CC Switch 统一配置

四步搞定:

  1. 打开 CC Switch,"添加配置",框架选 Claude Code
  2. 选择自定义配置,名称填写 Exact Relay,API 请求地址填写 https://exactrelay.com
  3. Exact Relay 令牌页面 创建并复制 API Key(sk-xxx),填入 CC Switch
  4. 点 "添加",启用供应商,然后重启终端

手动配置方式(settings.json / 环境变量)仅在排障或高级自定义时使用。


步骤三:启动

bash
claude

常用命令

命令说明
/model切换模型(opus / sonnet / haiku)
/model sonnet[1m]切换 1M 超长上下文版本
/cost查看当前令牌用量
/compact压缩上下文,释放空间
/resume恢复历史对话
/clear清空当前对话

支持的模型

模型适用场景
claude-opus复杂任务,能力最强
claude-sonnet日常开发,性能与成本平衡(推荐)
claude-haiku工具调用时自动切换,无需手动选择

下一步

页面内容
CC Switch 统一配置默认配置入口