Claude Code

Claude Code 使用 Anthropic 协议进行通信。接入时需要将接口基础地址指向目标根端点，并将身份凭证设置为在控制台创建的有效 API Key。

1. 配置运行环境变量

在当前终端中临时导出环境变量：

export ANTHROPIC_BASE_URL="https://console.anystarx.com"
export ANTHROPIC_AUTH_TOKEN="sk-..."

部分环境或脚本可能会读取 ANTHROPIC_API_KEY，可同时进行设置：

export ANTHROPIC_API_KEY="sk-..."

2. 持久化 Shell 配置

若需使配置在后续所有新建终端中均保持生效，可将导出语句写入 Shell 配置文件。

zsh 环境：

echo 'export ANTHROPIC_BASE_URL="https://console.anystarx.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.zshrc
source ~/.zshrc

bash 环境：

echo 'export ANTHROPIC_BASE_URL="https://console.anystarx.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-..."' >> ~/.bashrc
source ~/.bashrc

3. 启动与连通性验证

启动 Claude Code 命令行程序：

claude

进入交互界面后，发送一条简单的测试指令验证连通性：

请用一句话确认当前环境已成功连接至 AnyStarX。

4. 指定调用模型

使用的模型标识符需直接从控制台模型列表复制。若当前客户端要求使用 Claude 原生命名格式，在列表中选取对应的模型名称。

不同版本的 Claude Code 支持通过以下方式指定模型：

• 在交互式会话中通过命令切换模型。
• 在本地项目的配置文件中指定默认模型。
• 通过启动命令行参数或环境变量直接指定。

常见问题排查

• 401 Unauthorized：检查 ANTHROPIC_AUTH_TOKEN 是否已正确设置为有效密钥，并在当前终端执行 echo "$ANTHROPIC_AUTH_TOKEN" 确认该变量有输出且未丢失字符。
• 请求仍发送至官方端点：表明 ANTHROPIC_BASE_URL 变量未在当前会话生效，需重新加载配置文件或重启终端。
• 404 路径不存在：检查基础地址配置，避免错误地附加了 /v1/messages 路径。
• 启动后提示登录官方账号：确认当前 Claude Code 版本支持自定义端点模式，部分版本在特定的登录引导流程下会优先校验官方账户。
• 代码任务响应延迟较长：coding agent 执行复杂任务时通常需要自主进行多轮工具调用与上下文分析，可换用响应更快的模型，或在指令中限定只处理特定代码文件。