跳到主要内容
feedback
feedback

Claude Code

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

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

安装 Claude Code​

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

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

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

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

验证 Claude Code 安装​

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

claude --version

获取访问令牌​

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

访问令牌页面

手动配置接入凭证​

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

配置文件内容在不同操作系统上相同，只是文件位置不同：

  • macOS / Linux：~/.claude/settings.json
  • Windows：C:\Users\<用户名>\.claude\settings.json

在对应位置新建或编辑 settings.json，在原有 JSON 对象中添加或更新 env 字段：

{
  "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"
  }
}

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

CC Switch 是一款可集中管理 Claude Code 等 AI 编程工具的服务商、API Key 和模型映射的桌面应用，并支持一键切换配置。

在 CC Switch 中选择 Claude Code，添加并启用模力方舟供应商配置即可。包含下载安装、访问令牌、请求地址、模型映射及验证的完整操作，请参阅 CC Switch 快速配置。

Claude Code 的请求地址、上游格式和模型参数，可通过 工具配置参考 快速获取。

启用后，在 Claude Code 中输入 /model，再选择 sonnet 等已映射角色即可使用对应模型。

开始使用 Claude Code​

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

claude

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

更多资源​

常见故障排查与升级​

  • 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 选择已配置的映射角色。
Copyright © 2026 模力方舟京ICP备2025119063号京公网安备11011502039387号京公网安备11011502039387号