Claude Code 接入指南

Claude Code 是 Anthropic 官方推出的 AI 编程 CLI 工具。接入 TopsDyne 后，可直接使用主流大模型编程，国内直连、无需科学上网。

配置方法

方式一：环境变量（推荐）

export ANTHROPIC_BASE_URL=https://api.topsdyne.com
export ANTHROPIC_API_KEY=sk-xxx    # 你的 TopsDyne API Key

启动 Claude Code：

claude

方式二：配置文件（免每次 export）

编辑 ~/.claude/settings.json（没有该文件则新建）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.topsdyne.com",
    "ANTHROPIC_API_KEY": "sk-xxx"
  }
}

Claude Desktop 不支持自定义 API 端点，无法接入第三方网关，请勿尝试在 claude_desktop_config.json 中配置。

协议说明

Claude Code 使用 Anthropic 协议：

• Base URL：https://api.topsdyne.com（不要带 /v1）
• 鉴权：x-api-key（工具自动处理，你只需填上面配置）

模型配置

Claude Code 默认请求 claude-sonnet-4-20250514 模型。接入 TopsDyne 后需配置为在售模型：

• 在售模型与型号以控制台模型广场实时展示为准（示例占位：your-model-id）
• 在 Claude Code 的模型设置中，将默认模型改为在售模型 ID

⚠️ 如果报「model not found」，就是默认模型未映射。改为我们的模型 ID 即可。

验证

# 测试连接
echo "Hello, TopsDyne!" | claude --print

# 读项目文件
claude "请读取 README.md 并总结"

# 修改代码
claude "在 src/index.ts 中添加错误处理"

故障排查

现象	处理
401	API Key 错误，或 Base URL 填成了带 /v1
model not found	未配置模型映射，见上文「模型配置」
请求超时	检查网络，模型首包延迟正常

下一步

• Codex CLI 接入 — 另一个编程代理
• 接入协议 — 协议细节
• 常见问题 — 更多问答