Claude Code CLI 使用指南：安装、DeepSeek API 替换与可视化

尘风
AI
2026-06-24
138热度
0评论

适用环境：Windows / macOS / Linux（本文以 Windows PowerShell 为主）
实战场景：终端 AI 编程助手、低成本替代官方 API、IDE 可视化协作
本文目标：从零安装 Claude Code CLI，用 DeepSeek API 替换 Anthropic 官方接口，并掌握多种可视化工作流

1. Claude Code 是什么？

Claude Code 是 Anthropic 推出的 Agent 式终端编程助手。它不仅能聊天，还能：

读取、搜索、编辑本地代码库
在终端执行 Shell 命令、运行测试
操作 Git（提交、建分支、解决冲突）
通过 MCP 连接外部工具（数据库、浏览器、API 等）

与 Cursor / Copilot 等 IDE 内嵌助手不同，Claude Code 以 CLI 为核心，遵循 Unix 哲学——可管道化、可脚本化、可接入 CI。

1.1 五种使用界面

界面	入口	适合场景
终端 CLI	`claude`	功能最全、自动化、SSH、CI/CD
VS Code / Cursor 扩展	扩展市场搜索 "Claude Code"	内联 diff、@-mention 文件
Desktop 桌面应用	claude.ai/download	可视化 diff、多会话、定时任务
Web	claude.ai/code	无需本地安装、云端会话
JetBrains 插件	JetBrains Marketplace	IntelliJ 生态用户

本文重点：终端 CLI + DeepSeek API + 可视化扩展。CLI 是唯一完整支持第三方 API 提供商（含 DeepSeek）的界面之一。

2. 安装 Claude Code CLI

2.1 系统要求

终端（PowerShell、CMD、WSL、macOS Terminal 等）
Windows 用户建议安装 Git for Windows（提供 Bash 工具支持；未安装时回退到 PowerShell）
Node.js 18+（仅 npm 安装方式需要）

2.2 安装方式（任选其一）

方式 A：原生安装（推荐，自动更新）

Windows PowerShell：

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

macOS / Linux / WSL：

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

方式 B：WinGet

winget install Anthropic.ClaudeCode

方式 C：npm（需 Node.js 18+）

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

方式 D：Homebrew（macOS）

brew install --cask claude-code        # stable 通道
brew install --cask claude-code@latest # latest 通道

2.3 验证安装

claude --version

看到版本号即安装成功。

3. 官方认证方式（可选）

若使用 Anthropic 官方服务，首次运行 claude 会提示登录：

账户类型	说明
Claude Pro / Max / Team / Enterprise	订阅制，推荐个人用户
Claude Console	按量付费 API，自动创建 "Claude Code" 工作区
Bedrock / Vertex / Foundry	企业云提供商

会话内可用 /login 切换账户。凭证会本地缓存，无需每次登录。

若使用 DeepSeek API（下一节），可跳过官方 OAuth 登录，直接用 API Key 认证。

4. 用 DeepSeek API 替换官方接口

DeepSeek 提供 Anthropic 兼容端点，Claude Code 无需代理即可直连，成本通常远低于官方 API。

4.1 获取 API Key

访问 DeepSeek 开放平台
注册并创建 API Key
妥善保存 Key（只显示一次）

4.2 模型映射关系

DeepSeek 会自动将 Claude 模型名映射到自家模型：

Claude Code 中的角色	环境变量	推荐 DeepSeek 模型	用途
主模型（Opus）	`ANTHROPIC_DEFAULT_OPUS_MODEL`	`deepseek-v4-pro[1m]`	复杂推理、大上下文
主模型（Sonnet）	`ANTHROPIC_DEFAULT_SONNET_MODEL`	`deepseek-v4-pro[1m]`	日常编码
轻量模型（Haiku）	`ANTHROPIC_DEFAULT_HAIKU_MODEL`	`deepseek-v4-flash`	快速子任务
子 Agent	`CLAUDE_CODE_SUBAGENT_MODEL`	`deepseek-v4-flash`	并行子任务，省成本

deepseek-v4-pro[1m] 中的 [1m] 表示 1M 上下文窗口，适合大型代码库。

4.3 方式一：临时环境变量（当前终端会话）

Windows PowerShell：

$env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN = "<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL = "deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL = "deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL = "max"

macOS / Linux / WSL：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max

然后在项目目录启动：

cd D:\桌面\WordPress
claude

4.4 方式二：配置文件（推荐，持久化）

配置文件可被 CLI 和 VS Code 扩展 共同读取。优先级：

项目 .claude/settings.json  >  用户 ~/.claude/settings.json

用户级配置（所有项目生效）——创建或编辑 %USERPROFILE%\.claude\settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

项目级配置（仅当前仓库生效）——创建 项目根目录/.claude/settings.json，结构同上。适合团队共享（不要把 API Key 提交到 Git，可用 .gitignore 排除或用环境变量注入 Key）。

4.5 方式三：PowerShell 启动脚本（Windows 一键启动）

创建 claude-deepseek.ps1：

# claude-deepseek.ps1 — 一键用 DeepSeek 启动 Claude Code
 $env:ANTHROPIC_BASE_URL = "https://api.deepseek.com/anthropic"$ env:ANTHROPIC_AUTH_TOKEN = $env:DEEPSEEK_API_KEY   # 从系统环境变量读取，更安全
$env:ANTHROPIC_MODEL = "deepseek-v4-pro[1m]"
 $env:ANTHROPIC_DEFAULT_OPUS_MODEL = "deepseek-v4-pro[1m]"$ env:ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-v4-pro[1m]"
 $env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "deepseek-v4-flash"$ env:CLAUDE_CODE_SUBAGENT_MODEL = "deepseek-v4-flash"
 $env:CLAUDE_CODE_EFFORT_LEVEL = "max" if (-not$ env:DEEPSEEK_API_KEY) {
    Write-Error "请先设置系统环境变量 DEEPSEEK_API_KEY"
    exit 1
}

Set-Location $args[0]  # 可选：传入项目路径
claude @args

用法：

# 先在系统环境变量中设置 DEEPSEEK_API_KEY=sk-xxx
.\claude-deepseek.ps1 D:\桌面\WordPress

4.6 验证 DeepSeek 是否生效

进入 Claude Code 会话后执行：

/status

确认 API 端点指向 api.deepseek.com，模型显示为 DeepSeek 系列。

4.7 常见问题排错

现象	原因与解决
仍走 Anthropic 官方	环境变量未在同一 Shell 中设置就启动了 `claude`；或 settings.json 路径错误
认证失败 `401`	必须用 `ANTHROPIC_AUTH_TOKEN`，不是 `ANTHROPIC_API_KEY`
回答质量偏低	主模型改用 `deepseek-v4-pro[1m]`，设置 `CLAUDE_CODE_EFFORT_LEVEL=max`
费用偏高	子 Agent 改用 `deepseek-v4-flash`；避免频繁 `/clear` 导致缓存失效
方括号 `[1m]` 在 Shell 中报错	PowerShell 用双引号包裹；bash 中一般无需转义

4.8 DeepSeek 联网搜索

DeepSeek API 原生支持 Claude Code 的 Web Search 工具。当模型判断需要联网时，会自动调用搜索（会产生额外 Token 费用）。在会话中直接提问即可触发，例如：

帮我搜索 2026 年最新的 Nginx HTTP/3 最佳实践

5. CLI 核心用法

5.1 启动与会话管理

Shell 命令	作用	示例
`claude`	交互模式	`claude`
`claude "任务"`	一次性任务	`claude "修复构建错误"`
`claude -p "查询"`	单次查询后退出	`claude -p "解释这个函数"`
`claude -c`	继续当前目录最近会话	`claude -c`
`claude -r`	恢复历史会话	`claude -r`

会话内命令	作用
`/help`	查看所有命令
`/clear`	清空对话历史
`/compact`	压缩历史以释放上下文
`/exit` 或 `Ctrl+D`	退出
`/resume [id]`	恢复指定会话
`/model [model]`	切换模型
`/usage`	查看 Token 用量与费用
`/status`	查看当前配置与连接状态
`/login`	重新登录（官方账户）

5.2 权限模式（Shift+Tab 循环切换）

┌─────────────────────────────────────────────────────────┐
│  普通模式    → 每次改文件、跑命令都需确认                  │
│  自动接受编辑 → 自动应用文件修改，危险命令仍询问            │
│  规划模式    → 只读，不修改代码，适合方案讨论               │
└─────────────────────────────────────────────────────────┘

普通模式：新手推荐，安全可控
自动接受编辑：熟悉项目后提速
规划模式（Plan Mode）：先讨论架构再动手，等价于 Cursor 的 Plan 模式

5.3 管道与自动化

Claude Code 可嵌入 Shell 管道和 CI：

# 分析日志
tail -200 app.log | claude -p "有没有异常需要告警？"

# 审查 Git 变更
git diff main --name-only | claude -p "审查这些文件的安全问题"

# CI 中自动翻译
claude -p "把新增的 i18n 字符串翻译成法语并提 PR"

5.4 项目上下文：CLAUDE.md

在项目根目录创建 CLAUDE.md，Claude Code 启动时 自动加载 为系统上下文：

# 项目说明

- 这是 WordPress 技术博客，主题为 Editormd
- PHP 8.2 + Nginx 1.27，部署在 Debian
- 代码风格：PSR-12，注释用中文
- 不要修改 vendor/ 和 node_modules/
- 提交前运行 php -l 检查语法

也可在 ~/.claude/CLAUDE.md 设置全局偏好。

5.5 实用快捷键

快捷键	作用
`Shift+Tab`	切换权限模式
`Alt+T`	开关 Thinking 模式
`Ctrl+T`	显示/隐藏 Todo 列表
`Tab`	命令补全
`↑`	历史命令
`/`	弹出命令与 Skill 列表

6. 可视化方案

CLI 本身是纯终端界面。以下四种方式可叠加使用，按需求选择。

6.1 VS Code / Cursor 扩展（推荐：编码可视化）

在扩展市场搜索 Claude Code 安装，或在 Cursor 中直接安装。

打开方式：

编辑器右上角 ✱ 图标
左侧活动栏 Spark 图标
Ctrl+Shift+P → 输入 "Claude Code" → Open in New Tab
状态栏右下角 ✱ Claude Code

可视化能力：

内联 diff 预览，逐块 Accept / Reject
@文件名 或 @文件名:10-20 精确引用代码
多标签页并行会话
计划审查（Plan Review）后再执行
读取 .claude/settings.json 中的 DeepSeek 配置

扩展提供图形界面，但部分 CLI 独有功能（如完整 Hook、部分 Slash 命令）仍需在集成终端中运行 claude。

6.2 Desktop 桌面应用（推荐：Diff 审查与多会话）

下载：claude.ai/download（Windows x64 / ARM64、macOS）

可视化能力：

结构化 diff 审查，无需在终端滚动
多会话并排、按项目分组
内置 Preview 面板 + 终端侧栏
7 天活动统计（会话数、Token、消息量）
定时任务（如每周依赖更新）
云端会话同步，终端 /desktop 可移交会话

配合 DeepSeek： Desktop 开发者模式可修改 base_url 和 api_key 指向 DeepSeek（与 CLI 相同的环境变量逻辑）。

6.3 View Claude Code — Agent/Skill 关系图

开源工具 claude-code-visualizer 可将 .claude/ 目录下的 Agent、Skill、Command 渲染为 交互式关系图。

npx viewcc

自动扫描：

项目 .claude/
全局 ~/.claude/

功能：

操作	效果
点击节点	侧边栏查看详情
点击 Execute	从 UI 直接运行 Agent/Skill
滚轮	缩放
拖拽背景	平移
拖拽节点	调整布局

适合管理复杂的多 Agent 工作流和自定义 Skill 体系。

6.4 用量与费用可视化

在 CLI 会话中：

/usage

显示当前会话费用、计划用量限制、按 Skill / 子 Agent / MCP 的消耗明细。

DeepSeek 控制台 platform.deepseek.com 也提供 API 调用量与账单图表。

7. 进阶配置

7.1 自定义 Skill 与 Hook

.claude/
├── settings.json      # 项目配置（含 env）
├── skills/            # 自定义 Skill
│   └── my-skill/
│       └── SKILL.md
└── hooks/             # 生命周期钩子
    └── post-edit.sh

Hook 可在文件编辑、工具调用等事件触发 Shell 命令或 HTTP 请求，适合自动 lint、格式化、通知。

7.2 MCP 服务器

在 settings.json 中配置 MCP，连接数据库、浏览器、Sentry 等外部系统：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed"]
    }
  }
}

7.3 成本优化建议（DeepSeek）

主 Agent 用 Pro，子 Agent 用 Flash — 已在默认配置中体现
保持 CLAUDE.md 稳定 — 前缀不变可利用 Prompt Cache
大任务用 /compact — 压缩历史而非 /clear 全删
规划模式先想清楚 — 减少反复修改的 Token 浪费
设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 — 关闭非必要遥测请求

8. 完整工作流示例

以本 WordPress 项目为例：

# 1. 配置 DeepSeek（若已写入 settings.json 可跳过）
$env:DEEPSEEK_API_KEY = "sk-xxxxxxxx"

# 2. 进入项目
cd D:\桌面\WordPress

# 3. 启动 Claude Code
claude

# 4. 会话内操作

> 分析这个 WordPress 项目的目录结构和技术栈

> 阅读 docs/nginx-http3-quic-stable.md，检查我当前的 Nginx 配置有没有遗漏

> 进入规划模式：我想给博客加 HTTP/3 检测页面，先出方案

> /model          # 确认当前模型
> /usage            # 查看 Token 消耗

如需图形化 diff 审查，在 VS Code/Cursor 中打开同一项目，用 Claude Code 扩展继续会话；或执行 /desktop 移交到桌面应用。

9. 架构一览

① 用户界面层
[Terminal CLI · claude]  [VS Code/Cursor · 内联 diff]  [Desktop App · 多会话]
        │                        │                          │
        └────────────────────────┼──────────────────────────┘
                                 ▼
② 项目配置层
[.claude/settings.json] ── [CLAUDE.md] ── [Skills · Hooks · MCP]
                                 │
                                 ▼
③ API 路由层
[ANTHROPIC_BASE_URL → api.deepseek.com/anthropic]
[ANTHROPIC_AUTH_TOKEN · DeepSeek API Key]
                                 │
                 ┌───────────────┴───────────────┐
                 ▼                               ▼
④ DeepSeek 模型层
[deepseek-v4-pro · 主 Agent]      [deepseek-v4-flash · 子 Agent]
 Opus / Sonnet 映射                  Haiku / Subagent 映射

数据流：界面层 → 配置层 → API 路由 → DeepSeek 按模型分流（Pro 主推理 / Flash 子任务）

10. 参考链接

资源	地址
Claude Code 官方文档	https://code.claude.com/docs
CLI 命令参考	https://code.claude.com/docs/en/commands
配置说明	https://code.claude.com/docs/en/settings
VS Code 扩展指南	https://code.claude.com/docs/en/vs-code
DeepSeek × Claude Code 集成	https://api-docs.deepseek.com/quick_start/agent_integrations/claude_code
DeepSeek API Key	https://platform.deepseek.com/api_keys
Agent 可视化工具	https://github.com/kubony/claude-code-visualizer

文档版本：2026-06-24 | 基于 Claude Code CLI 与 DeepSeek V4 Anthropic 兼容 API