Claude Code

概述

类型: 编码工具主要路径: Anthropic-native支持级别: 强原生路径

Claude Code 是 Anthropic 官方提供的用于 AI 辅助编码的 CLI 工具。你可以将其配置为使用 AI Sonar 作为 API 提供方。

安装

Anthropic 现在推荐使用原生安装程序。出于兼容性考虑，npm 安装方式仍然可用，但Anthropic 已将其弃用。

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

如果你明确需要 npm 包，请使用：

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

不要对 Claude Code 使用 sudo npm install -g。

配置

环境变量

设置以下环境变量：

export ANTHROPIC_API_KEY="sk-your-api-key"
export ANTHROPIC_BASE_URL="https://api.aisonar.dev"

将这些添加到你的 shell 配置文件（~/.bashrc、~/.zshrc 等）中，以便持久生效。

对于 AI Sonar，请将 ANTHROPIC_BASE_URL 保持为 https://api.aisonar.dev，不要添加 /v1 后缀。这与 Claude Code 文档中记录的 Anthropic 风格端点结构以及统一网关模式保持一致。

配置文件

或者，创建或编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.aisonar.dev"
  }
}

用法

完成配置后，即可像平常一样使用 Claude Code：

# Start an interactive session
claude

# Run a single command
claude "Explain this code" < main.py

# Chat mode
claude chat

如有需要，可验证安装是否成功：

claude --version
claude doctor

可用模型

AI Sonar 支持所有 Claude 模型：

模型	描述
`claude-opus-4-6`	能力最强，适合复杂推理
`claude-sonnet-4-6`	性能均衡，非常适合编码
`claude-haiku-4-5`	速度最快，性价比高

模型选择

使用 --model 标志指定模型：

claude --model claude-sonnet-4-6 "Review this PR"

或者在配置中设置默认模型：

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.aisonar.dev"
  },
  "model": "claude-sonnet-4-6"
}

扩展思考

对于复杂推理任务，请使用支持扩展思考的模型：

claude --model claude-opus-4-6 "Design a microservices architecture for..."

故障排查

连接错误

请确认 base URL 精确为 https://api.aisonar.dev（对于 Anthropic 风格请求，不要添加 /v1 后缀）。

无效的 API key

请确保你的 AI Sonar API key 以 sk- 开头，并且余额充足。

网关需要 Authorization bearer token

Claude Code 的网关模式也支持 ANTHROPIC_AUTH_TOKEN。对于标准的 AI Sonar 配置，请继续使用 ANTHROPIC_API_KEY，除非你有意切换了网关认证行为。

找不到模型

请检查模型名称是否正确。请使用 claude-sonnet-4-6 这种格式。

兼容性矩阵

编码工具

原生 SDK

框架与平台

聊天应用

概述

安装

配置

环境变量

配置文件

用法

可用模型

模型选择

扩展思考

故障排查

​概述

​安装

​配置

​环境变量

​配置文件

​用法

​可用模型

​模型选择

​扩展思考

​故障排查

概述

安装

配置

环境变量

配置文件

用法

可用模型

模型选择

扩展思考

故障排查