【Claude Code Linux基础配置】告别古法编程，让你的终端学会自己写代码

m0_73800387

395人浏览 · 2026-07-07 17:02:52

m0_73800387 · 2026-07-07 17:02:52 发布

前言

随着时代发展，合理使用 AI 进行辅助编码已经是时代所需。
本文将从安装、API 配置、第三方切换工具，到实际使用、高级冷知识，系统性地介绍 Claude Code 的使用方式。

1 Claude Code安装

1-1 介绍

Claude Code 是 Anthropic 官方推出的 AI 编程助手 CLI 工具，直接在终端中与 Claude 模型交互，覆盖代码编写、调试、重构、文档生成等全流程。相比网页版聊天，它能直接读写你的本地文件、执行 shell 命令、管理 git 仓库，真正作为一个"AI 同事"融入日常开发。
Claude Code 支持 Linux、macOS、Windows（WSL2） 三大平台。安装方式有：
- 官方一键脚本（推荐）：自动下载并配置环境
- npm 全局安装：npm install -g @anthropic-ai/claude-code
- 手动下载二进制：从 GitHub Releases 获取
安装后，需要设置 API Key 才能使用。可以直接用 Anthropic 官方 API，也可以通过第三方代理工具（如 cc-switch）接入兼容服务（DeepSeek、OpenAI 等）。
系统要求：
- Node.js >= 18（npm 安装时需要）
- 网络连通 claude.ai 域名（用于下载安装脚本和 OAuth 认证）
- 如使用第三方 API，需要额外的代理/切换工具

1-2 安装必要工具

sudo apt update
sudo apt install curl git -y

1-3 安装

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

检查版本

claude --version

请添加图片描述

2 API 购买

2-1 介绍

Claude Code 本身免费开源，但调用 AI 模型需要有 API Key，你可以选择：
1. Anthropic 官方 API：console.anthropic.com 注册并充值，直接使用 Claude 全系列模型（Opus、Sonnet、Haiku、Fable）。费用按 token 计费，Opus 最贵但最强，Haiku 最便宜。
2. 第三方兼容 API：如 DeepSeek、OpenAI 等，通过中间代理工具（如 cc-switch）转发请求，往往价格更低，但功能可能有所阉割（部分高级特性如 prompt cache、extended thinking 等可能不可用）。
选择建议：
- 对代码质量要求高的专业开发 → Anthropic 官方（完整功能）
- 日常使用、预算敏感 → DeepSeek（性价比高）
- 两者可以并存，通过 cc-switch 随时切换

2-2 Deepseek

https://platform.deepseek.com/usage
用量信息：
API Keys 界面：
充值界面：

2-3 名词说明

TOKENS：大语言模型处理文本的最小单位。一个 token 约等于 0.75 个英文单词或 0.5 个中文字。API 按 token 数量计费，分为输入 token（发送给模型的文本）和输出 token（模型生成的文本）。输入通常比输出便宜。在 /cost 命令中可以实时看到当前会话的 token 消耗。
命中缓存率 (Cache Hit Rate)：Anthropic API 提供 prompt 缓存机制。当连续发送相同前缀的请求时（如同一个 CLAUDE.md、同一段代码上下文），后续请求的这部分内容会命中缓存，费用降低 90%。缓存 TTL 为 5 分钟。命中率越高，实际花费越低。保持长对话、避免频繁重启会话有助于提高命中率。
RPM/TPM：Rate Per Minute / Tokens Per Minute，API 的速率限制。免费账号或低额度账号通常有较低的 RPM/TPM 上限，遇到 429 Too Many Requests 说明触发了限制。
Context Window（上下文窗口）：模型一次能"看到"的 token 总量上限。Claude Code 会自动管理上下文，超出窗口时触发 /compact 压缩历史或丢弃最早的内容。

3 CC-switch

3-1 介绍

cc-switch 是一个开源的 Claude Code API 切换工具，可以让你在多个 API 提供商之间无缝切换（Anthropic 官方、DeepSeek、OpenAI 等），而无需每次手动修改配置。
工作原理： cc-switch 在本地启动一个代理服务器，拦截 Claude Code 发往 API 的请求，根据你选择的提供商，将请求转发到对应的 API 端点，并自动处理认证头的转换。
核心优势：
- 一键切换模型：不需要重启 Claude Code 或修改配置文件，GUI 界面点击切换即可
- 多 Key 管理：同时保存多个提供商的 API Key，随时切换
- 透明代理：对 Claude Code 来说完全透明，不需要修改任何配置
- 支持供应商多模型：DeepSeek 的 v3、v4-pro 等，OpenAI 的 GPT-4o、o4-mini 等
注意： 使用第三方 API 时，某些 Claude Code 高级特性（如 extended thinking、prompt cache）可能不可用，因为第三方 API 可能不实现完整的 Anthropic API 协议。

3-2 下载

https://github.com/farion1231/cc-switch/releases
下载后可以看到默认界面：

3-3 添加API-keys

选择 deepseek，输入 api-keys
选择切换：

4 使用

4-1 终端使用

输入

claude

初次使用会选择显示风格
然后就是正式的界面：
输入验证加载的模型

/model

如下显示为 deepseek-v4-pro!
如上图默认会开启 High effort，这是 Claude Code 的推理深度控制。Effort 分为 5 档：

级别	说明	适用场景
`low`	最快速，推理最少	简单问答、单行修改、格式调整
`medium`	均衡	日常开发、常规重构
`high`	深度推理	复杂架构、多文件改动、调试疑难问题
`xhigh`	更强推理	安全审计、性能优化、极复杂逻辑
`max`	最大推理深度	需要极详尽分析的极端场景

Effort 越高，模型思考时间越长，输出质量越高，但 token 消耗也越大。可通过 /model 命令或 --effort 参数随时调整。一般日常开发用 high 即可获得很好的效果。

4-2 `vscode插件`

我们可以搜索添加 vscode插件
默认会加载显示在项目右侧
这里可以进行一些基础的设置，包括 Manual 以及 Effort

5 冷知识：你会用但可能不知道的 Claude Code

5-1 持久记忆系统 (Memory)

Claude Code 拥有跨会话的持久记忆系统，存放在 ~/.claude/projects/<项目路径>/memory/ 目录下。每个记忆是一个独立的 markdown 文件，附带 frontmatter 元数据：

---
name: <短横线命名>
description: <一句话摘要，用于召回时判断相关性>
metadata:
  type: user | feedback | project | reference
---

<事实内容>

四种记忆类型：
- user — 你是谁（角色、偏好、技能）
- feedback — 你给的反馈或纠正（会记录 Why 和 How to apply）
- project — 项目上下文、目标、约束（代码/git 中已记录的内容不要重复存）
- reference — 外部资源指针（URL、看板、ticket）
关键机制：
- 记忆文件之间用 [[other-memory-name]] 互相链接，形成知识图谱
- MEMORY.md 是索引文件，每个会话启动时加载到上下文
- 不会自动保存——需要你明确说"记住这个"才会写入
- 如果已有相关记忆，会更新而非重复创建；错误记忆会被删除

5-2 Hooks 钩子系统

Claude Code 支持在 settings.json 中配置钩子（hooks），在特定事件触发时自动执行命令。这是实现"每次 X 时自动做 Y"的唯一方式——纯记忆/偏好做不到。
支持的钩子事件：

事件	触发时机
`PreToolUse`	工具调用前
`PostToolUse`	工具调用后
`Notification`	收到通知时
`Stop`	Agent 完成响应后
`SubagentStop`	子 agent 完成时
`SessionStart`	会话启动时
`PreCompact`	上下文压缩前

典型用法：
- 每次文件写入后自动运行格式化工具
- 在 git 操作前弹出确认提示
- 会话结束时自动清理临时文件
- 子 agent 完成后自动汇总结果

5-3 自定义子 Agent

你可以在 .claude/agents/ 目录下创建自定义 agent 定义文件，赋予特定的系统提示词、工具集和模型：

---
name: code-reviewer
description: 专门审查代码质量和安全性
model: opus
tools: Read, Grep, Glob, Bash, Edit
---

你是一个严格的代码审查者，关注以下维度：
1. 正确性（逻辑错误、边界条件）
2. 安全性（注入、泄露、权限）
3. 简洁性（冗余代码、可简化逻辑）
...

支持配置项：
- model — 指定模型（sonnet/opus/haiku/fable）
- tools — 限制可用工具白名单
- effort — 推理深度（low/medium/high/xhigh/max）
- isolation — 是否在独立 git worktree 中运行
然后通过 /agent-name 或 Agent 工具直接调用。

5-4 Git Worktree 隔离

当需要并行处理多个独立任务时，Claude Code 可以创建 git worktree 隔离环境：
- 使用 EnterWorktree 创建临时分支和隔离工作目录
- 使用 ExitWorktree 退出并可选择保留或删除
- Worktree 位于 .claude/worktrees/ 下
- 如果 worktree 没有任何改动，会自动清理
- 适合：并行修 bug、试验性重构、多 PR 同时开发
隔离模式（isolation: "worktree"）也可用于子 agent，确保多个 agent 并行修改文件时不冲突。

5-5 定时任务 (Cron)

Claude Code 内置 cron 调度器，可以设置定时触发的 prompt：
一次性任务（reminders）：

"明天上午 9 点提醒我检查部署"  → cron: "57 8 <明天> <月份> *"

循环任务：

"每 5 分钟检查一次 CI 状态"  → cron: "*/5 * * * *"
"每个工作日早上 9 点跑日报"   → cron: "3 9 * * 1-5"

关键细节：
- 避免使用 :00 和 :30 分钟整点（全球用户扎堆，建议用 :07、:23 等非整点）
- 循环任务 7 天后自动过期
- durable: true 可持久化到 .claude/scheduled_tasks.json，跨会话存活
- 默认只在当前会话有效，退出一律丢失

5-6 Plan 模式（计划模式）

对于复杂的多文件改动，可以先用 EnterPlanMode 进入计划模式：
1. 先探索、再设计 — 深入阅读代码，理解现有架构
2. 写计划 — 输出到计划文件，包含步骤、涉及文件、风险点
3. 用户审批 — ExitPlanMode 提交计划等用户确认
4. 实施 — 批准后按计划逐步执行
何时应该进入 Plan 模式：
- 新功能开发（多个文件、不确定放哪里）
- 多种可行方案（缓存策略、状态管理选型）
- 架构改动（重构认证系统、引入新模式）
- 需求不明确（“让应用更快” — 需要先 profiling）
何时不需要： 单行修复、typo、明确的简单改动。

5-7 CLAUDE.md 项目配置

CLAUDE.md 是项目级指令文件，放在项目根目录，每个会话启动时自动加载到上下文。你可以写：

# 项目规范
- 始终使用 TypeScript 严格模式
- 测试框架: Vitest
- 代码风格: 遵循 src/.eslintrc.json
- 不要直接修改 dist/ 目录
- API 调用统一经过 src/api/client.ts

也可以放 .claude/CLAUDE.md（隐藏目录版本）。用 /init 命令可以自动生成初始版本。
子目录也可放 CLAUDE.md，当工作上下文聚焦到该目录时自动加载对应文件，实现分模块的上下文注入。

5-8 权限系统

Claude Code 有精细的权限控制，分三个层级：

层级	文件	作用范围
全局	`~/.claude/settings.json`	所有项目
项目	`<project>/.claude/settings.json`	当前项目
本地	`<project>/.claude/settings.local.json`	仅你个人（不入 `git`）

权限模式：
- allow — 静默允许
- deny — 静默拒绝
- ask — 每次询问（默认）
可按工具、命令模式、路径等细粒度配置。 例如：

{
  "permissions": {
    "Bash": {
      "npm run test": "allow",
      "npm run build": "allow",
      "git push*": "ask"
    }
  }
}

用 /permissions 命令可以交互式管理权限。

5-9 键盘快捷键与自定义绑定

在终端版 Claude Code 中，有一套完整的键盘快捷键：

快捷键	功能
`Ctrl+C`	中断当前响应
`Ctrl+D`	退出会话
`Ctrl+L`	清屏
`Ctrl+R`	搜索历史
`↑/↓`	浏览历史命令
`Tab`	自动补全路径
`Esc` + 数字	快速选择菜单项

可以通过 ~/.claude/keybindings.json 自定义绑定，支持 chord 组合键（类似 Vim 的 leader key 模式）。
用 /keybindings 命令或 keybindings-help skill 进行交互式配置。

5-10 完整 Slash 命令列表

除了 /model，Claude Code 还有许多内置命令：

命令	功能
`/help`	帮助信息
`/clear`	清空对话历史
`/compact`	压缩上下文（释放 `token`，防止截断）
`/config`	打开设置界面
`/cost`	查看当前会话 `token` 用量和费用
`/doctor`	诊断环境问题
`/init`	初始化项目的 `CLAUDE.md`
`/model`	查看/切换模型
`/permissions`	管理权限
`/status`	查看会话状态
`/review`	审查 `GitHub PR`
`/code-review`	审查当前改动
`/simplify`	简化当前代码
`/security-review`	安全审查
`/run`	启动项目应用
`/loop`	循环执行命令
`/fast`	切换快速模式（`Opus` 更快速输出）
`/workflows`	查看工作流进度
`/tasks`	查看后台任务
`/design-sync`	同步设计系统

5-11 Context 压缩机制 (`/compact`)

当对话历史超过上下文窗口时，Claude Code 会自动或手动（/compact）压缩历史：
- 工作原理： 对历史对话生成摘要，释放前面的详细 token，为后续对话留空间
- 缓存影响： Anthropic 的 prompt cache TTL 为 5 分钟（300 秒）。压缩后再等超过 300 秒会有缓存 miss（更慢、更贵）
- 最佳实践： 长任务中定期 /compact，保持上下文健康
- ScheduleWakeup 技巧： 定时轮询时，选 60-270 秒保持缓存热度，或 1200+ 秒摊销缓存 miss 成本。永远不要选 300 秒（最差选择：缓存 miss 但没有摊销等待时间）

5-12 MCP 协议 (Model Context Protocol)

Claude Code 原生支持 MCP 服务器，可以接入外部工具和数据源：
- 在 settings.json 中配置 MCP server 的启动命令
- 支持 stdio 传输（本地进程）和 HTTP 传输（远程服务）
- MCP 工具在子 agent 中也可用（通过 ToolSearch 按需加载 schema）
典型场景：
- 接入公司内部 API 文档
- 连接数据库做只读查询
- 调用内部 CI/CD 系统
- 集成项目管理工具（Jira、Linear）

5-13 后台任务与并发

Claude Code 支持在后台运行任务：
- 后台 Bash： run_in_background: true 的 Bash 命令，完成后通知你
- 后台 Agent： 子 agent 默认在后台运行，可并发多个
- 用 /tasks 查看所有后台任务状态
- TaskStop 可中途终止
- TaskOutput 获取运行中或已完成任务的输出
并发上限： 同时运行 ~10 个 agent（min(16, CPU核数-2)）

5-14 Workflow 多 Agent 编排

这是一个高级特性，通过 Workflow 脚本编排多个子 agent 的协作：

export const meta = {
  name: 'review-changes',
  description: '多维度审查代码变更',
  phases: [{ title: 'Review' }, { title: 'Verify' }],
}

const DIMENSIONS = [
  {key: 'bugs', prompt: '查找逻辑错误...'},
  {key: 'perf', prompt: '查找性能问题...'},
  {key: 'security', prompt: '查找安全隐患...'},
]

const results = await pipeline(
  DIMENSIONS,
  d => agent(d.prompt, {label: `review:${d.key}`, phase: 'Review', schema: FINDINGS_SCHEMA}),
  review => parallel(review.findings.map(f => () =>
    agent(`对抗性验证: ${f.title}`, {label: `verify:${f.file}`, phase: 'Verify'})
  ))
)

核心模式：
- Pipeline（流水线）： 每个 item 独立流过多阶段，无屏障等待——最快的 item 不会等最慢的
- Parallel（并行）： 所有任务完成后才继续（屏障）
- 对抗性验证 (Adversarial Verify)： 让多个独立 agent 尝试反驳某个发现，只有多数投票通过才保留
- 多视角验证 (Perspective-diverse Verify)： 从正确性、安全性、性能等不同维度验证同一个发现
- Loop-until-dry： 不断发现直到 K 轮无新结果
- 评审团 (Judge Panel)： N 个 agent 独立设计方案，并行评分，选最优并吸收其他方案的优点

5-15 Token 缓存机制

Claude API 的 prompt 缓存是 Claude Code 性能优化的关键：
- 缓存 TTL： 5 分钟（300 秒）。相同 prompt 前缀在 5 分钟内重复发送，命中缓存
- 缓存命中： 大幅降低延迟和费用（缓存读取比全量推理便宜 90%）
- 实践建议：
  - 连续对话比跳跃式提问更省钱
  - 长指令（如 CLAUDE.md）放前缀位置，每次都命中缓存
  - 避免在缓存前缀位置频繁改动内容
- /cost 命令 可查看实际缓存命中率

5-16 设置层级覆盖规则

设置合并优先级（从低到高）：

全局 settings.json  <  项目 settings.json  <  settings.local.json  <  环境变量

- `settings.local.json` 不提交到 `git`（自动 `gitignore`）
- 环境变量如 `CLAUDE_MODEL`、`CLAUDE_EFFORT` 等可临时覆盖
- 用 `update-config` skill 或 `/config` 交互式修改

5-17 IDE 插件深度功能

VS Code 插件：
- 右键选中代码 → "Add to Claude" 直接发送到 Claude Code 会话
- 终端中运行 claude 自动检测 VS Code 环境并联动
- 插件面板显示当前模型、状态、对话历史
- Manual 模式允许你在 Claude 思考前追加指令
JetBrains 插件：
- 同样支持，功能对等
- 通过 JetBrains 市场安装

5-18 隐藏的 CLI 参数

claude --help                 # 查看所有参数
claude --version              # 版本号
claude --model opus           # 指定模型启动
claude --effort high          # 指定推理深度
claude -p "一句话完成某任务"   # 单次对话（非交互）
claude -c "*.ts"              # 指定文件上下文
claude --resume               # 恢复上次会话
claude --no-memory            # 禁用记忆加载

-p 模式特别适合脚本化：用 Claude Code 做 CI 步骤、git hook、自动化代码审查。

5-19 状态栏自定义

终端版底部状态栏可以自定义显示内容：
- 当前模型、推理深度
- Token 用量 / 预算
- 后台任务数
- 当前分支等 git 信息
通过 statusline-setup agent 或配置文件来定制。

5-20 设计系统同步 (`/design-sync`)

如果你使用 claude.ai 的 Design System 功能：
- 可以将本地组件库同步到云端设计系统
- 支持增量更新（一次一个组件，不全量替换）
- 每个组件可附带 preview HTML、viewport 尺寸、分组标签
- 设计面板会自动从  注释构建索引

5-21 会话恢复与持久化

退出后重新 claude 进入可以选择恢复上次会话
记忆系统跨会话保持
定时任务（durable）在重启后自动恢复
会话目录存储在 ~/.claude/projects/ 下

5-22 多个模型的差异与选择

模型	特点	适用场景
`Opus 4.8`	最强推理，最贵	复杂架构设计、安全审计
`Sonnet 5`	平衡能力与速度	日常开发、代码审查
`Haiku 4.5`	最快、最便宜	简单任务、大规模查询
`Fable 5`	创意类强项	设计、文档、头脑风暴