跳转到主要内容
在 Tokensmind 中使用 Claude Code

快速开始

本指南将帮助您在几分钟内使用由 Tokensmind 提供的 Claude Code.

1. 安装 Claude Code

本地安装

使用 npm 安装

需要 Node.js 18 或更高版本

2. 配置 Tokensmind API

要通过兼容 Anthropic API 的方式来接入 Tokensmind 的模型服务,需要配置以下环境变量。
  1. ANTHROPIC_BASE_URL 设置为https://tokensmind.ai
  2. ANTHROPIC_AUTH_TOKEN 设置为从 Tokensmind 平台 获取的 API Key
  3. ANTHROPIC_MODEL:设置为模型列表中支持的模型。
  1. 在终端中执行以下命令,查看默认 Shell 类型。
  1. 根据 Shell 类型设置环境变量,命令如下:
  1. 在终端中执行下列命令,使环境变量生效。
  1. 打开一个新的终端,执行下列命令,查看环境变量是否生效。

3. 开始使用

完成配置后,进入你的工作目录,在终端运行 claude 命令开始使用 Claude Code。
初次使用 Claude Code 时,可能会强制要求登录 Anthropic 账户。请按以下步骤操作以跳过该流程: Cc 7
  1. 定位用户主目录下的 .claude.json 文件,具体路径如下:
    • macOS / Linux: ~/.claude.json
    • Windows: C:\Users\%USERNAME%\.claude.json
  2. 设置hasCompletedOnboarding 字段的值为 true
  1. 保存文件,然后在终端中重新运行 claude

(可选)更多配置模型的方式

Claude Code 支持以下模型配置方式,按优先级从高到低排列,优先级高的配置会覆盖优先级低的配置。
  1. 对话期间: 执行/model <模型名称>命令切换模型。适用于临时切换模型。
  1. 启动 Claude Code 时: 执行claude --model <模型名称>指定模型。适用于单次会话。
  1. 设置环境变量:可按任务复杂度配置不同级别的模型,Claude Code 会根据任务类型自动选择合适的模型。适用于全局生效。
其中:
  • ANTHROPIC_DEFAULT_OPUS_MODEL:用于复杂推理、架构设计等高难度任务。
  • ANTHROPIC_DEFAULT_SONNET_MODEL:用于代码编写、功能实现等日常任务。
  • ANTHROPIC_DEFAULT_HAIKU_MODEL:用于语法检查、文件搜索等简单任务。
  1. 在 setting.json 配置文件中永久设置:在项目根目录或用户主目录创建settings.json文件,并写入模型配置信息,可分别进行项目级或用户级的永久配置。

通过 cc-switch 配置

  1. 运行 CC-Switch,点击「添加供应商」。
  1. 在预设列表中选择「自定义配置」。
  1. 在「API Key」栏中填写你的密钥和请求地址
  1. 配置完成后,点击「添加」保存设置。
  1. 返回首页,在供应商列表中选择「tokensmind」,点击「启动」即可使用。

通过 VS Code 插件配置

  1. 运行 VS Code,安装插件。
I Shot 2026 03 25 11 44 03
  1. 按下 Ctrl + Shift + P (或 Cmd + Shift + P),输入 Settings 打开设置。
I Shot 2026 03 25 11 47 48
  1. 搜索 Claude Code ,找到 Claude Code: Environment VariableEdit in settings.json
I Shot 2026 03 25 11 49 37
  1. claudeCode.environmentVariables 中填入 Tokensmind 相关信息。
I Shot 2026 03 25 11 53 07

常见问题

Q:在 Claude Code 中使用,提示「401 , No token provided…」

打开 Claude 终端,输入 /config ,找到 Use custom API key 选项,检查 Token 是否正确配置。 install

Q:macOS 中安装成功后仍然报错:zsh: command not found: claude

这是因为 Claude CLI 已安装,但其可执行目录未加入系统 PATH
  1. 确认 Claude 安装路径。Claude Code 官方脚本通常安装在以下目录之一:
  • ~/.claude/bin
  • ~/.local/bin
在终端执行:
如果看到 claude 文件,说明安装成功,只是 PATH 未配置。
  1. 将安装目录加入 PATH。根据实际安装位置执行对应命令:
情况 A:安装在 ~/.claude/bin
情况 B:安装在 ~/.local/bin
  1. 验证是否生效。执行:
若能看到 claude 路径及版本号,说明安装成功。

Q:Claude Code 无法连接 Anthropic 服务

升级到最新版本的 Claude Code 后,若出现无法连接 Anthropic 服务或认证失败的情况,通常是由于认证请求头名称已发生调整所致。新版本要求将请求头由 ANTHROPIC_API_KEY 修改为 ANTHROPIC_AUTH_TOKEN,API Key 的值无需更换,仅需更新请求头名称并重新加载配置即可。具体操作可参考本文档重新配置。

Q: Login:API Error: 403

cc升级到最新版,并且关闭ccs的本地代理跟故障转移功能 祝你使用愉快!