前言

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，直接在终端里运行。和 Copilot 的补全模式不同，Claude Code 是对话式的——你告诉它要做什么，它读你的代码、写修改、跑命令，像一个在终端里随时待命的结对程序员。

CCSwitch 是社区开发的一个配置管理工具，用来解决 Claude Code 的多账号切换、Token 管理、模型选择等问题。

一、Claude Code 安装

前提条件

  • Node.js >= 18
  • 一个 Anthropic API Key（console.anthropic.com 申请）或者 Claude 订阅账号的 Token

安装

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

验证：

1
claude --version

初始化配置

1
2
3
4
5
6
# 方式一：用 API Key（按量计费）
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxx

# 方式二：用 Claude 订阅账号的 OAuth Token
claude login
# 这会打开浏览器，登录你的 Anthropic 账号，授权 CLI 访问

首次使用建议先跑一个简单任务验证一切正常：

1
claude -p "解释当前目录是做什么的" --allowedTools "Read Bash"

-p 是非交互模式，问完就退出，适合快速测试。

二、基本用法

交互模式

1
2
3
4
5
6
7
8
# 进入交互对话
claude

# 指定工作目录
claude --workspace /path/to/project

# 带上初始 prompt
claude --workspace ~/myproject "帮我重构这个项目的目录结构"

进入交互模式后，用法和 ChatGPT 网页版类似——描述你要做什么，Claude 会读代码、提方案、写代码、跑命令。

非交互模式（自动化/脚本使用）

1
2
3
4
5
6
7
8
# 一句话任务（-p = print，输出到 stdout 后退出）
claude -p "给所有 .ts 文件添加 JSDoc 注释"

# 从管道读取
cat error.log | claude -p "分析这些错误日志，找出根因"

# 指定可以用的工具
claude -p "检查项目安全漏洞" --allowedTools "Read Bash WebSearch"

日常使用中最常用的场景

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 代码审查
claude -p "审查 src/ 目录下最近的改动，找出潜在 bug"

# 生成 commit message
git diff | claude -p "生成一条简洁的 commit message"

# 解释代码
claude -p "解释 src/auth/login.ts 的逻辑"

# 写测试
claude -p "给 src/utils/ 下的工具函数补充单元测试"

# 重构
claude -p "把 src/services/ 里的回调改成 async/await"

三、权限控制（–allowedTools）

Claude Code 可以读写文件、执行命令、搜索网页。默认情况下有些操作需要你手动确认。可以通过 --allowedTools 控制权限范围：

1
2
3
4
5
6
7
8
# 只读模式（不让改文件）
claude --allowedTools "Read Grep Glob"

# 允许读写和 bash
claude --allowedTools "Read Write Bash"

# 允许所有（包括 WebSearch、WebFetch）
claude --allowedTools "Read Write Bash WebSearch WebFetch"

交互模式下也可以在对话中动态授权——Claude 每次执行高风险操作前会弹确认。

四、管理多账号与多 Profile 配置

在日常开发中，如果你同时拥有公司账号（API Key 按量计费）与个人账号（Claude Pro 订阅的 OAuth Token），或者需要隔离不同项目的对话历史和配置，多账号切换就成了刚需。

方案 1：官方原生环境隔离（最推荐，零依赖）

Claude Code 的所有配置和会话历史默认保存在用户的家目录下。你可以通过指定 CLAUDE_CONFIG_DIR 环境变量 来实现配置目录的物理隔离，从而在终端中完美切换不同的 Profile。

1. 创建不同的隔离目录

1
2
3
# 创建工作账号和个人账号的隔离配置目录
mkdir -p ~/.claude-work
mkdir -p ~/.claude-personal

2. 在 Shell 配置文件中设置别名（Alias）

打开你的 Shell 配置文件（如 ~/.bashrc 或 ~/.zshrc），添加以下内容：

1
2
3
4
5
# 使用工作账号（API Key 方式）
alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work ANTHROPIC_API_KEY=sk-ant-work-xxxx claude'

# 使用个人订阅账号（首次使用需跑 claude-personal login 登录授权）
alias claude-personal='CLAUDE_CONFIG_DIR=~/.claude-personal claude'

3. 快速启动

配置生效后，在终端中直接运行：

  • claude-work：使用工作账号环境（会话历史、设置均隔离在 ~/.claude-work）。
  • claude-personal：使用个人账号环境（会话历史、设置均隔离在 ~/.claude-personal）。

方案 2：使用 CC Switch (桌面 GUI 管理工具)

如果你更习惯图形化操作，可以使用开源社区的 CC Switch（GitHub 地址：farion1231/cc-switch）。

1. 软件定位

CC Switch 是一个基于 Tauri 开发的跨平台桌面应用（支持 Windows、macOS 和 Linux），它作为 AI 编程辅助工具的“中转控制中心”，能够集中管理包括 Claude Code、OpenClaw、Gemini CLI 等在内的各种 CLI 配置。

2. 核心功能

  • 一键热切换：在界面中一键切换 50+ 种 AI 预设通道或自定义 API 代理，无需重启终端。
  • 可视化 MCP 管理：无需手动修改 JSON 配置文件，在 GUI 中直观增删和配置 Model Context Protocol 服务的参数和环境变量。
  • 延迟与成本监控：内置测速与 Token 消耗、成本折线图统计。

3. 安装方法

  • macOS: brew install --cask cc-switch
  • Windows / Linux: 前往 GitHub Releases 页面下载对应的安装包。

方案 3：社区第三方 CLI 切换工具

如果你喜欢命令行形式的账户切换，可以使用社区开发者封装的第三方 npm 包，如 @kaitranntt/ccs (Claude Code Switch)。

1. 安装

1
npm install -g @kaitranntt/ccs

2. 使用

1
2
3
4
5
6
7
8
9
10
11
# 添加配置环境 (如工作环境)
ccs add work --api-key sk-ant-work-xxxx

# 添加个人 OAuth 授权环境
ccs add personal --oauth

# 列表展示
ccs list

# 切换当前激活环境
ccs use work

💡 补充：按项目绑定上下文（CLAUDE.md）

除了多账号切换，Claude Code 还支持在项目根目录下放置一个 CLAUDE.md 文件。它是 Claude Code 的“项目记忆文件”，当你进入该目录启动 claude 时，它会自动加载此文件中的上下文和开发规范：

1
2
3
4
5
6
7
8
9
10
11
12
# CLAUDE.md (项目开发规范建议)

## 运行与测试命令
- 构建项目: `npm run build`
- 运行测试: `npm run test`
- 单文件测试: `npm run test -- <path>`

## 技术栈与设计原则
- 这是一个基于 Next.js 14 (App Router) 的项目
- 样式使用 CSS Modules，严禁在此项目中使用 Tailwind
- 数据库使用 Prisma ORM
- 所有 API 请求必须处理异常并返回统一的 JSON 格式

CLAUDE.md 是 Claude Code 的项目记忆文件，进入项目目录后会自动加载上下文。

五、实战场景

场景 1：接手一个新项目，快速熟悉代码

1
2
3
4
5
6
cd new-project
claude "帮我理解这个项目的结构。请分析：
1. 目录结构是干什么的
2. 主要技术栈
3. 入口文件在哪
4. 数据流是怎么走的"

场景 2：修一个 Bug

1
claude -p "src/services/order.ts 里的 createOrder 函数，当库存为 0 时会报 500 错误而不是返回提示。请找到问题并修复。"

Claude 会自己去读文件、找到 Bug、写修改、甚至可以帮你跑测试验证。

场景 3：批量重命名

1
claude -p "把 src/components/ 下所有 .jsx 文件重命名为 .tsx，并把里面的 PropTypes 改成 TypeScript 类型"

场景 4：生成变更总结

1
git diff --stat | claude -p "根据这些变更统计，写一段项目周报"

场景 5：写 GitHub Actions 配置

1
claude -p "给这个 Node.js 项目写一个 GitHub Actions 配置：在 push 时跑 lint 和 test，在 tag 时构建 Docker 镜像并推送"

六、常用命令速查

命令 作用
claude 进入交互模式
claude -p "任务" 执行一次任务并退出
claude --workspace /path 指定工作目录
claude --allowedTools "..." 限制可用工具
claude --model opus 指定模型（opus/sonnet/haiku）
claude login OAuth 登录
claude mcp list 列出已连接的 MCP 服务
/clear 清除对话上下文（交互模式内）
/help 查看帮助（交互模式内）
Ctrl+C 中断当前操作

七、和 Copilot / Cursor 的区别

Claude Code GitHub Copilot Cursor
运行方式 终端 CLI IDE 插件 IDE（独立编辑器）
交互模式 对话式 补全式 对话+补全
能执行命令吗 可以 不行 可以（受限）
能读写文件吗 可以 不行（只能补全） 可以
适用场景 重任务（重构、Debug） 轻任务（写代码行） 中重度任务
价格 API 按量 / 订阅 $20 订阅 $10/月 订阅 $20/月

Claude Code 的强项在于可以自己跑命令看输出、根据结果继续调整。Copilot 适合在写代码的时候帮你补全和联想。两者互补，不是一个替代另一个的关系。

Claude Code 现在还是早期阶段，API 和命令格式可能会有调整。遇到报错先 claude --help 确认当前版本的命令格式，或去 docs.anthropic.com 查最新文档。