diff --git a/dev-config.lua b/dev-config.lua
index d4d84dc..8dc6910 100644
--- a/dev-config.lua
+++ b/dev-config.lua
@@ -40,7 +40,7 @@ return {
   },
 
   -- Development configuration - all options shown with defaults commented out
-  ---@type ClaudeCodeConfig
+  ---@type PartialClaudeCodeConfig
   opts = {
     -- Server Configuration
     -- port_range = { min = 10000, max = 65535 }, -- WebSocket server port range
diff --git a/lua/claudecode/init.lua b/lua/claudecode/init.lua
index ac663d3..75b23c5 100644
--- a/lua/claudecode/init.lua
+++ b/lua/claudecode/init.lua
@@ -287,7 +287,7 @@ function M.send_at_mention(file_path, start_line, end_line, context)
 end
 
 ---Set up the plugin with user configuration
----@param opts ClaudeCodeConfig|nil Optional configuration table to override defaults.
+---@param opts PartialClaudeCodeConfig|nil Optional configuration table to override defaults.
 ---@return table module The plugin module
 function M.setup(opts)
   opts = opts or {}
diff --git a/lua/claudecode/types.lua b/lua/claudecode/types.lua
index 61a517c..4acaac1 100644
--- a/lua/claudecode/types.lua
+++ b/lua/claudecode/types.lua
@@ -107,6 +107,8 @@
 ---@field enable_broadcast_debouncing_in_tests? boolean
 ---@field terminal ClaudeCodeTerminalConfig?
 
+---@class (partial) PartialClaudeCodeConfig: ClaudeCodeConfig
+
 -- Server interface for main module
 ---@class ClaudeCodeServerFacade
 ---@field start fun(config: ClaudeCodeConfig, auth_token: string|nil): (success: boolean, port_or_error: number|string)