Claude Code 命令行安装与使用指南

前言

Claude Code 是由 Anthropic 推出的 AI 编程助手，可以读取代码库、编辑文件、运行命令，并与开发工具集成。本文详细介绍其安装方法、基础使用以及如何切换到第三方 API（如 DeepSeek、阿里通义千问、智谱 GLM、MiniMax 等）。

安装 Claude Code

macOS / Linux / WSL

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

Windows PowerShell

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

注意：Windows 需要先安装 Git for Windows。

Windows CMD

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

其他安装方式

Homebrew（macOS/Linux）：brew install --cask claude-code
WinGet（Windows）：winget install Anthropic.ClaudeCode
npm：npm install -g @anthropic-ai/claude-code

快速开始

安装完成后，在任意项目目录下启动 Claude Code：

1 2	cd your-project claude

首次使用时会提示登录。登录后即可开始使用！

基础用法

# 直接在终端对话
claude

# 指定模型启动
claude --model deepseek-chat

# 非交互式管道用法
git diff main --name-only | claude -p "review these changed files for security issues"

# 单次任务
claude "write tests for the auth module, run them, and fix any failures"

交互式命令

进入 Claude Code 后可使用以下命令：

/model <model-name> - 切换模型
/help - 查看帮助
/config - 打开设置界面
/status - 查看当前状态

切换为第三方 API

Claude Code 支持配置第三方 API 作为后端，可以有效降低成本或使用特定模型。以下介绍几种主流方案。

方法一：通过环境变量配置

DeepSeek

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=${DEEPSEEK_API_KEY}
export ANTHROPIC_MODEL=deepseek-chat
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

DeepSeek API Key 获取地址：https://platform.deepseek.com/api_keys

智谱 GLM

1
2
3

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=your_zhipu_api_key
export ANTHROPIC_MODEL=glm4

智谱 API 获取地址：https://open.bigmodel.cn

方法二：通过配置文件配置

编辑 ~/.claude/settings.json（用户级）或项目 .claude/settings.json（项目级）。

阿里通义千问

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://coding.dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_MODEL": "qwen3-coder-plus"
  }
}

通义千问 API 获取地址：https://bailian.console.aliyun.com

智谱 GLM

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

方法三：通过云服务商

Amazon Bedrock

1 2	export CLAUDE_CODE_USE_BEDROCK=1 export AWS_REGION=us-east-1

Google Vertex AI

1
2
3

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5
export ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

Microsoft Foundry

1
2
3

export CLAUDE_CODE_USE_FOUNDRY=1
export ANTHROPIC_FOUNDRY_RESOURCE=your-resource
export ANTHROPIC_FOUNDRY_API_KEY=your-api-key

方法四：通过 CC Switch 配置（推荐）

CC Switch 是一个跨平台的桌面应用，可以管理多个 API 提供商的配置，支持 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具。它提供可视化界面，支持热切换、云端同步等功能。

安装 CC Switch

macOS：

1	brew tap farion1231/ccswitch && brew install --cask cc-switch

Windows：
从 GitHub Releases 下载 CC-Switch-v{version}-Windows.msi 或便携版 .zip

Linux：
下载 .deb、.rpm 或 .AppImage 文件

使用 CC Switch 配置 MiniMax

以 MiniMax 为例，介绍如何通过 CC Switch 配置第三方 API：

启动 CC Switch，点击 Add Provider
选择 MiniMax 预设或创建自定义配置
输入你的 MiniMax API Key
将所有模型名称改为 MiniMax-M2.7
点击 Enable 启用配置
编辑 ~/.claude.json，添加 "hasCompletedOnboarding": true

MiniMax 配置示例（手动方式）

如果你偏好手动配置，MiniMax 的 settings.json 配置如下：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.minimaxi.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "MINIMAX_API_KEY",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ANTHROPIC_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_SMALL_FAST_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "MiniMax-M2.7",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "MiniMax-M2.7"
  }
}

同时确保 ~/.claude.json 包含：

1
2
3

{
  "hasCompletedOnboarding": true
}

MiniMax API 文档：https://platform.minimaxi.com/docs/token-plan/claude-code

CC Switch 数据存储

数据库：~/.cc-switch/cc-switch.db（SQLite）
设置：~/.cc-switch/settings.json
备份：~/.cc-switch/backups/
Skills：~/.cc-switch/skills/

配置作用域说明

Claude Code 使用四级配置作用域，优先级从高到低：

作用域	位置	影响范围	共享性
Managed	系统托管配置	机器上所有用户	是（IT 部署）
Local	`.claude/settings.local.json`	仅本地当前仓库	否（gitignored）
Project	`.claude/settings.json`	仓库所有协作者	是（提交到 git）
User	`~/.claude/settings.json`	用户所有项目	否

优先级：Local > Project > User > Managed

企业级配置：代理与网关

如需通过企业代理访问，可设置：

1	export HTTPS_PROXY='https://proxy.example.com:8080'

常用命令参考

claude                    # 启动交互式会话
claude -p "任务描述"         # 单次任务执行
claude --model <model>     # 指定模型启动
/model <model>            # 交互中切换模型
/config                   # 打开设置界面
/status                   # 查看当前配置状态

参考链接

结语

Claude Code 作为一款强大的 AI 编程助手，通过配置第三方 API，可以灵活适配不同的使用场景和预算需求。CC Switch 等工具让多提供商管理更加便捷。希望本文能帮助你快速上手！

如果觉得有用，欢迎留言交流！