Claude Code

Q: 启动后仍然要求登录怎么办？

把 ANTHROPIC_AUTH_TOKEN 放在 Claude Code 首次运行前就会读取的位置：~/.claude/settings.json 或 shell 环境变量（项目内 .claude/settings.json 要在首次引导完成后才生效）。使用 CC-Switch 时打开「跳过 Claude Code 初次安装确认」。

Q: 提示 401 错误？

密钥错误、已删除，或写在了错误的变量里。请在 Portal「API 密钥」中核对，并确认写在 ANTHROPIC_AUTH_TOKEN 中。

Q: 请求报 404 或连接失败？

ANTHROPIC_BASE_URL 只填域名，不要带 /v1 或 /v1/messages。可用上文的 curl 命令测试地址是否可达。

Q: Claude Code 能用非 Claude 模型吗？

可以。设置 ANTHROPIC_MODEL，或在会话中输入 /model glm-5.2 等 Portal「AI 中心」里的模型 ID，Codelux 会完成协议转换。

Q: VS Code 插件怎么配置？

在 VS Code 用户设置的 claudeCode.environmentVariables 中添加同样的两个变量，详见官方网关文档。

Q: 报 400 错误，提示有无法识别的字段？

在 env 中加入 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1，让 Claude Code 不再发送预发布字段。

Claude Code 是 Anthropic 推出的官方 Agent，可以在终端、VS Code / JetBrains、桌面应用和浏览器中使用。它能读懂整个代码库，跨多个文件修 Bug、写测试、做持续数天的迁移，也能执行命令、创建 Git 提交，并通过 MCP 连接外部工具。

注册并进入 Portal 查看接入教程

已有账号？登录

codelux.config示意

agent: claude-code
endpoint: codelux.io/v1/messages
route: anthropic / claude-sonnet-5
status: 可用

Claude Code

Codelux Gateway

claude-sonnet-5
claude-opus-5-5
gpt-6-sol
DeepSeek-V41-Flash
kimi-k3
glm-5.3

示意：Claude Code 通过 codelux.io/v1/messages 连接 Codelux Gateway，选用 anthropic / claude-sonnet-5。同一个 Agent 可以切换使用 claude-sonnet-5、claude-opus-5-5、gpt-6-sol、DeepSeek-V41-Flash、kimi-k3、glm-5.3 等模型。

Claude Code 接入 Codelux 教程

整个过程约 10 分钟：安装 Claude Code → 在 Portal 创建密钥 → 用 CC-Switch 一键导入（或手动写入 settings.json）→ 启动并切换模型。

一、安装 Claude Code

官方推荐原生安装，会在后台自动更新；也可以用 Homebrew、WinGet 或 npm。

确认系统要求

项目	要求
操作系统	macOS 13.0+ · Windows 10 1809+ / Server 2019+ · Ubuntu 20.04+ · Debian 10+ · Alpine 3.19+
硬件	4 GB 以上内存，x64 或 ARM64 处理器
Shell	Bash、Zsh、PowerShell、CMD
网络	需要联网；通过 Codelux 调用模型时，模型请求发往 Codelux

运行安装命令

终端

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

PowerShell

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

提示符显示 PS C:\ 说明你在 PowerShell 中；无需管理员权限。建议同时安装 Git for Windows，让 Claude Code 可以使用 Bash 工具。

CMD

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

终端

brew install --cask claude-code

Homebrew 安装不会自动更新，之后用 brew upgrade claude-code 升级。

PowerShell

winget install Anthropic.ClaudeCode

终端

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

npm 方式需要 Node.js 22 或更高版本；不要使用 sudo npm install -g。

验证安装

打开一个新的终端窗口，运行：

终端

claude --version
claude doctor

正常会打印版本号，例如 2.1.211 (Claude Code)。claude doctor 会检查安装状态和设置文件。如果提示 command not found，重新打开终端，或按官方安装排错检查 PATH。

二、配置 Codelux 为第三方 Provider

Claude Code 通过 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 连接网关。推荐用 CC-Switch 一键写入，也可以手动编辑 ~/.claude/settings.json。

注册 Codelux 并创建 API 密钥

打开 Codelux Portal 注册账号（已有账号直接登录）。
在「财务中心」选择订阅套餐或按需充值——余额对所有 Agent 通用。
在左侧菜单进入「API 密钥」，点击「新建密钥」，名称建议写成对应 Agent 的名字，方便以后区分用量。
创建成功后，复制「API 密钥」（以 sk- 开头）和「API 地址」。密钥只完整显示一次，请妥善保存。

安装 CC-Switch

CC-Switch 是开源（MIT）的桌面应用，统一管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的 API 供应商，自动写入各工具的配置文件，免去手动编辑。系统要求：Windows 10 及以上、macOS 12 及以上，或 glibc 2.35+ 且带 WebKitGTK 4.1 的 Linux x86_64/ARM64（如 Ubuntu 22.04+、Debian 12+）。

推荐使用 Homebrew 安装：

终端

brew install --cask cc-switch

也可以在 Releases 下载 CC-Switch-v{版本号}-macOS.dmg。这是通用包（Apple Silicon 与 Intel 均可运行），已通过 Apple 签名与公证。

在 Releases 下载 CC-Switch-v{版本号}-Windows.msi 安装包（或 -Windows-Portable.zip 绿色版）并运行。ARM 版 Windows 请下载 -Windows-arm64 对应文件。

在 Releases 按架构下载 .deb（Debian/Ubuntu）、.rpm（Fedora 等）或 .AppImage。以 Ubuntu 为例：

终端

sudo apt install ./CC-Switch-v*-Linux-x86_64.deb

Arch Linux 可使用 paru -S cc-switch-bin。

CC-Switch 主界面，列出 Claude Code 的供应商 — CC-Switch 主界面：顶部选择要配置的工具，再启用对应供应商；右上角橙色「+」用于添加新供应商。

从 Portal 一键导入到 CC-Switch

保持 CC-Switch 运行（首次启动时会注册 ccswitch:// 链接）。
回到 Portal 刚创建密钥的成功页，找到「导入到桌面客户端」区域（仅在电脑浏览器中显示）。
在 CC-Switch 卡片中把「目标应用」选为「Claude Code」，点击「一键导入」。
浏览器提示打开 CC-Switch 时选择允许。CC-Switch 会弹出确认框，显示供应商名称（Codelux）、端点和密钥，确认后完成添加。
在 CC-Switch 顶部切换到「Claude Code」，确认「Codelux」供应商已启用。

也可以手动添加：在 CC-Switch 点击右上角橙色「+」→「自定义配置」，依次填写「供应商名称」（如 codelux.io）、「官网链接」https://codelux.io、「API Key」和「请求地址」（Codelux API 地址，不要以斜杠结尾），点击「添加」。

CC-Switch 添加新供应商表单，已填写 Codelux 的供应商名称、官网链接、API Key 与请求地址 — 在 CC-Switch 中手动添加 Codelux。Claude Code 的请求地址只填域名，不要以斜杠结尾。

如果 Claude Code 首次启动时仍要求登录或显示初始化引导，在 CC-Switch「设置 → 通用」中打开「跳过 Claude Code 初次安装确认」，再重新启动 Claude Code。该选项会在 ~/.claude.json 写入 hasCompletedOnboarding: true。

CC-Switch 设置页，“跳过 Claude Code 初次安装确认”开关已打开 — CC-Switch「设置 → 通用」中的“跳过 Claude Code 初次安装确认”。 · CC-Switch 用户手册 (MIT)

（可选）手动配置 settings.json

不使用 CC-Switch 时，把下面的 env 块写入用户设置文件，所有项目都会生效：

系统	文件路径
macOS / Linux / WSL	`~/.claude/settings.json`
Windows	`%USERPROFILE%\.claude\settings.json`

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://codelux.io",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Codelux密钥",
    "ANTHROPIC_MODEL": "claude-sonnet-5"
  }
}

ANTHROPIC_BASE_URL：Codelux 的 API 地址，不要带 /v1，Claude Code 会自动拼接 /v1/messages。
ANTHROPIC_AUTH_TOKEN：你的 Codelux API 密钥，以 Authorization: Bearer 方式发送。
ANTHROPIC_MODEL（可选）：默认模型，可填 Portal「AI 中心」里的任意模型 ID，例如 claude-opus-4-8、glm-5.2。

只想在当前终端临时使用，也可以导出环境变量：

终端

export ANTHROPIC_BASE_URL=https://codelux.io
export ANTHROPIC_AUTH_TOKEN=sk-你的Codelux密钥

PowerShell

$env:ANTHROPIC_BASE_URL = "https://codelux.io"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的Codelux密钥"

（可选）用 curl 测试连通性

在已导出上述变量的终端中运行，返回以 {"id":"msg_ 开头的 JSON 即表示地址和密钥都正确：

终端

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "hi"}]}'

返回 401 说明密钥不对或已被删除，请回到 Portal 检查。

三、开始使用

在项目目录启动 Claude Code，确认已连到 Codelux，然后按需切换模型。

启动并确认连接

终端

cd your-project
claude

进入会话后输入 /status，在「Status」页确认：

Anthropic base URL 显示 https://codelux.io，说明请求已发往 Codelux；
认证一行显示 ANTHROPIC_AUTH_TOKEN，说明正在使用 Codelux 密钥而不是 claude.ai 登录。

然后随便发一句话（例如“介绍一下这个项目”），能正常回复即配置完成。

切换模型

在会话中输入 /model 打开模型选择器，或直接在后面加上模型 ID：

Claude Code 会话

/model claude-opus-4-8
/model glm-5.2
/model deepseek-v4-flash

通过 CC-Switch 或 ANTHROPIC_MODEL 设置的是默认模型；/model 的选择会保存为新会话的默认值。切换模型后第一条请求会重新读取整个对话，不命中缓存。

常用操作

命令	作用
`/init`	扫描项目并生成 `CLAUDE.md` 项目说明
`/status`	查看 API 地址、凭证来源与已加载的设置文件
`/model`	切换当前及新会话的模型
`/compact`	压缩长对话，释放上下文
`claude -p "..."`	不进入交互界面直接执行一次任务（适合脚本与 CI）
`claude doctor`	诊断安装与设置问题

每次请求的模型、tokens 和扣费可以在 Portal「使用日志」中查看。

常见问题

启动后仍然要求登录怎么办？

把 ANTHROPIC_AUTH_TOKEN 放在 Claude Code 首次运行前就会读取的位置：~/.claude/settings.json 或 shell 环境变量（项目内 .claude/settings.json 要在首次引导完成后才生效）。使用 CC-Switch 时打开「跳过 Claude Code 初次安装确认」。

提示 401 错误？

密钥错误、已删除，或写在了错误的变量里。请在 Portal「API 密钥」中核对，并确认写在 ANTHROPIC_AUTH_TOKEN 中。

请求报 404 或连接失败？

ANTHROPIC_BASE_URL 只填域名，不要带 /v1 或 /v1/messages。可用上文的 curl 命令测试地址是否可达。

Claude Code 能用非 Claude 模型吗？

可以。设置 ANTHROPIC_MODEL，或在会话中输入 /model glm-5.2 等 Portal「AI 中心」里的模型 ID，Codelux 会完成协议转换。

VS Code 插件怎么配置？

在 VS Code 用户设置的 claudeCode.environmentVariables 中添加同样的两个变量，详见官方网关文档。

报 400 错误，提示有无法识别的字段？

在 env 中加入 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1，让 Claude Code 不再发送预发布字段。

Claude Code

Claude Code 接入 Codelux 教程

一、安装 Claude Code

1确认系统要求

2运行安装命令

3验证安装

二、配置 Codelux 为第三方 Provider

4注册 Codelux 并创建 API 密钥

5安装 CC-Switch

6从 Portal 一键导入到 CC-Switch

7（可选）手动配置 settings.json

8（可选）用 curl 测试连通性

三、开始使用

9启动并确认连接

10切换模型

11常用操作

常见问题

官方参考资料

确认系统要求

运行安装命令

验证安装

注册 Codelux 并创建 API 密钥

安装 CC-Switch

从 Portal 一键导入到 CC-Switch

（可选）手动配置 settings.json

（可选）用 curl 测试连通性

启动并确认连接

切换模型

常用操作