AI Coding 配置指南

Appearance

Claude Code 快速上手 ​

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

步骤一：安装 ​

安装 Git（按平台准备） ​

Windows 原生环境 ​

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

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

powershell
git --version

安装 Claude Code ​

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

bash
curl -fsSL https://claude.ai/install.sh | bash
powershell
irm https://claude.ai/install.ps1 | iex
cmd
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

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

bash
brew install --cask claude-code
powershell
winget install Anthropic.ClaudeCode

验证：

bash
claude --version

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

旧版 npm 安装残留处理 ​

当前不再推荐使用 npm 安装 Claude Code。若你之前参考过旧教程，先备份 ~/.claude，再清理旧的全局包，避免卸载时把历史会话和本地配置一起弄丢。

macOS / Linux ​

bash
if [ -d ~/.claude ]; then cp -r ~/.claude ~/.claude.backup; fi
npm list -g --depth=0

查看输出后，对名称中带 claude 的旧包逐个执行卸载。例如：

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

Windows ​

powershell
if (Test-Path "$env:USERPROFILE\.claude") { Copy-Item "$env:USERPROFILE\.claude" "$env:USERPROFILE\.claude.backup" -Recurse }
npm list -g --depth=0

查看输出后，对名称中带 claude 的旧包逐个执行卸载。例如：

powershell
npm uninstall -g @anthropic-ai/claude-code

步骤二：配置 API ​

使用 API 中转站与官方账号二选一。已有官方账号直接运行 claude 登录即可，无需以下配置。

本站默认使用 CC Switch 统一管理所有环境的 API 配置，无需再分别编辑工具配置文件。查看 CC Switch 统一配置 →

配置步骤：

  1. 打开 CC Switch，点击"添加配置"，框架选择 Claude Code
  2. 在预设供应商列表中点击 Neko（请求地址已自动填入）
  3. 填写 API Key（sk-xxx），并根据使用的分组确认 model
  4. 点击添加，应用后重启终端

Claude Code 只能使用 Claude 系列分组：max、特渠 或 kiro。codex / codex-pro 只能用于 Codex CLI 或 Codex 外接，不要配置到 Claude Code 里。

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

步骤三：启动 ​

bash
claude

常用命令 ​

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

支持的模型 ​

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

Claude Code 不支持使用 codex / codex-pro 分组。需要 GPT / Codex 线路时，请改用 Codex CLI。

下一步 ​

页面内容
CC Switch 统一配置默认配置入口、渠道与模型对应关系
配置参考手动配置文件、环境变量、其他安装方式
进阶配置CLAUDE.md、MCP 扩展、Hooks、自定义命令
推荐工具CC Switch、ZCF