跳到主要内容
feedback
feedback

Claude Code

Claude Code 是 Anthropic 推出的 AI 编程助手工具。跟着这个教程，你可以轻松在自己的电脑上安装并使用 Claude Code。

提示

模力方舟提供对 Claude Code 的原生支持，你可以使用模力方舟的任一编码模型，享受更优质的中文支持和更低的调用成本。

1. 安装 Claude Code​

Claude Code 是在终端中运行的 CLI 工具。下面的命令安装的是 Claude Code 命令行版本，而不是独立的桌面 GUI 客户端。

原生安装​

原生安装不需要提前安装 Node.js，并且会在后台自动更新 Claude Code。请根据自己的操作系统和终端选择对应命令：

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

Windows 原生运行 Claude Code 时，Git for Windows 不是必需项，但推荐安装：安装后 Claude Code 可以使用 Git Bash；未安装时则使用 PowerShell 执行 Shell 命令。WSL 用户不需要安装 Git for Windows。

其他安装方式​

除了原生安装，也可以使用系统包管理器：

npm 安装方式需要 Node.js 22 或更高版本。请先从 Node.js 官方下载页面 安装 Node.js，推荐选择 LTS 版本：

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

请勿使用 sudo npm install -g，否则可能引发权限和安全问题。升级 npm 安装版本时，请运行：

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

安装方式和系统要求可能随版本更新，最新信息请以 Claude Code 官方安装文档 为准。

验证 Claude Code 安装​

安装完成后，重新打开终端并运行：

claude --version

2. 获取访问令牌​

开发者首先需要访问 工作台->设置->访问令牌 中获取访问令牌，没有购买 Serverless API 的开发者，可以使用免费体验访问令牌（仅供体验，每日调用次数有限），复制想要使用的令牌即可。

访问令牌页面

3. 配置环境变量​

为了让 Claude Code 连接到我们的服务，需要设置相关环境变量。Claude Code 按 Opus、Sonnet 和 Haiku 角色选择模型；以下将三个角色均映射到模力方舟的 deepseek-v4-flash-0731。

临时设置（当前会话）​

export ANTHROPIC_BASE_URL="https://ai.gitee.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的 API 密钥"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-flash-0731"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash-0731"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash-0731"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="true"

永久设置​

将以下内容添加到 ~/.bashrc 或 ~/.zshrc 文件中：

export ANTHROPIC_BASE_URL="https://ai.gitee.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="你的 API 密钥"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-flash-0731"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-flash-0731"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash-0731"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="true"

然后重新加载配置文件：

# 如果使用 bash
source ~/.bashrc

# 如果使用 zsh
source ~/.zshrc

验证环境变量设置​

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN
echo $ANTHROPIC_DEFAULT_OPUS_MODEL
echo $ANTHROPIC_DEFAULT_SONNET_MODEL
echo $ANTHROPIC_DEFAULT_HAIKU_MODEL
echo $CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC

重要提示：记得将 "你的 API 密钥" 替换为在上方 "获取访问令牌" 步骤中获取的实际密钥。

预期输出示例：

https://ai.gitee.com/anthropic
你的 API 密钥
deepseek-v4-flash-0731
deepseek-v4-flash-0731
deepseek-v4-flash-0731
true
提示

如果输出为空或显示变量名本身，说明环境变量设置失败，请重新设置。设置后需要重新打开终端窗口才能生效。

手动使用 settings.json 配置​

除环境变量外，也可以将配置写入 Claude Code 的 settings.json。如果文件已存在，请在原有 JSON 对象中添加或更新 env 字段，避免覆盖其他设置。

在 ~/.claude/settings.json 中添加：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.gitee.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的 API 密钥",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash-0731",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash-0731",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash-0731",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "true"
  }
}

在 WSL 中运行 Claude Code 时，使用 WSL 发行版内的 ~/.claude/settings.json，不要使用 Windows 用户目录下的配置文件。

保存后完全退出并重新启动 Claude Code。

验证 Claude Code 配置​

启动 Claude Code 后，依次输入以下命令：

/status
/model
  • /status 用于查看当前会话状态；如果认证或连接异常，请先检查 API 密钥与请求地址。
  • /model 用于确认或选择模型。手动配置时应使用 deepseek-v4-flash-0731；使用 CC Switch 时，请选择映射角色，例如 /model sonnet。

使用 CC Switch 自动配置（推荐）​

CC Switch 是社区开源的桌面 GUI，可以集中管理 Claude Code 等 AI 编程工具的服务商、API Key 与模型映射，并在不同配置之间一键切换。

下载并安装 CC Switch​

前往 CC Switch 官方 Releases 下载最新版本，并选择与你的系统对应的安装包：

  • Windows：下载并安装 .msi 文件。
  • macOS：下载 .dmg 文件，或执行 brew install --cask cc-switch。
  • Linux：下载适用于发行版的 .deb、.rpm 或 .AppImage 文件。

如需查看其他安装方式，请参考 CC Switch 官方安装说明。

下面以模力方舟的 deepseek-v4-flash-0731 模型为例：

  1. 打开 CC Switch，在顶部应用列表中选择 Claude Code。

  2. 点击 添加供应商，选择 自定义配置，填写以下基础信息：

    • 供应商名称：填写 模力方舟 - deepseek-v4-flash-0731。
    • 备注：可填写 模力方舟访问令牌。
    • 官网链接：可填写 https://ai.gitee.com。
    • API Key：粘贴上一步获取的模力方舟访问令牌。
    • 请求地址：填写 https://ai.gitee.com/anthropic。
    • 完整 URL：保持关闭。

  3. 展开 高级选项，设置接口格式和认证方式：

    • 上游格式：选择 Anthropic Messages（原生）。
    • 认证字段：选择 ANTHROPIC_AUTH_TOKEN（默认）。

  4. 在 模型映射 中填写以下参数：

    模型角色显示名称实际请求模型声明支持 1M
    Sonnetdeepseek-v4-flash-0731deepseek-v4-flash-0731不勾选
    Opusdeepseek-v4-flash-0731deepseek-v4-flash-0731不勾选
    Fabledeepseek-v4-flash-0731deepseek-v4-flash-0731不勾选
    Haikudeepseek-v4-flash-0731deepseek-v4-flash-0731不勾选
    Subagent不显示在 /model 菜单deepseek-v4-flash-0731不勾选

    默认兜底模型填写 deepseek-v4-flash-0731，右侧的 1M 不勾选。默认兜底模型用于处理未明确落到上述角色的请求。

    自定义 User-Agent、Header 覆盖和 Body 覆盖均可留空。

  5. 保存并启用模力方舟供应商配置。

  6. 完全退出并重新启动 Claude Code。在 Claude Code 中输入：

    /model

    CC Switch 会把 sonnet 映射为实际请求模型 deepseek-v4-flash-0731。也可以只输入 /model，再从菜单中选择对应的映射角色。

    Claude Code 模型选择

提示
  • “显示名称”只影响 /model 菜单；真正发送给模力方舟的是“实际请求模型”。请使用 /model sonnet、/model opus 或 /model 模型选择菜单。
  • 配置其他模型时，请从模力方舟模型广场复制准确的模型 ID，并将表格中的 deepseek-v4-flash-0731 替换为该 ID。
  • 请妥善保管访问令牌，不要将包含真实 API Key 的配置文件提交到代码仓库或分享给他人。

4. 开始使用 Claude Code​

配置完成后，你就可以开始使用 Claude Code 了！在任何目录下运行：

claude

这将启动 Claude Code 交互界面，你可以开始与 AI 编程助手进行对话了。

更多资源​

5. 常见故障排查与升级​

  • claude 命令不存在：完全关闭并重新打开终端，再运行 claude --version 检查；如果仍不可用，请重新执行与你的操作系统和终端对应的安装命令。
  • Windows 中 Bash 工具不可用：Claude Code 可以在没有 Git for Windows 的情况下使用 PowerShell；如果需要 Bash 工具，请安装 Git for Windows 并重新启动终端。
  • 认证失败或无法连接：确认 API 密钥有效，并检查请求地址是否为 https://ai.gitee.com/anthropic、上游格式是否为 Anthropic Messages（原生）。
  • 配置未生效：检查 settings.json 路径是否与当前运行环境一致；在 WSL 中运行时，必须使用 WSL 内的 ~/.claude/settings.json。修改配置后请完全退出并重新启动 Claude Code。
  • 模型不存在：确认模型 ID 为 deepseek-v4-flash-0731；若使用 CC Switch，请通过 /model 选择已配置的映射角色。

原生安装版本会在后台自动更新，也可以手动执行：

claude update

完成后运行 claude --version 确认版本。Homebrew、WinGet 和 npm 安装版本请使用前文对应的包管理器升级命令。

Copyright © 2026 模力方舟京ICP备2025119063号京公网安备11011502039387号京公网安备11011502039387号