Skip to Content
工具接入指南Claude Code接入指南

创建API Key

登录后在 API密钥  页面中创建并复制一个API Key.

自动配置方式（推荐）

复制下面命令并在终端中执行：

curl -fsSL https://www.zlux.ai/install/claude-code.sh | bash -s -- "替换为你的 API Key"

脚本会检测当前网络环境，自动完成环境检查、依赖安装、配置更新等操作。

手动配置

如果自动配置不成功或者更喜欢手动配置的方式，可查看后续的教程。

安装Claude Code

任选一种安装方式

# 安装方式1（需要有node.js环境）
npm install -g @anthropic-ai/claude-code
 
# 安装方式2
curl -fsSL https://claude.ai/install.sh | bash

执行claude -v后，如果能输出claude code的版本号，就说明安装成功了。

移除旧配置

在~/.zshrc或~/.bashrc中 删除 如下环境变量： ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN

如果没有对应文件或没有对应环境变量，说明之前没配置过，就不用处理。

增加新配置

然后创建或打开~/.claude/settings.json，增加如下配置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zlux.ai/claude",
    "ANTHROPIC_API_KEY": "替换为你的 API Key",
  }
}

API 密钥批准与免登录配置~/.claude.json(可选)

API 密钥批准文件存储你的 API 密钥的最后 20 个字符,以记住你在 Claude Code 提示时的批准决定,这样就不用自动选择了。

{
  "hasCompletedOnboarding": true,
  "customApiKeyResponses": {
    "approved": ["last-20-chars-of-key"],
    "rejected": []
  }
}

Claude Code在首次启动时需要你登录Claude官方账号，你如果挂了代理，会弹出登录，如果没挂代理会直接报错: Failed to connect to api.anthropic.com。 为了跳过登录，可以在 ~/.claude.json 中，加入设置："hasCompletedOnboarding": true

开始使用

安装完成后，就可以在任何目录下使用Claude Code:

# 切换到项目目录
$ cd your-project-folder
 
# 启动 Claude Code
$ claude

常见问题

  • claude启动后报错401 invalid code
    备份并删除如下文件 C:\users\你的用户\.claude.json, 然后重启Claude Code，如果让你输出(yes/no)，直接输入 yes 即可。
  • 如果提示 401 authentication_error
    先检查 ANTHROPIC_API_KEY 是否是 Zlux 的 API Key。
  • 提示 Failed to connect to api.anthropic.com
    Claude Code在首次启动时需要你登录Claude官方账号，你如果挂了代理，会弹出登录，如果没挂代理会直接报错: Failed to connect to api.anthropic.com。 为了跳过登录，可以在 ~/.claude.json 中，加入设置："hasCompletedOnboarding": true。注意~/.claude.json文件必须以utf-8的格式进行保存，可以使用Notepad--、vscode等工具进行编辑。
  • 提示额度或频率限制
    检查 Workspace 订阅额度是否可用。
  • 当前终端找不到 claude 命令
    重启终端后再试。
最后更新于