Claude Code 实践指南

发表于 2025-12-26 更新于 2026-02-01 分类于 2_工具编程， 6-AI 阅读次数： Waline：本文字数： 3.5k 阅读时长 ≈ 3 分钟

1. Anthropic 产品体系

flowchart LR
    subgraph Anthropic["Anthropic 产品体系"]
        A["claude.ai<br/>聊天应用"]
        B["Console<br/>开发者平台"]
        C["Claude Code<br/>命令行工具"]
    end

    A -->|"订阅登录"| C
    B -->|"API Key"| C

    classDef app fill:#4F46E5,stroke:#3730A3,color:#fff
    classDef platform fill:#10B981,stroke:#059669,color:#fff
    classDef tool fill:#F59E0B,stroke:#D97706,color:#000

    class A app
    class B platform
    class C tool

1.1 claude.ai

claude.ai 是 Claude 的消费级应用（Web/桌面/移动端），提供对话、写作、代码生成等能力。

核心特点：

面向个人使用与日常生产力
按消息/会话容量计费，不同套餐容量不同
订阅（Pro/Max/Team/Enterprise）提供更多用量和优先访问

注意：订阅计划与 Console/API 是独立产品，API 调用需单独付费。

1.2 Console（开发者平台）

console.anthropic.com 面向开发者/团队，通过 API Key 将 Claude 接入自有产品、脚本或服务。

核心特点：

按 token/调用量计费
通过预付费 credits 扣费，适用于 API、Workbench、Claude Code
支持 Organization/Workspaces 进行项目隔离和成本控制

1.3 Claude Code 登录方式选择

Claude Code 支持两种登录方式，计费模式不同。

flowchart TD
    A{"使用场景"} -->|"个人日常开发"| B["订阅登录<br/>Claude Pro/Max"]
    A -->|"团队/自动化/重度使用"| C["API Key<br/>Console 计费"]
    
    B --> D["共享 claude.ai 用量"]
    C --> E["独立按 token 计费"]

    classDef decision fill:#F59E0B,stroke:#D97706,color:#000
    classDef option fill:#4F46E5,stroke:#3730A3,color:#fff
    classDef result fill:#10B981,stroke:#059669,color:#fff

    class A decision
    class B,C option
    class D,E result

订阅登录：消耗 Pro/Max 包含用量，与 claude.ai 共享配额。

API Key 登录：按 token 独立计费，适合大型代码库、并发实例或 CI/CD 场景。

注意：若设置了 ANTHROPIC_API_KEY 环境变量，Claude Code 会优先使用 API Key 计费，而非订阅额度。

2. Claude Code

Claude Code 是 Anthropic 推出的命令行 AI 编程助手，默认集成 Claude 模型，支持切换至兼容的第三方 API 提供商（如 SiliconFlow）。

2.1 安装与卸载

# 官方安装脚本（推荐）
curl -fsSL https://claude.ai/install.sh | bash

# npm 安装
npm install -g @anthropic-ai/claude-code

# 完全卸载
npm uninstall -g @anthropic-ai/claude-code
rm -rf ~/.claude-code ~/.claude
npm cache clean --force
rm -rf ~/.local/state/claude/locks/

2.2 API 提供商切换

Claude Code 支持两种 API 切换方案。

flowchart LR
    subgraph Direct["CC Switch 方案"]
        A1["修改 config.json"] --> A2["重启生效"]
    end

    subgraph Proxy["CCR 方案"]
        B1["代理层转发"] --> B2["无需修改配置"]
    end

    CC["Claude Code"] --> Direct
    CC --> Proxy

    Direct --> API1["第三方 API"]
    Proxy --> API1

    classDef tool fill:#4F46E5,stroke:#3730A3,color:#fff
    classDef method fill:#10B981,stroke:#059669,color:#fff
    classDef api fill:#F59E0B,stroke:#D97706,color:#000

    class CC tool
    class A1,A2,B1,B2 method
    class API1 api

2.2.1 CC Switch

通过修改配置文件切换 API 提供商。

项目地址：https://github.com/farion1231/cc-switch

配置项	说明
配置文件	`~/.claude/config.json`
API 端点	`https://api.siliconflow.cn`（无 `/v1` 后缀）
生效方式	修改后需重启终端或客户端
查看模型	`/model` 命令

2.2.2 CCR（Claude Code Router）

通过代理层转发请求，无需修改原始配置。

1
2
3

npm install -g @musistudio/claude-code-router
ccr ui    # 启动配置界面
ccr code  # 启动代理

特性	说明
无侵入设计	不修改 Claude Code 配置
API 格式	OpenAI 兼容格式
端点	`https://api.siliconflow.cn/v1/chat/completions`

2.3 核心功能

2.3.1 项目配置：CLAUDE.md

CLAUDE.md 是 Claude Code 的核心配置文件，记录项目上下文和编码规范。

1	/init # 创建 CLAUDE.md

文件用途：

项目上下文：记录项目目标、技术栈、业务逻辑
编码规范：定义代码风格、命名约定
业务规则：固化领域知识，减少重复解释

更新时机：项目结构变更、新增架构决策、每 2-4 周定期审查。

2.3.2 权限控制

Claude Code 执行敏感操作时会提示确认。

1 2	# 跳过权限检查（仅限信任环境） claude code --dangerously-skip-permissions

安全建议：生产环境慎用该参数，首次使用建议开启权限确认。

2.3.3 常用命令

命令	功能	场景
`/tasks`	管理后台任务	查看长时间运行任务
`/compact`	压缩对话历史	减少 token 消耗
`/cost`	显示 token 统计	监控 API 成本
`/review`	代码审查	检查质量和安全问题
`/model`	查看当前模型	确认 API 提供商

多行输入：行尾输入 \ 后按 Enter 继续下一行。

后台任务：Ctrl+B 或 /background 将命令移至后台。

3. Fuclaude

资源	链接
介绍	https://linux.do/t/topic/131611
教程	https://linux.do/t/topic/131669
文档	https://wiki.linux.do/AI/Fuclaude/SessionToken
登录	https://demo.fuclaude.com/new