Deep Code 使用教程

Deep Code 是一个终端里的 AI 编程助手（基于 DeepSeek / OpenAI 模型）。本教程将帮助你从零开始配置并使用它。

---

1. 安装

如果你还没有安装，可以通过以下方式安装：

Windows（使用 winget）

powershell

winget install deepcode

使用 npm（如果已安装 Node.js）

powershell

npm install -g deepcode

---

2. 配置文件位置（关键步骤）

Deep Code 启动时会寻找 settings.json，不会自动读取任意位置的配置文件 。

正确的位置有以下两种（任选其一）：

类型	路径	说明
用户全局	%USERPROFILE%\.deepcode\settings.json	对所有项目生效
项目级	当前项目目录\.deepcode\settings.json	只对当前项目生效

以123为用户名为例（用户名为 123）：

方法一（推荐，全局配置）

powershell

# 创建目录（如果不存在）
New-Item -ItemType Directory -Force $HOME\.deepcode

# 用记事本打开配置文件
notepad $HOME\.deepcode\settings.json

方法二（项目级配置）

powershell

# 进入你的项目目录
cd C:\Users\123\Desktop\新建文件夹

# 创建 .deepcode 文件夹
New-Item -ItemType Directory -Force .\.deepcode

# 打开配置文件
notepad .\.deepcode\settings.json

---

3. 获取 API 密钥

你需要一个 OpenAI 兼容的 API 密钥。推荐使用 DeepSeek（便宜、中文友好）。

获取 DeepSeek API Key，这个自己到官网获取

---

4. 编写 settings.json

用记事本打开 settings.json，写入以下内容（修改 apiKey 为你的真实密钥）：

路径为：C:\Users\123\.deepcode

如果没有，新建一个。名称为：settings.json

json

{
  "env": {
    "MODEL": "deepseek-v4-pro",
    "BASE_URL": "https://api.deepseek.com",
    "API_KEY": "你的API密钥"
  },
  "thinkingEnabled": true,
  "reasoningEffort": "max"
}

注意：

• 如果使用 OpenAI 官方密钥，baseURL 改为 https://api.openai.com/v1

• 如果使用其他兼容接口（如 Azure、Groq），替换对应的 baseURL

• 保存时确保文件扩展名为 .json，不是 .txt

---

5. 启动 Deep Code

打开 PowerShell（或 CMD），进入你的项目目录：

powershell

cd C:\Users\123\Desktop\新建文件夹
deepcode

成功启动后，你会看到欢迎界面，不再报 "API key not found" 。

现在可以开始提问了。

---

6. 基本使用

输入问题

在底部的 > 提示符后直接输入文字，按 Enter 发送：

text

> 请帮我写一个 Python 函数，计算斐波那契数列的第 n 项

多行输入

按 Shift+Enter 换行，最后按 Enter 发送。

常用命令（输入 / 查看全部）

命令	作用
/new	清空当前对话，开始新会话
/model	切换模型（如 deepseek-chat）
/think	开启/关闭思考模式（DeepSeek R1 风格）
/config	查看或修改当前配置
/exit 或 Ctrl+D	退出 Deep Code

附加文件或图片

• 输入 @ 可以快速选择当前目录下的文件，将文件内容作为上下文

• 按 Ctrl+V 可以直接粘贴图片（需要模型支持视觉）

7. 常见问题与解决

错误信息	原因	解决方法
OpenAI API key not found	配置文件位置不对或内容缺失	检查 ~/.deepcode/settings.json 是否存在，且格式正确
401 Unauthorized	API 密钥无效或过期	重新生成 API Key，并检查 baseURL 是否正确
404 Not Found	模型名称错误或 baseURL 错误	确认模型名（如 deepseek-chat）和 baseURL 匹配
JSON 解析错误	settings.json 格式错误	用在线 JSON 验证器检查，注意双引号、无尾部逗号
启动后卡住	网络问题或代理设置	检查网络，如需代理设置环境变量 HTTP_PROXY

---

8. 进阶配置

settings.json 支持更多选项，完整示例：

json

{
  "openai": {
    "apiKey": "sk-xxx",
    "baseURL": "https://api.deepseek.com/v1"
  },
  "model": "deepseek-chat",
  "thinking": true,
  "reasoningEffort": "high",
  "maxTokens": 4096,
  "temperature": 0.7
}

字段	说明	默认值
model	使用的模型名称	deepseek-chat
thinking	是否启用思考链	true
reasoningEffort	思考程度（low/medium/high）	medium
maxTokens	单次响应最大 token 数	4096
temperature	随机性（0~1）	0.7

---

9. 卸载

powershell

# 如果通过 winget 安装
winget uninstall deepcode

# 如果通过 npm 安装
npm uninstall -g deepcode

# 删除配置文件（可选）
Remove-Item -Recurse $HOME\.deepcode

---

结语

现在你已经学会如何配置和使用 Deep Code 了。它是一个强大的终端 AI 编程助手，可以帮你写代码、解释逻辑、调试错误、重构项目等。随着使用深入，你会发掘更多技巧（比如管道输入、集成 Git 等）。

如果在使用中遇到其他问题，可以查看官方文档或在此对话中继续询问。祝你编码愉快！