Claude Code 配置教程

安装并配置 Claude Code，通过环境变量连接 云策平台。

Claude Code 是 Anthropic 官方推出的 CLI 编程助手，原生支持 Extended Thinking 深度思考，写代码如自然对话般流畅。它适合项目初始化、跨文件重构、写测试、代码审查等场景。

平台优势

通过 云策接入 Claude Code：专线高速直连、无封号风险、余额永不过期，专为 Claude Code 优化，1 RMB = 1 USD。

前置准备

1. 注册并登录云策：前往 yuncezn.com/register
2. 充值获取额度：前往 yuncezn.com/purchase
3. 获取 API Key：在控制台令牌管理中创建并复制 API Key

第一步：安装 Claude Code

Claude Code 通过 npm 全局安装：

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

验证安装：

claude --version

环境要求

需要 Node.js ≥ 18。若未安装，请参考 Codex 手动配置 - 安装 Node.js。

第二步：配置环境变量

Claude Code 通过环境变量接入云策。将以下环境变量写入你的 shell 配置文件：

macOS / Linux (~/.zshrc 或 ~/.bashrc)

export ANTHROPIC_BASE_URL="https://yuncezn.com"
export ANTHROPIC_AUTH_TOKEN="sk-替换成你的云策密钥"

Windows (PowerShell Profile)

# 添加到 PowerShell 配置文件（运行 notepad $PROFILE 编辑）
$env:ANTHROPIC_BASE_URL = "https://yuncezn.com"
$env:ANTHROPIC_AUTH_TOKEN = "sk-替换成你的云策密钥"

写入后重新加载配置：

macOS / Linux (zsh)

source ~/.zshrc

macOS / Linux (bash)

source ~/.bashrc

Windows (PowerShell)

. $PROFILE

关键字段说明

• ANTHROPIC_BASE_URL：云策的 Anthropic 兼容入口，不要带 /v1 后缀
• ANTHROPIC_AUTH_TOKEN：你的 云策 API Key

第三步：启动并验证

进入项目目录，启动 Claude Code：

cd your-project-folder
claude

建议先执行只读任务验证连通性：

请只读分析当前项目结构，列出主要目录和入口文件，不要修改任何文件。

若能正常返回结果，说明配置成功。

可选：写入配置文件

除环境变量外，也可通过 ~/.claude/settings.json 配置文件接入：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yuncezn.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换成你的云策密钥",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

优先级

环境变量优先于配置文件。若 shell 中已设置环境变量，请先取消设置，配置文件才会生效。

推荐使用场景

场景	适用性
项目初始化	✅ 推荐
跨文件重构	✅ 推荐
编写单元测试	✅ 推荐
代码审查	✅ 推荐
实时补全	⚠️ 建议配合 GitHub Copilot 使用

故障排查

问题现象	解决方案
command not found: claude	npm 全局路径未加入 PATH
401 unauthorized	检查 API Key 是否完整、有无多余空格
404 model not found	确认 ANTHROPIC_BASE_URL 未带 /v1 后缀
本地有返回但后台无日志	重启 CLI；检查环境变量是否覆盖了配置文件

更多问题请参考 常见问题。