Skip to content

Claude Code 配置教程 ​

安装并配置 Claude Code CLI 工具,连接 Coding Flow 平台。

Claude Code 是 Anthropic 官方 CLI 工具,强大的 AI 编程助手。本教程将引导你完成安装和配置。

开始前请先完成 Node.js 环境安装教程。

你需要准备

  • 一个可用的 API Key(形如:sk-******)
  • 一个可访问的 服务地址(Base URL)(通常由部署方/网关提供)

本站通用服务地址

第一步:安装 Claude Code ​

打开终端(Windows 使用 PowerShell 或 CMD),运行以下命令:

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

这个命令会从 npm 官方仓库下载并安装最新版本的 Claude Code。

如果在 macOS / Linux 上遇到权限问题,可以使用 sudo:

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

验证安装

安装完成后,输入以下命令检查,如果显示版本号,说明安装成功了!

Bash
claude --version

第二步:项目配置 ​

1. 全局配置 ​

Windows
# 创建 C:\Users\<你的用户名>\.claude\settings.json 并添加以下内容:
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
  }
}
Linux
# 创建 settings.json
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
  }
}
EOF
macOS
# 创建 settings.json
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
  }
}
EOF

2. 项目内配置 ​

在你的项目根目录下创建一个 .claude 目录,并在该目录下创建 settings.json 文件。 然后配置 settings.json 文件。将ANTHROPIC_AUTH_TOKEN替换为您的API密钥,ANTHROPIC_MODEL替换为您需要的模型

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.codingflow.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
  }
}

3. 跳过登陆验证 ​

该配置将会绕过Claude的登陆验证,可以直接使用Claude Code。

在 ~/.claude.json 文件的最外层大括号内,找到合适的位置添加配置项:"hasCompletedOnboarding": true。

Windows
# 编辑 C:\Users\<你的用户名>\.claude.json
{
  // ... 其他配置
  "hasCompletedOnboarding": true
}
Linux
# 编辑 ~/.claude.json
{
  // ... 其他配置
  "hasCompletedOnboarding": true
}
macOS
# 编辑 ~/.claude.json
{
  // ... 其他配置
  "hasCompletedOnboarding": true
}

重要提示

请将 YOUR_API_KEY 替换为在 Coding Flow平台 申请的 API Key。

以上配置参数说明

  • ANTHROPIC_BASE_URL: 模型提供者的 API 地址,固定设置为 https://api.codingflow.ai。
  • ANTHROPIC_AUTH_TOKEN: 认证密钥,此处为 YOUR_API_KEY。
  • ANTHROPIC_MODEL: 模型名称。
  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 强制禁用所有实验性 Beta 功能。

详细参数信息可参考:Claude Code 参数配置

第三步:开始使用 ​

Bash
claude

常见问题 ​

Q: context_management: Extra inputs are not permitted ​

A: 在配置文件中配置 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: 1,强制禁用所有实验性 Beta 功能。


Q: ValidationException: prompt is too long: 1004239 tokens > 1000000 maximum ​

A: 在配置文件中配置 CLAUDE_CODE_AUTO_COMPACT_WINDOW: 1000000,自动压缩上下文窗口,避免超出最大 token 数限制。