ShiBin's Wiki

Appearance

Published at:

安装与设置 ​

前置要求 ​

在安装 Claude Code 之前，确保你的环境满足以下条件：

依赖最低版本说明
Node.js22.x+Claude Code CLI 运行环境
Git2.23+版本控制，用于文件变更追踪
网络—翻墙

对于 VSCode 用户，需要 VSCode 1.82+。

Claude Code for VSCode（推荐） ​

安装扩展 ​

  1. 打开 VSCode，进入扩展市场（Cmd+Shift+X）
  2. 搜索 "Claude Code"
  3. 选择 Anthropic 官方发布的扩展，点击安装
  4. 重启 VSCode 插件

或者通过命令行安装：

bash
code --install-extension anthropic.claude-code

初始设置 ​

安装后会提示登录。使用修改配置 或 cc-switch（见下文）切换模型后，也可接入 DeepSeek 等第三方模型。

Claude Code CLI ​

如果你偏好终端原生体验，或需要在远程服务器上使用：

bash
# 全局安装
pnpm install -g @anthropic-ai/claude-code

# 进入项目目录，启动交互
cd your-project
claude

首次启动会引导完成认证。CLI 版本的体验与 VSCode 扩展中的终端面板完全一致。

VSCode 界面一览 ​

安装完成后，VSCode 侧边栏会出现 Claude Code 面板。核心交互区域：

  • 对话面板：左侧主聊天区域，输入指令
  • 文件 Diff 视图：代码修改的双栏对比
  • 终端输出区：显示执行的命令和结果
  • 权限确认弹窗：涉及敏感操作时的确认界面

DeepSeek 介绍 ​

DeepSeek 是深度求索（DeepSeek）开发的 AI 模型系列，其 API 通过 OpenAI 兼容格式 或 Anthropic 兼容格式 提供服务。配合 cc-switch 或手动配置，可将 Claude Code 的底层模型替换为 DeepSeek，在保留 Claude Code Agent 框架（工具编排、文件操作、权限控制等）的同时，使用 DeepSeek 的推理能力。

DeepSeek 开放平台： https://platform.deepseek.com/

DeepSeek V4 系列 ​

2026 年 4 月，DeepSeek 发布了 V4 系列 的两个模型：

特性DeepSeek V4 FlashDeepSeek V4 Pro
定位轻量快速、高吞吐高性能、强推理
上下文1M tokens1M tokens
最大输出384K tokens384K tokens
思考模式支持（默认开启）支持（默认开启）
工具调用✅✅
并发限制2,500500
OpenRouter 排名2026 年 5 月登顶—

定价对比 ​

2026 年 5 月，DeepSeek 宣布 永久降价 75%，V4 Flash 的定价极具竞争力。

计费项（每 1M tokens）DeepSeek V4 FlashDeepSeek V4 ProClaude Sonnet 4.6Claude Opus 4.7
输入（缓存命中）¥0.02¥0.025 ↓¥1.05¥10.50
输入（缓存未命中）¥1.00¥3.00 ↓¥21.00¥105.00
输出¥2.00¥6.00 ↓¥105.00¥525.00

💡 V4 Flash 的输出价格仅为 Claude Sonnet 4.6 的 1/53，Claude Opus 4.7 的 1/263。V4 Pro 当前享受 75% 补贴价，2026/05/31 后调整为正式价：输入 ¥12.00，输出 ¥24.00（仍远低于 Anthropic 官方模型）。

模型选择建议 ​

场景推荐模型理由
日常开发、简单重构DeepSeek V4 Flash极低成本，足够好的代码能力
复杂架构设计、深度推理Claude Opus 4.7推理深度不可替代
高质量代码生成DeepSeek V4 Pro / Claude Sonnet 4.6两者各有所长
高频调用、批量处理DeepSeek V4 Flash2500 并发 + 极低缓存价格

在 Claude Code 中使用 DeepSeek ​

DeepSeek 可通过 Anthropic 兼容接口 直接接入 Claude Code，无需额外的适配层。具体配置方式见下文「切换模型」章节。

创建管理API keys, 网站：https://platform.deepseek.com/api_keys

切换模型：手动改配置 ​

Claude Code 的模型配置项位于用户全局配置 ~/.claude/settings.json 中。可以直接编辑这个文件来切换模型，下面是使用Deepseek的配置：

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-xxx",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash[1M]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_NAME": "deepseek-v4-flash",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "model": "haiku"
  // 其它设置保持不变...
}

DeepSeek 接入Claude code文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code

切换模型：cc-switch ​

Note: 手动改只能配置一家模型；如果有多个模型服务商（如 Anthropic + DeepSeek），建议使用 cc-switch 进行可视化管理和快速切换。

cc-switch 是一个可视化的模型切换工具，通过 GUI 配置界面管理 Claude Code 使用的 AI 模型。它解决了一个常见痛点：在快速任务（用小模型省钱）和复杂重构（用大模型保质量）之间高效切换，同时支持接入第三方模型服务。

安装 cc-switch ​

下载连接：https://github.com/farion1231/cc-switch/releases, Assets部分下载（可能需要

  • 安装包：CC-Switch-v{version}-Windows.msi
  • 免安装包：CC-Switch-v{version}-Windows-Portable.zip

GUI 配置界面 ​

  1. 选中Claude Code
  2. 添加模型（Anthropic 官方模型已内置，直接切换即可）
  3. 选中DeepSeek，填写 API 端点和密钥
  4. 填写API endpoint: https://api.deepseek.com/anthropic
  5. 填写API key: sk-xxx
  6. 配置Claude Code 模型映射：
    1. Haiku（快） → DeepSeek V4 Flash
    2. Sonnet（平衡） → DeepSeek V4 Flash / DeepSeek V4 Pro (根据需要选择)
    3. Opus（强推理） → DeepSeek V4 Pro
  7. 保存配置：开启
  8. 拖动顺序：切换模型

Note: cc-switch 本质还是去改Claude Code的配置文件（~/.claude/settings.json）

VSCode 扩展功能详解 ​

安装完成后，了解一下 VSCode 扩展提供的核心交互方式。

三种启动方式 ​

方式快捷键/操作适用场景
命令打开Claude Code: Open in Side Bar针对特定代码的快速操作
图标打开打开文件之后右上角Claude Code图标多轮对话、复杂任务、需要查看 Diff
快捷键打开Cmd+Esc 或 Ctrl+Esc快速提问、光标处直接操作

对话管理 ​

VSCode 扩展支持多个独立的对话会话：

  • 创建会话：右上角加号图标
  • 历史会话：类型历史时钟图标
  • 会话Title: 可以重命名，取一个有意义的名字，如 "重构用户模块"、"调试支付流程"
  • 相关命令：
    • 手动 /clear 清空当前对话，开始新话题
    • 压缩上下文 /compact，保留关键信息，丢弃冗余对话，适合长对话后清理上下文
      • 示例：/compact 只保留性能优化相关的对话内容，丢弃其他无关信息

模式 ​

  • Ask before edit（默认）：每次修改前询问，适合不确定的操作
  • Edit automatically：直接修改，适合信任 Claude 的场景
  • Plan mode: 先输出修改计划，确认后再执行，适合大规模重构
  • Auto mode: 根据任务自动选择是否需要确认，适合日常使用
  • Bypass permissions: 直接执行所有操作，无需确认，适合测试或完全信任的环境 (用久之后，现在用的最多)

功能: 用 / 呼出功能列表 ​

  • 模型切换：Switch Model...
  • 调整模型Effort：5个等级，默认为3（平衡）
    • 思考投入度/推理力度；简单来说，它就像是给 AI 设置的脑力档位。
    • 作用：数值越高，Claude 在理解需求、分析代码、生成方案时投入的“思考力”越多，输出的代码质量和复杂度也会相应提升，但响应时间可能增加。适合复杂任务或需要高质量输出的场景。
  • 思考模式开关：
    • 作用：让 Claude 在执行前先输出思考过程，帮助你理解它的推理路径，适合复杂任务或调试。

总结：通过切换模型、调整 Effort 和思考模式，你可以根据不同的任务需求灵活配置 Claude 的行为，达到最佳的效率和输出质量。

插件 ​

个人推荐设置 ​

json
{
  // 在侧边栏显示 Claude Code 面板，保持工作区整洁
  "claudeCode.preferredLocation": "sidebar",
  // 启用新会话快捷键 Cmd/Ctrl+N
  "claudeCode.enableNewConversationShortcut": true,
  // 发送消息时使用 Ctrl+Enter，避免与 Enter 换行冲突（经常要打多行指令）
  "claudeCode.useCtrlEnterToSend": true,
  // 启动bypassPermissions模式，直接执行所有操作，无需每次确认（适合测试或完全信任的环境）
  "claudeCode.allowDangerouslySkipPermissions": true,
  // 直接跳过登录提示，适合已经通过环境变量配置好认证信息的用户
  "claudeCode.disableLoginPrompt": true,
  // 模型permission模式使用bypassPermissions，直接执行所有操作，无需每次确认（适合测试或完全信任的环境）
  "claudeCode.initialPermissionMode": "bypassPermissions"
}

侧边栏面板 ​

侧边栏是主要工作区，包含三个核心区域：

对话区：

  • 输入指令的地方，支持多行输入（Shift+Enter 换行，Enter 发送）
  • 对话历史可滚动查看，Claude 的工具调用过程实时可见
  • 支持 / 开头的 Slash Commands

Diff 审查区：

  • Claude 修改代码后，每个文件以左右双栏 Diff 形式展示
  • 顶部工具栏：Accept All / Reject All / 逐文件操作
  • 可以在 Diff 视图中直接编辑（手动微调 Claude 的输出）
  • 支持 Cmd+Z 撤销已接受的变更

终端输出区：

  • Claude 执行的每个 Shell 命令都可以展开查看完整输出
  • 命令执行中可按 Ctrl+C 中断
  • 失败的命���会高亮显示，方便定位问题

右键菜单功能 ​

选中代码后右键，VSCode 扩展提供以下快捷入口：

菜单项功能
Ask Claude以选中代码为上下文提问
Explain This解释选中代码的逻辑
Fix This自动诊断并修复选中的问题代码
Add to Context将选中代码加入当前对话上下文（不发送新消息）

内联编辑 ​

在编辑器中按 Cmd+Shift+I，输入指令后，Claude 直接在光标位置生成/修改代码：

  • 生成的代码以灰色预览形式显示
  • Tab 接受，Escape 拒绝
  • 适合单函数、单块的快速编辑

对话管理 ​

VSCode 扩展支持多个独立的对话会话：

  • 每次打开侧边栏面板，默认恢复上次对话
  • 可以通过 Cmd+Shift+P → Claude Code: New Session 开启新会话
  • 历史会话可通过 Claude Code: Show History 查看和恢复
  • 手动 /clear 清空当前对话，开始新话题

配置体系 ​

Claude Code 的配置分为四个层级，优先级从高到低：

项目本地配置 (.claude/settings.local.json)     ← 最高优先级，不提交 Git
    ↓ 覆盖
项目配置 (.claude/settings.json)               ← 团队共享，提交 Git
    ↓ 覆盖
用户全局配置 (~/.claude/settings.json)          ← 个人偏好，所有项目生效
    ↓ 覆盖
内置默认值                                      ← 最低优先级

用户全局配置 ​

~/.claude/settings.json 存放个人偏好，对所有项目生效：

json
{
  "model": "claude-sonnet-4-6",
  "theme": "dark",
  "autoCompact": true,
  "permissions": {
    "allow": [
      "Bash(git:status)",
      "Bash(git:diff)",
      "Bash(git:log)",
      "Bash(npm:*)",
      "Bash(pnpm:*)"
    ],
    "deny": ["Bash(rm:-rf:*)", "Bash(sudo:*)", "Bash(git:push:--force:*)"]
  },
  "hooks": {
    "PreToolUse": [],
    "PostToolUse": []
  }
}

项目级配置 ​

.claude/settings.json（项目根目录）存放团队共享的配置，提交到 Git：

json
{
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": [
      "Bash(git:*)",
      "Bash(pnpm:*)",
      "Bash(node:*)",
      "WebSearch",
      "WebFetch"
    ],
    "deny": ["Bash(rm:-rf:*)", "Bash(sudo:*)"]
  },
  "enableAllProjectMcpServers": true
}

settings.local.json ​

.claude/settings.local.json 是本地覆盖配置，不提交到 Git，适合存放个人密钥、本地路径等敏感信息：

json
{
  "env": {
    "DATABASE_URL": "postgresql://localhost:5432/mydevdb",
    "DEBUG": "true"
  }
}

项目配置：CLAUDE.md ​

CLAUDE.md 是 Claude Code 的 项目上下文文件，放在项目根目录下。每当你在该项目中启动 Claude Code，它自动读取这个文件来理解项目。详见 生态与社区 的 CLAUDE.md 编写规范章节。

VSCode 快捷键配置 ​

Claude Code for VSCode 提供丰富的快捷键支持：

快捷键操作
Cmd+Shift+L打开侧边栏对话面板
Cmd+Shift+I打开内联输入框
Enter发送消息
Shift+Enter消息内换行
Ctrl+C中断 Claude 当前操作
Cmd+K选中代码后打开上下文菜单
Tab接受内联编辑建议
Escape拒绝内联编辑建议 / 关闭面板

自定义快捷键 ​

在 VSCode 中 Cmd+K Cmd+S 打开快捷键设置，搜索 Claude Code 即可自定义所有绑���。社区推荐的额外绑定：

json
// keybindings.json
[
  {
    "key": "cmd+shift+r",
    "command": "claude-code.reviewSelection"
  },
  {
    "key": "cmd+shift+e",
    "command": "claude-code.explainSelection"
  }
]

环境变量配置 ​

Claude Code 支持通过环境变量进行高级配置：

环境变量说明
ANTHROPIC_API_KEYAPI 密钥
ANTHROPIC_BASE_URL自定义 API 端点（代理/私有部署）
CLAUDE_CODE_MAX_OUTPUT_TOKENS单次输出最大 token 数
CLAUDE_CODE_DISABLE_TELEMETRY禁用遥测（设为 1）
NO_COLOR禁用 CLI 彩色输出（设为 1）

在 VSCode 中，可以通过 .vscode/settings.json 设置：

json
{
  "claude-code.environment": {
    "ANTHROPIC_BASE_URL": "https://your-proxy.example.com"
  }
}

第一次启动 ​

  1. 打开 VSCode，进入你的项目
  2. 点击侧边栏的 Claude Code 图标，或按 Cmd+Shift+P 输入 Claude Code: Open
  3. 对话面板启动后，输入第一个问题试试：
介绍一下这个项目的结构

Claude Code 会自动读取项目文件，理解项目结构，然后给出回复。

检查清单 ​

完成安装后，确认以下各项：

  • [ ] VSCode 扩展已安装并可看到侧边栏面板
  • [ ] 认证完成，Claude 可以正常回复
  • [ ] cc-switch 已安装并可切换模型
  • [ ] ~/.claude/settings.json 存在且配置正确
  • [ ] 项目根目录有 CLAUDE.md（可选，但强烈推荐）

Copyright © 2017-2026 Shi Bin