> ## Documentation Index
> Fetch the complete documentation index at: https://doc.iqqz.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Claude Code最佳API配置教程指南
Claude Code接入方法：
## 一、安装Node.js
安装Nodejs 需要version >= 18.0.0的版本，[node官网](https://nodejs.org/en/download)
## 二、全局安装claude code
```base theme={null}
npm install -g @anthropic-ai/claude-code
# 查看是否安装成功
claude --version
```
## 三、ApiKey获取
进入网站 [https://api.iqqz.com](https://api.iqqz.com) 进行注册并充值，然后在“令牌管理”页面，复制apikey，后续需要用它来接入Claude code。建议新建令牌->令牌分组选择：`claude_cc`分组，价格比较便宜。
## 四、项目配置
### 1、跳过验证配置
该配置将会绕过Claude的登陆验证，可以直接使用Claude Code。
在 `~/.claude.json` 添加配置项：`"hasCompletedOnboarding": true`，如果该文件不存在，可以手动创建。
看起来像这样：
```json theme={null}
{
// ... 其他配置
"hasCompletedOnboarding": true
}
```
### 2、项目内配置
在你的项目根目录下创建一个 `.claude` 目录，并在该目录下创建 `settings.json` 文件。
然后配置 `settings.json` 文件。将`ANTHROPIC_AUTH_TOKEN`替换为您的API密钥，`ANTHROPIC_MODEL`替换为您需要的模型
> 建议令牌选择 claude\_cc 分组，如果使用 claude 分组 成本会很高
```json theme={null}
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.iqqz.com",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxx",
"ANTHROPIC_MODEL": "claude-sonnet-4-6",
"ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS":1
}
}
```
附上 [Claude Code环境变量大全](https://docs.anthropic.com/zh-CN/docs/claude-code/settings#%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F)
注意：模型只能使用本站cc-、cld-、claude-开头的系列模型、kimi-k2-0711-preview、kimi-k2-0905-preview、qwen3-coder-plus、glm-4.5、glm-4.6模型或本站的claude模型别名。由于其他大语言模型没有agent能力或无法支持Claude特有的参数，并不能处理项目文件的增删改查。因此我们不建议也不支持使用除cc-、cld-、claude系列、kimi、qwen3-coder、glm以外的模型。
我们可能希望在使用过程中切换模型，可以使用以下命令:
```sh theme={null}
# 修改全局模型变量
claude config set --global env '{"ANTHROPIC_MODEL": "claude-opus-4-6"}'
```
目前似乎只能设置全局的模型，无法更改项目级别的变量。可以写个脚本自动更换settings.json中的模型。
**项目配置完成**
在项目根目录下执行以下命令：
```bash theme={null}
claude
```
即可启动claude code开始使用。注意：每次修改配置后，都需要重新打开终端窗口重新输入`claude`命令。
### 3、全局配置方法：
如果不想每个项目都配置 `.claude` 目录，可以全局配置。以下为不同操作系统的全局配置方法：
#### Windows用户：
需要进入到当前用户的 `.claude` 目录下， 可以通过 cmd 进入 `C:\Users\%username%\.claude` 目录， 然后创建 `settings.json` 文件：
使用文本编辑器打开文件可以使用 vscode/记事本 编辑。
#### macos、linux用户：
linux/mac 创建 `settings.json` 配置文件 (这里可以直接使用 vi 命令)
```bash theme={null}
touch ~/.claude/settings.json
```
然后通过命令编辑配置文件，或者在用户文件夹下进入 `.claude` 文件夹，编辑 `settings.json` 文件。
```json theme={null}
vi ~/.claude/settings.json
```
编辑保存即可，这样全局配置就完成了。
更多配置可参考 [官方指南](https://docs.anthropic.com/zh-CN/docs/claude-code/overview)
## 五、最佳实践
### claude.md文件
我们可以在项目根目录或不同的目录中添加`cladue.md`文件，放入项目大纲、注意事项等。
Claude Code在运行时会优先阅读该文件，这非常有助于Claude快速理解我们的项目。
### 文件权限控制
### 上下文管理
上下文快满时 右下角有提示，通过 `/clear` 和 `/compact` 命令控制上下文。
### 高级技巧
## 六、常见问题
### 1、400错误\invalid beta flag 等处理方法
使用过程出现400错误，可以在setting.json中添加如下环境变量
```json theme={null}
{
"env": {
# 其他配置...
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS":1
}
}
```
### 2、报错长度不够的
可以在setting.json中添加如下环境变量
```json theme={null}
{
"env": {
# 其他配置...
"CLAUDE_CODE_MAX_OUTPUT_TOKENS":32000
}
}
```