Claude Code 快速上手

本文档中，cc 指 Claude Code，ccs 指 CC Switch。

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

如果安装命令下不动 / 启动报 ConnectionRefused，先看网络自查。首次配置也可以直接走 简易模式。

步骤一：安装

安装 Git（按平台准备）

Windows 原生环境

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

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

git --version

安装 Claude Code

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

macOS / Linux / WSL

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

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

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

Homebrew (macOS)

brew install --cask claude-code

WinGet (Windows)

winget install Anthropic.ClaudeCode

或使用 npm 全局安装（全平台通用，安装后命令名为 claude）：

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

验证：

claude --version

Windows 原生环境需要先安装 Git for Windows；WSL 环境不需要。完整说明见 配置参考。

步骤二：配置 API

使用前请关闭 CC Switch 的路由模式；保存后直接打开 Claude Code 发消息验证，不要依赖 CCS 的「检测」按钮。查看完整提醒。

先确认走哪条路

你的情况	走哪条	怎么做
已经有 Claude 官方账号且能正常 OAuth 登录	官方账号	直接 claude 启动，按提示登录，不用做下面的配置
没有官方账号 / 国内网络访问不稳定 / 想用更低价格	Vmvia API Key	继续看下面的配置

中转 API Key 与官方账号互斥，同时配置会让 Claude Code 状态混乱，遇到这种情况见 CC-018：OAuth 登录冲突。

准备令牌

1. 打开 模型广场，用「分组」筛选 cc_max，确认可用的 Claude 模型。
2. 在 控制台 · 令牌 新建令牌，分组选 cc_max，关闭「模型限制」。
3. 复制 API Key 备用。

cc_max 只接受 Claude Code 客户端内部调用，倍率 1.8x。要在 IDE 或其他第三方客户端外接 Claude，请另建 sale_kiro 分组的令牌，见 外接兼容说明。

用 CC Switch 配置（推荐）

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

五步搞定：

1. 打开 CC Switch，「添加配置」，框架选 Claude Code。
2. 预设供应商选 「自定义配置」，名称填 Vmvia。
3. 请求地址填 https://www.vmvia.com（不带 /v1）。
4. 填 API Key（sk-xxx），模型留空使用 Claude 默认模型。
5. 点「添加」并启用 → 重启终端。

手动配置方式（settings.json / 环境变量）仅在排障或高级自定义时使用，见 配置参考。

步骤三：启动

claude

常用命令

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

支持的模型

cc_max 分组当前包含以下系列，完整列表与价格见 分组速查：

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

下一步

页面	内容
CC Switch 统一配置	默认配置入口、分组与模型对应关系
配置参考	手动配置文件、环境变量、其他安装方式
进阶配置	CLAUDE.md、MCP 扩展、Hooks、自定义命令
桌面版接入	在 Claude 桌面客户端里使用 Vmvia