Claude Code 快速上手

三步完成：安装 → 配置 API → 启动。

如果安装命令下不动 / 启动报 Connection refused，先看 网络自查三步。

步骤一：安装

准备 Git（Windows 原生环境需要）

Claude Code 在 Windows 原生环境下依赖 Git for Windows。 下载：Git for Windows，全程默认选项安装。 （WSL 环境不需要单独装。）

git --version

安装 Claude Code

macOS / Linux / WSL

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

Windows PowerShell

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

也可用包管理器：

# macOS
brew install --cask claude-code

# Windows
winget install Anthropic.ClaudeCode

# 全平台通用（npm）
npm install -g @anthropic-ai/claude-code

验证：

claude --version

步骤二：配置 API

先确认走哪条路

你的情况	走法
有 Claude 官方账号且能正常 OAuth 登录	直接 claude 启动登录，无需下面配置
没有官方账号 / 网络不稳 / 想用 GPT / 国产模型	用 KEK API Key，继续往下看

WARNING

中转站 API Key 与官方账号互斥，同时配置会让 Claude Code 状态混乱。 遇到登录冲突见 报错与踩坑。

用 CC Switch 配置（推荐）

四步搞定：

1. 打开 CC Switch，"添加配置"，框架选 Claude Code
2. 请求地址填 https://ai.kektoken.com
3. 填 API Key（sk-xxx），按所用分组确认 model
4. 点 "添加" → 重启终端

完整步骤见 CC Switch 统一配置。

TIP

用 vip2_cc 分组的，需把 model 改成 gpt-5.5 或其它 GPT 模型， 不能填 Claude 模型名。详见 CC Switch 渠道与模型对应。

手动配置（仅排障时用）

如果不用 CC Switch，可手动设置环境变量：

export ANTHROPIC_BASE_URL=https://ai.kektoken.com
export ANTHROPIC_AUTH_TOKEN=sk-你的密钥

步骤三：启动

claude

常用命令

命令	作用
/model	切换模型（opus / sonnet / haiku）
/model claude-opus-4-8	指定具体模型
/cost	查看当前用量
/compact	压缩上下文，释放空间
/resume	恢复历史对话
/clear	清空当前对话

支持的模型

模型	说明
claude-opus-4-8	复杂任务，能力最强
claude-sonnet-4-6	日常开发，性能/成本平衡（推荐）
claude-haiku-4-5	最快，工具调用时自动切换

完整模型清单见 令牌分组速查。

TIP

如果用的是 vip2_cc 分组，Claude Code 实际走 GPT 模型， 请在 CC Switch 中改用 gpt-5.5。

下一步

• Codex CLI 快速上手
• 令牌分组速查
• 报错与踩坑