仁胜AI

1. Claude Code 概述 #

Claude Code是一个代理编码工具，可以读取你的代码库、编辑文件、运行命令，并与你的开发工具集成。可在终端、IDE、桌面应用和浏览器中使用。
Claude Code 是一个由 AI 驱动的编码助手，可帮助你构建功能、修复错误和自动化开发任务。它理解你的整个代码库，可以跨多个文件和工具工作以完成任务。

2. 安装Claude Code #

安装Claude Code

winget install Anthropic.ClaudeCode

Claude Code has switched from npm to native installer. Runclaude installor see https://docs.anthropic.com/en/docs/claude-code/getting-started for more options.

背景：Claude Code 最初是通过 Node.js 的包管理器 npm (npm install -g @anthropic-ai/claude-code) 安装的。从 2026 年起，官方已正式弃用这种方式。
未来：官方推荐使用原生安装程序（Native Installer）。它更轻量，不依赖 Node.js 环境，并且支持自动更新。
数据安全：从旧版迁移时，你之前的配置和 API 密钥等数据会被自动保留，无需担心丢失。

2.1 解决地区检测 #

启动和初次引导完成后，Claude Code 会在你的用户目录下生成 .claude.json 配置文件（如：C:\Users\Administrator\.claude.json）。

{
   "hasCompletedOnboarding": true
}

其中 hasCompletedOnboarding: true 是 ‌Claude Code‌（由 Anthropic 开发的 AI 编程助手）中的一个关键配置字段，用于‌跳过首次启动引导流程‌，避免每次打开都弹出登录或设置页面。设置为 true 表示“已完成新手引导”，程序将‌直接进入工作模式‌，不再强制要求登录或完成初始设置。若该字段缺失或为 false，Claude Code 启动时会尝试连接 Anthropic 官方服务进行验证，‌在部分地区（如中国）可能因网络限制导致连接失败‌，从而无法正常使用 ‌‌

3. 切换国产大模型 #

3.1 大模型选型 #

deepseek：DeepSeek 提供通用大模型能力，支持代码生成、自然语言处理等多种开发场景。通过平台注册获取 API Key 后，可集成到各类 AI 助手或自动化工具中。
Kimi：Moonshot AI 的 Kimi 是高性能的聊天与编程辅助大模型。注册平台账号，即可获得 API 密钥，用于开发或集成自己的 AI 应用。
minimax：MiniMax 提供高质量的多模态大模型 API，包括文本理解、代码补全等。登录后台可获取接口密钥，方便本地或云端调用。
Hotai2API：Hotai2 提供 API 接口，适合需要集成大模型能力的开发者。通过平台获取对应的 API Key，用于个人或团队项目的智能化升级。

3.2 ccswitch #

ccswitch：一个统一管理和切换多种 AI 编程 CLI 的工具，支持主流国产和海外模型，便于在开发中灵活调用不同大模型的 API。

settings.json(如C:\Users\Administrator\.claude\settings.json)用于 ‌Claude Desktop（图形界面应用）‌ 的设置，也可用于 CLI 配置 API 密钥、模型等高级选项。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", // 指定基础 API 地址为 deepseek 平台
    "ANTHROPIC_AUTH_TOKEN": "sk-b04d7075809445ab8955896791b90493", // 这里填写你的 deepseek API 密钥
    "ANTHROPIC_MODEL": "DeepSeek-V3.2", // 设置默认使用的模型为 DeepSeek-V3.2
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "DeepSeek-V3.2", // Haiku（小模型）也指定为 DeepSeek-V3.2
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "DeepSeek-V3.2", // Sonnet（中模型）使用 DeepSeek-V3.2
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "DeepSeek-V3.2", // Opus（大模型）同样指定为 DeepSeek-V3.2
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1", // 关闭非必要的网络请求，减少流量消耗
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0" // 禁用返回结果中的归因信息（如作者或来源说明）
  }
}

4. 配置文件 #

4.1 配置文件 #

C:\Users\Administrator\.claude.json：状态管理文件。你 不应该 手动编辑它。它由 Claude Code 自动管理，用来存储 UI 状态、会话缓存、登录信息，以及所有你曾操作过的项目路径和标识。其条目以项目的绝对路径建立索引，记录了项目的唯一 ID（通过路径哈希生成）及相关元数据。
C:\Users\Administrator\.claude\settings：行为配置目录。这是你进行个性化配置的 主要位置，实际上这里存放的是 settings.json 配置文件。它与 .claude.json 在功能上毫无关系。负责管理 Claude Code 的所有行为设置，如权限、环境变量、模型选择等。

项目	`C:\Users\Administrator\.claude.json`	`C:\Users\Administrator\.claude\settings.json`
身份	单一文件	目录中的配置文件
核心功能	存储状态：UI 状态、会话、登录信息、项目索引	定义行为：权限、环境变量、钩子等规则
能否手动编辑	不推荐（状态文件，手动编辑风险高）	可以（主配置文件）
主要用途	内部使用	个性化配置

4.2 作用域与优先级 #

作用域	文件路径	用途	是否提交Git
👤 用户级	`%USERPROFILE%\.claude\settings.json`	个人全局规则：应用于所有项目的个人基础配置。	否
📁 项目级	`项目目录\.claude\settings.json`	团队共享规则：供团队所有成员共享的配置。	是
✍️ 本地覆盖	`项目目录\.claude\settings.local.json`	个人临时覆盖：用于个人实验或临时调整的配置，会覆盖同目录下的 `settings.json`。	否

当你在项目中配置 settings.local.json 时，其中的规则会拥有最高优先级，确保你的个人工作流不被团队配置干扰。

导航菜单