Anthropic · 工具文档

Claude Code

本文说明 Claude Code 的安装、清理配置文件、填写配置文件。若你曾使用过 Claude Code 相关产品，请先完成下方清理，再继续安装配置。

1 清理旧配置 2 安装 CLI / 插件 3 用 cc-switch 填写配置

安装前必读如果你使用过 Claude Code CLI或 VS Code 的 Claude Code 插件，请先到用户目录下的 .claude 文件夹中，清空 settings.json 文件的内容（或删除后由程序重建）。旧的鉴权与配置容易导致登录失败、配置冲突或连到错误环境。

如果你未使用过上述产品，可跳过清理步骤，直接前往安装。

清理旧配置

重要清空前请务必备份相关文件（复制到其他目录或改名保存），以免需要时无法恢复。

.claude 一般位于用户主目录（Home）下。不同系统路径如下：

系统	典型路径
Windows	`C:\Users\你的用户名\.claude\`
macOS / Linux	`~/.claude/`

需要处理的文件

settings.json — Claude Code 配置 / 设置

请将 settings.json 内容清空（保留空文件亦可），或直接删除它；后续重启使用时会重新生成。

提示若目录中还有其他缓存文件，一般不必动；重点是清掉 settings.json，避免旧账号或旧配置干扰本次配置。

安装

完成上方清理后，可按需安装以下任一形态（可只装一种，也可多种并存）。安装前请确认本机已具备对应运行环境。Claude Code 无需安装桌面端。

安装 CLI

注意使用官方安装方式前，请确认本机可以正常访问外网（含下载安装脚本与拉取安装包）。网络受限、需代理或无法访问官方域名时，请改用 npm 等方式，或先配置好代理后再执行。

推荐使用官方原生安装（无需 Node.js，安装后会自动后台更新）：

macOS / Linux / WSL：

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

Windows（PowerShell）：

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

Windows（CMD）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

也可使用 npm 全局安装（需本机已安装 Node.js 与 npm）：

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

macOS / Linux 还可使用 Homebrew：

brew install --cask claude-code

Windows 还可使用 WinGet：

winget install Anthropic.ClaudeCode

安装完成后，在终端执行以下命令检查是否可用：

claude --version

安装 VS Code 插件

打开 VS Code（或兼容的 Cursor 等编辑器，若团队允许）。
打开扩展面板：快捷键 Ctrl + Shift + X（macOS 为 Cmd + Shift + X）。
搜索 Claude Code for VS Code（发布者一般为 Anthropic）。
点击 安装（Install），等待安装完成。

填写配置文件

开始配置前如果你曾使用过 Claude Code CLI / 插件，必须先按上文清理旧配置 清空配置文件，同时请 关闭 Claude Code CLI / 插件，再进行后续配置。

强烈推荐使用可视化配置软件 cc-switch 进行配置，操作更直观、不易写错。下载地址： https://github.com/farion1231/cc-switch/tags

使用 cc-switch 配置

提示请尽量使用 Edge 或 谷歌浏览器（Chrome） 打开官网进行后续操作。其他浏览器可能出现调用 cc-switch 失败的情况。

安装成功后，启动 cc-switch。
打开官网 https://aiapi.317ak.com/ ，登录你的账号。
登录成功后，点击 控制台。
在页面左侧选择 API 密钥。
在页面右侧点击 创建 API 密钥。
在创建 API 密钥页面：
- 名称：随意填写即可。
- 分组：必须选择 kiro-claude 分组（务必选对，否则无法正常使用）。
- 其他配置不要改动，保持默认。
确认无误后，点击 保存更改，并妥善保存生成的密钥。
在密钥列表中，点击当前令牌后方的 三个点（⋯），在弹框中选择 CC-Switch。
在随后出现的弹窗中：
- 选择 Claude Code（一定不要选错，否则配置会写入错误产品）。
- 名称：随意填写即可。
- 主模型：选择你想调用的模型。例如想使用 claude-opus-4.6，则选择对应模型即可。
  - Haiku 模型：选择你想使用的模型或者留空都可以。
  - Sonnet 模型：选择你想使用的模型或者留空都可以。
  - Opus 模型：选择你想使用的模型或者留空都可以。
填写完成后，点击 打开 CC Switch。

提示如果点击 打开 CC Switch 后未跳转，请点击此处查看下方手动配置教程。

此时 cc-switch 会出现弹窗，点击弹窗右下角的导入。
导入成功后，打开 Claude Code CLI / Claude Code 插件 即可使用。

手动配置（打开 CC Switch 未跳转时）

若点击 打开 CC Switch 后没有自动跳转，可按下列步骤在 cc-switch 中手动完成配置。

手动打开 cc-switch。
选择顶部 Claude Code 图标。
点击右上角 + 号。
在配置 JSON 中填写以下内容（其他设置不懂的话无需填写；请将 ANTHROPIC_AUTH_TOKEN 替换为你自己的 API 密钥）：
```
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API密钥",
    "ANTHROPIC_BASE_URL": "https://aiapi.317ak.com",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_MODEL": "claude-opus-4-6",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "DISABLE_TELEMETRY": "1"
  },
  "verbose": true
}
```
- ANTHROPIC_MODEL：主模型，选择你想调用的模型。例如想使用 claude-opus-4-6，则填写 claude-opus-4-6 即可。
- ANTHROPIC_DEFAULT_HAIKU_MODEL：Haiku 模型，选择你想使用的模型或者留空都可以。
- ANTHROPIC_DEFAULT_SONNET_MODEL：Sonnet 模型，选择你想使用的模型或者留空都可以。
- ANTHROPIC_DEFAULT_OPUS_MODEL：Opus 模型，选择你想使用的模型或者留空都可以。
- CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC：关闭非必要网络请求（如自动检查更新等），设为 "1" 表示关闭。
- DISABLE_ERROR_REPORTING：关闭错误上报，设为 "1" 表示不向官方发送错误报告。
- DISABLE_TELEMETRY：关闭遥测，设为 "1" 表示不收集使用数据。
填写完成后，点击保存。
保存成功后，点击启用。

上一篇 ← Codex 下一篇 Grok Build →